背景
battle docs 多次强调,第一版里不要把存在版本差异或社区近似规则硬编码死,而应提取为配置层。当前 core 里这类规则仍大多写在代码里。
现状
已有:
BattleState 持有 SP 当前值与上限
BaseAction 内置 Basic/Skill/Ultimate 基础返能与击杀回能的最小规则
- 时间线 tie-break 现在隐含为 Python
min() 的遍历顺序
缺口:
- 没有独立 engine config
- SP 初始值 / 上限 / 跨波继承不可配置
- Energy 基础返能 / 受击返能模板 / FUA 分类返能不可配置
- Aggro 基础权重与覆盖关系不可配置
- timeline tie-breaker 不可配置
- wave start / carry-over 规则没有明确配置入口
目标
建立一层 battle engine configuration,把 docs 中“建议配置化”的规则从主代码路径里抽出来。
建议范围
- 对齐
docs/battle-system-mechanics/16-recommended-module-split.md
- 对齐
docs/battle-system-mechanics/17-configurable-or-needs-testing.md
- 落地
sp-rules / energy-rules / aggro-rules / tie-break / wave rules
- 让
BattleState / BaseAction / Timeline 从配置读取默认值
- 为将来版本切换或录像校准保留扩展空间
验收建议
- 至少提供默认配置与最小读取方式
- 增加一组测试证明配置改写会影响行为,而不是死常量
背景
battle docs 多次强调,第一版里不要把存在版本差异或社区近似规则硬编码死,而应提取为配置层。当前 core 里这类规则仍大多写在代码里。
现状
已有:
BattleState持有 SP 当前值与上限BaseAction内置 Basic/Skill/Ultimate 基础返能与击杀回能的最小规则min()的遍历顺序缺口:
目标
建立一层 battle engine configuration,把 docs 中“建议配置化”的规则从主代码路径里抽出来。
建议范围
docs/battle-system-mechanics/16-recommended-module-split.mddocs/battle-system-mechanics/17-configurable-or-needs-testing.mdsp-rules / energy-rules / aggro-rules / tie-break / wave rulesBattleState/BaseAction/Timeline从配置读取默认值验收建议