齿轮

齿轮（Cogwheel）

一个基于节点的可视化工厂规划器，专为 Create 及其他基于配方的模组而设计。在建造之前，将你的工厂规划为一张图表。

Cogwheel 是一款游戏内工厂设计器，其设计理念与《满意工厂》（Satisfactory）的蓝图工具一脉相承。按下单个按键，你不再需要将配方丢入百科，而是在画布上将它们连线起来——Cogwheel 会为你计算吞吐量，追踪 Create 模组的应力值，并在你的动能预算不足时发出警告。

它可作为任何包含配方的整合包的规划笔记，但与 Create 模组配合使用时尤为出色。

---

✨ 功能一览

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

---

🚀 快速入门

游戏中按 K 键（或你绑定的 打开工厂编辑器 按键）打开编辑器。

从左到右：

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

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

---

🔧 Create 集成

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

配方类型	每 RPM 的 SU	在 128 RPM（1 台机器）
粉碎轮（一对）	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 次迭代。

---

📋 需求

Minecraft	1.21.1
模组加载器	NeoForge 21.1.228+
Java	21
JEI	必需
Create	推荐 — 解锁 SU 计算、序列组装扩展和准确的 Create 配方枚举

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

---

🗺️ 路线图

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

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

如果你想请求功能或报告错误，请前往议题页面。

---

🤝 兼容性说明

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

---

👤 致谢

由 Kima 制作。基于 NeoForge + JEI + Mojang Codec 构建。应力值已与 Create 维基 交叉核对。

源码 / 议题：https://github.com/ahmet-ergul/Cogwheel