CC Synaxis Connector

Мод добавляет специальные блоки-переходники, которые выступают в роли моста между логикой CC: Tweaked и портами Synaxis, обеспечивая двусторонний обмен числовыми и булевыми значениями.

Мод CC Synaxis Connector представляет собой слой совместимости для NeoForge, позволяющий соединять компьютеры CC: Tweaked с портами CIMULink в проекте Synaxis. Это решение устраняет необходимость в написание кастомных скриптов для каждого соединения, предоставляя готовые блоки-переходники для обмена числовыми (real) и булевыми (boolean) значениями между Lua-программами и логикой растений.

Основным элементом является блок CC: Synaxis Bridge, функционирующий как небольшая плата в стиле CIMULink для создания односторонних каналов передачи сигналов. Каждый канал имеет уникальное имя, тип данных и направление (от CC к Synaxis или наоборот), а также опцию сохранения последнего значения при отсутствии входных данных. Доступ к блоку осуществляется через периферию cc_synaxis_bridge, а подключение портов выполняется стандартными инструментами прокладки проводов Synaxis.

Для работы с группами устройств предназначен блок CC: Synaxis Super Hub. Он позволяет «обернуть» рядом расположенные устройства CC или Synaxis в единый порт для противоположной стороны моста. Интерфейс платы разделен на две части: предоставление возможностей CC/Synaxis в виде портов CIMULink и экспонирование этих возможностей через периферию CC. Периферия автоматически обрабатывает методы-геттеры (например, getSpeed()) как читаемые значения, а методы-сеттеры (например, setSpeed(value)) — как вводимые данные.

Инструмент Log Output Assistant служит для записи сигналов Synaxis в CSV-файлы с помощью встроенного редактора таблиц. Плата поддерживает до 10 колонок, каждая из которых создает отдельный входной порт. Пользователь настраивает имя лога, ID строки (по тикам или номеру), режим записи (каждый тик, при изменении значения или через N тиков) и возможность импорта существующих файлов из папки безопасного вывода.

local bridge = peripheral.find("cc_synaxis_bridge")
assert(bridge, "Bridge not found")

bridge.addBridge("target_speed", "real", "cc_to_synaxis")

local value = 0
while true do
  bridge.set("target_speed", value)
  value = value + 1
  sleep(1)
end

local hub = peripheral.find("cc_synaxis_super_hub")
assert(hub, "Super Hub not found")

hub.refresh()

for name, value in pairs(hub.getAll()) do
  print(name, value)
end

Периферия Super Hub предоставляет расширенный набор методов для управления экспозицией данных. Ключевые функции включают getAll() для чтения всех доступных значений, getAllCc() и getAllSynaxis() для фильтрации по типу источника, а также expose(...) и toggleExpose(...) для динамической настройки доступных портов. Важно отметить, что создание строк экспозиции через Lua не поддерживается; конфигурация осуществляется исключительно через графический интерфейс платы.

Существуют важные ограничения при использовании модуля. Порты, ориентированные на Synaxis, в настоящее время поддерживают только типы данных real и boolean. Текстовые или строковые значения не экспонируются как порты, если Synaxis не предоставляет совместимый тип сигнала. Кроме того, не все методы периферий CC могут безопасно вызываться без аргументов, поэтому Super Hub фокусируется на простых методах-геттерах и -сеттерах. Поскольку CC и Synaxis могут обновляться с разной частотой, блоки-коннекторы кэшируют значения, позволяя каждой стороне читать данные в своем собственном темпе.

Мод требует обязательной установки вместе с CC: Tweaked, Synaxis и всеми зависимостями последнего. Он не является автономным решением и не включает в себя сами моды-зависимости, такие как Sable, Create или Flywheel. Для корректной работы необходимо использовать версии Minecraft 1.21.1 и загрузчик NeoForge, совместимые с указанными зависимостями. Разработчик разрешает включение CC Synaxis Connector в сборки модов, при условии соблюдения лицензий всех требуемых зависимостей.