CC Synaxis Connector

CC Synaxis Connector

CC Synaxis Connector 是一款 NeoForge 兼容性模组，可将
CC: Tweaked电脑连接到 Synaxis Cimulink 工厂端口。

它添加了桥接式电路板，让 Lua 程序、Synaxis 电路和
CSV 日志工作流能够交换数值，无需为每个连接的两端分别编写自定义脚本。

亮点

• 连接 CC: Tweaked 外设和 Synaxis Cimulink 端口。
• 公开命名的单向实数/布尔桥接信号。
• 使用 Super Hub 电路板封装相邻的 CC 外设和 Synaxis 工厂数值。
• 通过单个外设，在 CC Lua 中读取选定的 Synaxis 数值。
• 将 CC 中类似 getter/setter 的外设方法写入 Synaxis 端口。
• 使用游戏内表格编辑器将 Synaxis 信号记录到 CSV 文件。
• 支持英文和简体中文界面文本。

要求

此模组不能独立运行。请与 CC: Tweaked、Synaxis 以及
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+

生成的 jar 不包含 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

Super Hub 是一块电路板，可将附近的设备封装为端口，供桥接器另一端使用。

它有两个界面页面：

• 提供给 Synaxis：选择要封装的 CC 或 Synaxis 功能，并将其公开为 Synaxis Cimulink 端口。
• 提供给 CC：选择要封装的 CC 或 Synaxis 功能，并通过 Super Hub CC 外设公开。

对于 CC 外设，类似 getter 的方法，例如 getSpeed()、isRunning() 或
hasFuel()，会被视为可读取的数值。类似 setter 的方法，例如
setSpeed(value)，则会在可能的情况下成为可写入的输入。

对于 Synaxis，集线器会通过 Synaxis 总线/工厂端口风格的访问方式读取可用的工厂数值，
并将兼容的数值提供给 CC 或 Synaxis 端口。

日志输出助手

日志输出助手是一种 Synaxis 输入电路板，可将信号数值写入 CSV。

最多支持 10 列。每列会创建一个 Synaxis 输入端口，并可配置为 real 或 boolean。除非跳过空行，
否则从未激活过的空输入会写为 null。

主要选项：

• 日志名称 / 输出文件
• 行 ID：游戏刻、行号或无
• 写入模式：每游戏刻、数值变化时或每 N 个游戏刻
• 创建模式：立即、任意输入触发或由一个指定输入触发
• 跳过或写入完全空白的行
• 从安全输出文件夹导入现有 CSV 文件

CSV 文件会写入当前存档目录下的：

ccsconnector_outputs/

在服务器上，文件选择范围被有意限制为此输出文件夹。
客户端导入流程也只会扫描客户端自身的 ccsconnector_outputs
文件夹，并将选中的 CSV 内容上传到服务器。

基本用法

1. 放置一个连接器板。
2. 空手右键点击连接器板，打开其界面。
3. 配置所需的桥接器、集线器或日志列。
4. 使用 Synaxis 布线工具连接可见端口。
5. 需要使用 CC 时，在方块旁边连接或放置一台 CC 电脑。
6. 使用 Lua 外设调用读取或写入已配置的值。

CC Lua API

桥接器外设

外设类型：

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

超级集线器外设

外设类型：

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 提供兼容的信号类型，否则文本/字符串值不会作为 Synaxis 端口公开。
• 并非所有 CC 外设方法都能在不提供参数的情况下安全调用。超级集线器主要支持简单的 getter/setter 风格方法。
• CC 和 Synaxis 的更新速率可能不同。连接器方块会缓存值，使两端都能按各自的时序读取。
• 使用常规 Synaxis 工具配置 Synaxis 接线。空手右键点击可打开连接器界面。

整合包许可

你可以在整合包中加入 CC Synaxis Connector，但必须按照其各自的许可证
和许可要求获取并分发所有必需的依赖项。

许可证

本仓库仅针对本项目原创的兼容层代码和资源采用 MIT 许可证。请参阅 LICENSE。

CC: Tweaked、Synaxis、Sable、LDLib、Create、Flywheel、NeoForge、Minecraft 及
相关名称、API、商标、源代码、二进制文件、模型、材质和文档均属于各自所有者，
并继续遵循其上游许可条款。

CC Synaxis Connector 是一个独立制作、借助 AI 开发的兼容性模组。
它与 CC: Tweaked、Synaxis、Sable、LDLib、Create、NeoForge、Minecraft 或
Mojang/Microsoft 的作者及相关方无关联，也未获得其认可或赞助。

请参阅 THIRD_PARTY_NOTICES.md，了解依赖项和
权利持有人说明。

开发说明

大多数依赖项由 Gradle 从 Maven 解析。本地 libs/ 目录
仅用于存放本项目目前无法从公共 Maven 仓库解析的依赖项：

• synaxis-1.3.4.jar
• sable-schematic-api-0.2.6.jar

libs/*.jar 已被 Git 忽略，因此不应提交依赖 JAR 文件。

针对 CC:T 通用外设的兼容性回退逻辑隔离在
CcTweakedInternals 中，以便于审查或移除非公开的 CC:T 访问代码，
以防上游 API 发生变化。

Synaxis 的植物访问通过已注册的 PlantEndpointProvider 端口和
PlantPortProviders.tryCreate 实现。