配方平衡器

配方平衡器

客户端生产线平衡工具:输入配方和目标速率,通过线性规划求解稳态速率、机器数量和副产品。支持循环回路。

RecipeBalancer —— 产线稳态配平工具

RecipeBalancer 是面向模组化 Minecraft 产线的客户端规划工具。按 K 打开图形界面。给定一组配方与一组目标产出速率,它给出每条配方应有的运行速率、各环节所需的机器数量、必须由产线外部供给的物料,以及产生的副产物。模组不新增物品、方块或机器,仅承担分析功能,全部运算在客户端完成。

方法

产线是一组联立的物料约束系统:某一工序的副产物是另一工序的输入,某一步可能消耗自身产出,目标速率决定全部上游工序的规模。逐次代入可求解无环链条,一旦链条成环则失效。

因此将产线表述为约束优化问题:每条配方一个变量,表示其运行速率;每种物料一条平衡约束,即产出加输入等于消耗加目标与副产物输出之和。声明为原料的物料可无限输入,其余须由产线自产。目标函数为按工序时长加权的机器并行总量,或配方活动总量。

系统整体求解,循环结构无需特殊处理:

  • 回流量小于消耗量的循环判为亏损,并报告其所需的外部供给;
  • 物料守恒的循环没有稳态起点,工具计算其最小启动投料;
  • 最优解不唯一时只报告其中一个;机器数量在最优解集内不变。

录入

配方以原料、产物、时长、设备四项在游戏内界面录入。物料可从背包选取,装有 JEI 时亦可自其物品列表拖入或从配方页导入。时长与设备种类始终由用户填写——二者均无法从配方可靠还原。目标以单位时间产量给出。

未完成的工作自动保存至 config/recipebalancer/scenarios/autosave.json,下次启动恢复。

输出

结果以报告(各配方速率与机器数、外部输入、副产物)与按依赖关系排序的流程图呈现;节点颜色表示其在产线中的角色,连线宽度表示物料流量。流程图支持平移、缩放与节点拖动;布局以边交叉与节点重叠最少为目标。

已知限制

  • 仅适用稳态,不涉及缓冲、预热与瞬态行为。
  • 不读取其它模组的配方库。JEI 是唯一的自动录入通道,且只提供物料,不提供时长。
  • 不解析物料名称,只使用配方结构。
  • 计算耗时随配方数量增长。

安装

  • 仅客户端:无服务端组件、无网络通信、不修改世界状态。
  • 将 jar 放入 mods 即可,无需初始配置。

兼容

装有 JEI 时可加速配方录入:从物品列表拖 ghost、从配方页导入,以及流体或化学品等非物品按桶计(500 mB = 0.5)。界面提供中文与英文。各构建对应的加载器与 Minecraft 版本见 Files 栏目。

范围与披露

模组不修改任何游戏状态,不进行任何网络通信;全部运算在本地完成。相当一部分代码由 AI 生成。