Files
magic-factorio/tools/recipe-tree-editor

配方树工作台

这是给策划直接使用的本地数据工具。它编辑的不是一份演示副本,而是项目中的权威配方书:data/recipe-book.json

打开

在 Windows 资源管理器中双击 start-editor.cmd。启动器会在本机打开浏览器页面,保存服务只监听 127.0.0.1,不会对局域网或互联网开放。

如果浏览器没有自动打开,也可以在本目录运行:

node server.mjs

随后访问 http://127.0.0.1:8765/tools/recipe-tree-editor/

日常使用

  1. 从左侧切换配方、物品或设施,并用阶段、生态区和搜索缩小范围。
  2. 中央默认显示选中条目的上下游;“全局”模式用于检查整条阶段结构。
  3. 在右侧修改数值。所有修改会立即反映到图谱和校验结果,并自动保留一份浏览器草稿。
  4. 先处理顶部的错误,再点“保存数据”。直接保存会写回 data/recipe-book.json,并在 data/backups/ 生成时间戳备份。
  5. Ctrl+Z / Ctrl+Y 撤销和重做,Ctrl+S 保存,/ 聚焦搜索。

魔法配方字段

  • 输入方式“消耗”:每批永久扣除。
  • “催化”:参与仪式但不扣除,例如锚核和边界石。
  • “流体”:来自魔力或物质管网的批次输入。
  • “状态”:要求物品携带某种法则状态。
  • min / max:随机数量的安全上下界,amount 是策划估算用期望值。
  • weight:传送门结果袋权重,同一配方的权重总和必须为 100。
  • chance:独立概率;当所有产出都是概率项时,总和必须为 1。
  • entropy:每批给仪式网络或传送门增加的熵压力。

保存安全

  • 有结构错误时,界面和服务端都会拒绝写入。
  • 修改 ID 会自动更新配方引用;仍被引用的物品或设施不能直接删除。
  • 浏览器草稿不是项目文件,顶部会一直显示“未保存”,直到直接保存成功。
  • 本地服务不可用时,“保存数据”会退化为下载 JSON;此时需要手动替换项目数据文件。

校验

node tests.mjs

测试覆盖引用完整性、科技 ID、结果袋权重、依赖图构建和首次折跃关键上游。当前 Godot 原型尚未消费这份数据;等内容运行时建立后,应直接读取这份 JSON 或由它生成 Godot Resource,避免维护第二套数值。