WC4 BTL Reference

外观

BTL v3+ ExtensionArea 索引 ​

v3+ BTL 可以在固定 section 后携带由 Header H54 指定字节长度的 protobuf ExtensionArea。

当前已经通过原版 Game.proto descriptor 和实际 wire 数据确认的主要顶层结构包括：

proto
message BattleExArgs {
    repeated SSecondaryConditionArgs secondaryConditions = 2;
    repeated BattleArmyExArgs armyExs = 4;
}

已确认的 BattleArmyExArgs descriptor 字段包括：

proto
int32 area = 1;
repeated SArmyBuffArgs armyBuffs = 2;
int32 bynameId = 3;
int32 tunnelFromArea = 4;
int32 steelWillValue = 5;
repeated SArmyStatArgs armyStats = 6;
int32 legendArmyId = 7;

注意：descriptor 字段名和 wire schema 已知，不等于每个字段的完整玩法 consumer 已知。

当前 corpus ​

  • 非空 ExtensionArea 文件：407；
  • secondaryConditions：796 条；
  • armyExs：8425 条；
  • armyEx.area 与固定 Unit area：8372 条唯一匹配、53 条多匹配、0 条 unmatched；
  • armyBuffs / armyStats 在当前原版 disk-tail corpus 中没有正实例。

正式专章 ​

text
battle_ex_args.md       BattleExArgs 顶层 schema、loader consumer 与 corpus
secondary_condition.md  SSecondaryConditionArgs 与 Legend 次要目标
army_ex.md              BattleArmyExArgs 七字段、area 引用与 Legend/显示身份

当前边界 ​

以下内容仍需逐字段闭合：

  • 每个字段的完整 native consumer；
  • bynameId 最终 UI-facing setter 链；
  • legendArmyId 完整 membership/coordination 链；
  • secondary condition 最终结果/皇冠/奖励合成；
  • 无效引用和重复字段的异常边界；
  • protobuf unknown fields、merge 和 serializer 精确兼容行为。

主要证据：

text
reports/btl_v3_tail_legend_recovery.md
reconstruction/docs/btl_editor_round39_extension_descriptor_complete_schema_recovery_report.md
reconstruction/docs/btl_editor_round40_extension_native_consumer_coverage_recovery_report.md
reconstruction/docs/btl_editor_round41_extension_reference_integrity_evidence_recovery_report.md