配置参考总览

FKEscape 将配置分成节点拓扑、跨局权益、商店交付和局内玩法。配置重载采用“全部预解析、全部验证、最后一次提交”：任何一个文件失败，整批旧配置继续运行，不会只更新一半。

文件与生效边界

文件	控制内容	游戏服进行中执行 /fkescape reload
settings.yml	角色、节点、数据库、阶段时间、NPC	拓扑字段变更直接拒绝；其余立即提交
backpack.yml	入场背包档位与价格	立即提交，后续购买/准入读取新值
safebox.yml	保险箱权限与容量	立即提交
kits.yml	装备券售价、权限、发放命令	立即提交
shop.yml	商店分类、槽位、医疗/增益交付	立即提交
buffs.yml	药水增益集合	立即提交，可影响当前局后续使用
zones.yml	资源区、危险度、Boss	暂存到下一局
loot.yml	战利品池、容器位置	暂存到下一局
injuries.yml	伤势与医疗	立即提交，可影响当前局
extraction.yml	撤离区域与条件	立即提交，可影响当前局
custom-model-data.yml	网格形态与模型映射	暂存到下一局
lang/zh_CN.yml	中文消息	随语言系统重载读取；按实服触发验证

“下一局”只适用于 GAME 节点且 GameManager.state != NONE 时的 zones、loot、CustomModelData。其他玩法配置没有同样的延迟保护；在生产服修改伤势或撤离规则前，应先结束当前局。

推荐修改流程

1. 备份插件配置目录和数据库。
2. 只改一个逻辑主题，同时核对跨文件引用：背包和装备券对应商店；zone 对应 loot；buff 对应 loot；世界名对应所有坐标。
3. 在测试节点执行 /fkescape reload。失败时不要反复覆盖文件，先按控制台首个异常路径修正。
4. 新开一局完成入场、购买、选装、搜刮、受伤、治疗、撤离全链路。
5. 对扣款和发货专门做重复点击、断线、并发测试；结果不确定时保留数据库记录人工核对，不做自动退款或重复交付。

严格与宽松解析的区别

backpack.yml、safebox.yml、kits.yml、shop.yml、extraction.yml、custom-model-data.yml 有大量“字段必须恰好匹配”的校验，旧字段或自创字段会失败。injuries.yml 的部分数值会被夹到安全范围。每一页都按当前代码标出了具体差异，不要把某个文件的容错行为推断到其他文件。