CC Synaxis Connector

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

Основные возможности

• Подключает периферию CC: Tweaked к портам Synaxis Cimulink.
• Создает именованные однонаправленные мосты с сигналами real (числа) и boolean (истина/ложь).
• Блок Super Hub оборачивает соседние CC-периферию и Synaxis-устройства в порты для другой стороны.
• Читает выбранные значения Synaxis из Lua через один периферийный интерфейс.
• Записывает значения из CC-периферии (по типу getter/setter) в порты Synaxis.
• Логирует сигналы Synaxis в CSV-файлы с помощью встроенного редактора таблиц.
• Поддерживает английский и упрощенный китайский интерфейс.

Требования

Мод не является самостоятельным. Установите его вместе с CC: Tweaked, Synaxis и их зависимостями. Проверенная связка:

• Minecraft 1.21.1
• NeoForge 21.1.226+
• CC: Tweaked 1.118.0+
• Synaxis 1.3.4+
• Sable 1.1.3+
• Sable Schematic API 0.2.6+
• LDLib2 2.2.17+
• Create 6.0.10+
• Flywheel 1.0.6+

Мод не включает в себя CC: Tweaked, Synaxis, Sable, Create и их ассеты. Их нужно скачать отдельно с официальных источников.

Блоки

CC: Synaxis Bridge (Мост)

Небольшая плата Cimulink для ручного создания однонаправленных каналов. У каждого канала есть:

• уникальное имя (например bridge_1)
• тип: real или boolean
• направление: cc_to_synaxis или synaxis_to_cc
• опция "сохранять последнее значение" для случаев, когда сигнал от Synaxis пропадает

В интерфейсе блока создаются и удаляются каналы. Инструменты Synaxis подключаются к сгенерированным портам. CC-компьютер видит блок как периферию cc_synaxis_bridge.

CC: Synaxis Super Hub (Супер-хаб)

Более продвинутая плата, которая оборачивает близлежащие устройства в порты для другой стороны моста. У него две страницы интерфейса:

• Providing to Synaxis - выберите, какие возможности CC или Synaxis открыть как порты Synaxis.
• Providing to CC - то же самое, но для CC-периферии.

Для CC-периферии методы-геттеры (например getSpeed(), isRunning(), hasFuel()) становятся читаемыми значениями, а сеттеры (setSpeed(value)) - записываемыми входами. Для Synaxis хаб читает доступные значения растений через порты и подставляет их в CC или наоборот.

Log Output Assistant (Логгер CSV)

Плата Synaxis, которая записывает сигналы в CSV-файл. Поддерживает до 10 колонок, каждая колонка - один порт Synaxis типа real или boolean. Пустые (неактивированные) входы пишутся как null, если не включено пропускание пустых строк.

Основные опции:

• имя лога / выходной файл
• идентификатор строки: тик, номер строки или ничего
• режим записи: каждый тик, при изменении значения, каждые N тиков
• режим создания: сразу, при любом входе, при выбранном входе
• пропускать или записывать пустые строки
• импорт существующих CSV из папки ccsconnector_outputs/ внутри сохранения

На сервере выбор файлов ограничен этой папкой. Клиент сканирует свою собственную папку и загружает содержимое выбранного CSV на сервер.

Базовое использование

1. Поставьте один из блоков-коннекторов.
2. Кликните по нему пустой рукой, чтобы открыть интерфейс.
3. Настройте мост, хаб или колонки лога.
4. Используйте инструменты Synaxis для подключения видимых портов.
5. Рядом с блоком поставьте CC-компьютер, если нужен доступ из Lua.
6. Читайте и записывайте значения через Lua-периферию.

Lua API

Bridge (Мост)

Тип периферии: cc_synaxis_bridge

Методы:

list()
schema()
info(name)
addBridge([name], type, direction)
removeBridge(name)
get(name)
set(name, value)
lastWriteTick(name)
getSaveLastValue(name)
setSaveLastValue(name, enabled)
toggleSaveLastValue(name)

Пример:

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

Super Hub (Супер-хаб)

Тип периферии: cc_synaxis_super_hub

Методы:

list()
schema()
get(name)
getAll()
refresh()
lastUpdateTick(name)

listSynaxis()
getSynaxis(name)
getAllSynaxis()
synaxisLastUpdateTick(name)

listCcCandidates()
listExposedCc()
getCc(name)
getAllCc()

expose(...)
toggleExpose(...)
set(name, value)
write(name, value)
listProvidedToSynaxis()

Настройка экспозиции делается в интерфейсе хаба. Lua может читать настроенные значения и писать в записываемые поля, но не создает строки экспозиции. Методы expose и toggleExpose зарезервированы для совместимости и перенаправляют в интерфейс.

Пример:

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

Важно знать

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

Разрешение на использование в сборках

Мод CC Synaxis Connector можно включать в сборки модов. Все необходимые зависимости распространяются по своим лицензиям. Исходный код мода (только слой совместимости) распространяется под MIT License.

---

Скачайте мод CC Synaxis Connector для Minecraft 1.21.1 на NeoForge и настройте бесшовное взаимодействие между CC:Tweaked и Synaxis. Это избавит вас от лишних скриптов и откроет новые возможности для автоматизации в Майнкрафт.