配方树工作台
这是给策划直接使用的本地数据工具。它编辑的不是一份演示副本,而是项目中的权威配方书: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/。
日常使用
- 从左侧切换配方、物品或设施,并用阶段、生态区和搜索缩小范围。
- 中央默认显示选中条目的上下游;“全局”模式用于检查整条阶段结构。
- 在右侧修改数值。所有修改会立即反映到图谱和校验结果,并自动保留一份浏览器草稿。
- 先处理顶部的错误,再点“保存数据”。直接保存会写回
data/recipe-book.json,并在data/backups/生成时间戳备份。 Ctrl+Z/Ctrl+Y撤销和重做,Ctrl+S保存,/聚焦搜索。
魔法配方字段
- 输入方式“消耗”:每批永久扣除。
- “催化”:参与仪式但不扣除,例如锚核和边界石。
- “流体”:来自魔力或物质管网的批次输入。
- “状态”:要求物品携带某种法则状态。
min/max:随机数量的安全上下界,amount是策划估算用期望值。weight:传送门结果袋权重,同一配方的权重总和必须为 100。chance:独立概率;当所有产出都是概率项时,总和必须为 1。entropy:每批给仪式网络或传送门增加的熵压力。
保存安全
- 有结构错误时,界面和服务端都会拒绝写入。
- 修改 ID 会自动更新配方引用;仍被引用的物品或设施不能直接删除。
- 浏览器草稿不是项目文件,顶部会一直显示“未保存”,直到直接保存成功。
- 本地服务不可用时,“保存数据”会退化为下载 JSON;此时需要手动替换项目数据文件。
校验
node tests.mjs
测试覆盖引用完整性、科技 ID、结果袋权重、依赖图构建和首次折跃关键上游。当前 Godot 原型尚未消费这份数据;等内容运行时建立后,应直接读取这份 JSON 或由它生成 Godot Resource,避免维护第二套数值。