SPT现实主义数值范围编辑生成器 v2.0 规则说明
字数
728 字
阅读时间
3 分钟
本文档说明当前 RealismItemRules 目录下各类规则文件的职责，以及 GUI 中看到的分类与实际 JSON 结构的对应关系。
1. 规则文件清单
当前主规则文件位于 RealismItemRules：
- RealismItemRules/weapon_rules.json
- RealismItemRules/attachment_rules.json
- RealismItemRules/ammo_rules.json
- RealismItemRules/gear_rules.json
- RealismItemRules/item_exceptions.json
其中前四个文件定义范围规则，item_exceptions.json 定义具体物品的最终字段覆盖。
2. 范围节点结构
大多数可编辑规则节点都由以下结构构成：
json
{
"min": 0.0,
"max": 0.0,
"preferInt": false
}字段含义：
- min：生成时的下界
- max：生成时的上界
- preferInt：该字段是否优先按整数处理
3. 四大类规则
3.1 武器
weapon_rules.json 主要包含：
- 武器全局夹紧
- 武器基础规则
- 武器口径修正
- 武器枪托修正
当前霰弹枪口径修正已拆分为 12g、20g、23x75 三档，用于区分不同霰弹体系的整枪后坐与散布特征。
3.2 附件
attachment_rules.json 主要包含：
- 附件全局夹紧
- 附件 profile 范围
3.3 弹药
ammo_rules.json 主要包含：
- 口径基础范围
- 特殊弹种修正
- 穿深档位修正
当前霰弹基础 profile 已拆分为 12g、20g、23x75 三类，再通过 shot_shell_payload 叠加 buckshot、flechette、slug 等载荷差异。
3.4 装备
gear_rules.json 主要包含：
- 装备全局夹紧
- 装备 profile 范围
- 装备 profile 价格范围
4. GUI 如何映射这些规则
GUI 不直接暴露原始 JSON，而是把规则展开为：
- 大类
- 分类
- profile
- 字段范围
这样做的目的，是让日常调参集中在范围和值本身，而不是把整份规则文件当作原始 JSON 文本编辑器来使用。
5. 例外物品与规则的关系
item_exceptions.json 不替代四大类规则，而是在生成的最后阶段对具体 ItemID 做补丁覆盖。
它适合处理：
- 模板字段结构特殊
- 某个物品需要保留超出常规范围的字段
- 某些装备类条目需要保留诸如 IsGasMask、MaskToUse、GasProtection 之类的特定字段
6. 调整建议
- 先改范围规则，再看是否真的需要用例外物品兜底
- 每次只改少量字段，方便回看生成结果和审计结果
- 如果结果出现极端值，先检查对应分类的 clamp 规则
- 例外物品优先以 output 中真实生成出的对象为基线编辑
7. 当前不做的事
- GUI 不直接修改 input 模板源文件
- GUI 不替代 output 回归验证
- item_exceptions 不应滥用为“整类规则替代品”
贡献者
SamuelNOTCuriousMeow