齿轮

Cogwheel

一个基于节点的可视化工厂规划工具，适用于 Create 及其他配方驱动的模组。在建造之前，先将你的工厂规划成一张图表。

Cogwheel 是一款游戏内的工厂设计器，其设计理念与 Satisfactory 的蓝图工具一脉相承。按下单个按键，无需在 Wiki 中翻查配方，即可在画布上将它们连接起来——Cogwheel 会为你计算产量、追踪 Create 的应力值，并在你的动能预算不足时发出警告。

它可作为任何带有配方的整合包的规划笔记，但在 Create 旁边使用时效果尤为出色。

---

✨ 功能一览

• 🎛️ 可视化图表编辑器 — 将配方拖拽到画布上，将输出连接到输入，在放置任何一个方块之前，亲眼看着你的工厂成形。
• ⚡ Create 应力计算 — 每一个基于 Create 的配方都能知晓其在任意转速下的 SU 消耗。混合器转速为 128 RPM？那就是 512 SU。数值自动出现。
• 🔋 跨工厂动力源 — 一次性定义好你的蒸汽机、风车或飞轮，将工厂分配给它，当预算超支时立刻收到警告。
• 🌀 序列组装自动展开 — 拖入一个精密机构配方，Cogwheel 会将其展开为一个包含所有五个步骤、循环控制以及正确 SU 总和的锁定集群。
• 🔁 循环节点 — 使用循环节点来控制一条链，使其按设定次数运行包含的配方。通过紫色的底部端口进行连接。
• 📚 每个存档支持多个工厂 — 每个工厂在 cogwheel/factories/ 目录下对应一个独立的 JSON 文件，可通过左侧面板切换，便于分享。
• 🔗 跨工厂连接 — 从工厂 A 导出物品，并通过引用将其作为工厂 B 的输入源。
• 🧩 集群 — 将任何选中部分编组为子图表（用户集群），或者从序列配方中获得自动构建的集群（锁定）。可原地编辑集群。
• 🎨 完全可主题化 — 所有颜色、文本比例、面板大小都可以在分页的设置页面中进行配置。
• 🔍 JEI 集成 — 配方选择器会渲染 JEI 自身的类别。右键点击任何选择器行，即可直接跳转到 JEI 的完整配方视图。

---

🚀 快速入门

在游戏中按 K 键（或你为 打开工厂编辑器 绑定的任何按键）即可打开编辑器。

从左到右：

1. 类别面板（左侧）：可浏览配方、来源、去处、输出、逻辑、工厂、动力源、设置。
2. 画布：使用鼠标中键平移，使用滚轮缩放，将物品拖放到此处以添加节点。
3. 属性面板（右侧）：右键点击任意节点 → 编辑，或直接双击。可配置并行数、转速、配方变体、端口配对。
4. 求解器覆盖层（底部）：实时显示你的工厂需要什么、产出什么、浪费什么——以及相对于所分配动力源的转速和 SU 消耗。

添加节点： _拖拽__左侧面板中的物品或逻辑块到画布上。物品会落在你放置的位置。

---

🔧 Create 集成

Cogwheel 直接读取 Create 的应力影响表和配方类型。每个 Create 配方都会被识别，并计算其在配置转速下的 SU 消耗：

配方类型	每 RPM 的 SU	128 RPM 时（单台机器）
粉碎轮（一对）	8	1,024 SU
机械压片机	8	1,024 SU
机械混合器	4	512 SU
磨盘	4	512 SU
机械锯	4	512 SU
部署器	4	512 SU
流体喷口 / 物品抽取口	4	512 SU
密闭风扇（洗涤/闹鬼）	2	256 SU

每个工厂和每个配方的转速

每个工厂都有一个默认转速（1–256）。每个 Create 配方节点和每个集群都可以在属性面板中通过复选框选择继承该转速或覆盖为自定义值。

序列组装集群

拖入一个精密机构、铁轨或黄铜机壳配方，Cogwheel 会为你构建一个完整的锁定集群——每个步骤按顺序排列，正确的物品流入其中，并显示一个指示迭代次数的循环节点。

---

⚡ 动力源

动力源存在于任何单个工厂之外。在（左侧面板的）动力类别中一次性创建它们，并指定名称和 SU 容量：

• 蒸汽机 — 16,384 SU
• 大型风车阵列 — 4,096 SU

然后，通过工厂页面上的 ⚡ 按钮将每个工厂分配到某个动力源。Cogwheel 会汇总指向同一动力源的所有工厂的 SU 消耗，并显示：

• 🟢 绿色：在预算内，尚有充裕空间
• 🟠 橙色：接近容量上限
• 🔴 红色 ⚠：超出预算——并明确超出多少

---

🎨 设置

设置页面包含三个标签页：

• 颜色 — 所有节点主体、边框、端口圆点、连线、画布背景。点击色块，从 HSV 选择器中挑选颜色，即可完成。
• 文本 — 文本颜色以及两个缩放旋钮（节点文本缩放、侧面板文本缩放）。
• Cogwheel — 行为开关。可从选择器中隐藏原版配方，这样你的模组工厂就不会被大量的压实配方淹没。Ponder 集成已在路线图中。

---

📦 逻辑节点

除了配方、来源和去处之外，逻辑类别还包括：

• 分流器 — 1 个输入，2–8 个输出。可配置分配模式。
• 合并器 — 2–8 个输入，1 个输出。
• 限流器 — 限制单条线路的流速。
• 虚空 — 丢弃物品（适用于故意模拟浪费的场景）。
• 集群 — 空的用户创建的子图表，用于分组。
• 循环 — 控制一条链在每个周期内运行 N 次迭代。

---

📋 需求

我的世界	1.21.1
模组加载器	NeoForge 21.1.228+
Java	21
JEI	必需
Create	推荐 — 解锁 SU 计算、序列组装扩展以及精确的 Create 配方枚举

该模组仅客户端——无需在服务器端安装。

---

🗺️ 路线图

我计划但尚未发布的功能：

• 🎬 Ponder 集成 — 为你的工厂自动构建示例装置。
• ⚡ 瓶颈感知求解器（真正的背压建模）。
• 🪶 分流器和合并器的按输出权重 / 固定速率。
• 🔗 更好的 Create 附加包覆盖（CC&A、Create: New Age 等）。

如果你想提出功能请求或报告 Bug，请前往问题页面。

---

🤝 兼容性说明

• 专为重度使用 Create 及其附加包的整合包设计，但也能很好地用作原版规划工具。
• 配方枚举通过 JEI 进行，因此任何提供 JEI 类别的模组，其配方都可被拾取。
• Cogwheel 不会改变任何游戏内行为——它只是一个规划界面。你的工厂仍然需要手工建造。（目前如此。）

---

👤 鸣谢

由 Kima 制作。基于 NeoForge + JEI + Mojang Codec 构建。应力值已对照 Create Wiki 进行核对。

源码 / 问题：Github