完善客户端功能并同步差距文档

formats/combo_table.h

@@ -0,0 +1,92 @@
+// combo_table —— PC 连击段表（CRaceData::TComboAttackDataMap 的等价）。M2 §3.5。
+//
+// 参考端的 PC 连击段表**不在** .msm 里（.msm 只有 BaseModelFileName + HairData）。
+// 它由 playersettingmodule.py 的 chrmgr.ReserveComboAttackNew / RegisterComboAttackNew
+// 调用在 CRaceData 上建起来（UserInterface/PythonCharacterManagerModule.cpp →
+// CRaceData::ReserveComboAttack / RegisterComboAttack，GameLib/RaceData.cpp）。
+// 本解析器就把那批调用读成同一张表。
+//
+// NPC/怪物的连击段走另一条路（RaceManager.cpp __LoadRaceMotionList 读 motlist.txt，
+// 只在 MODE_GENERAL 下登记 NAME_COMBO_ATTACK_1/2/3，没有段号向量），不在这里。
+#pragma once
+#include <cstdint>
+#include <map>
+#include <string>
+#include <vector>
+
+namespace fmt {
+
+// CRaceMotionData::EMode（chr.MOTION_MODE_*）。combo key 的高 16 位。
+enum ComboMotionMode : uint16_t {
+    COMBO_MODE_RESERVED             = 0,
+    COMBO_MODE_GENERAL             = 1,
+    COMBO_MODE_ONEHAND_SWORD        = 2,
+    COMBO_MODE_TWOHAND_SWORD        = 3,
+    COMBO_MODE_DUALHAND_SWORD       = 4,
+    COMBO_MODE_BOW                  = 5,
+    COMBO_MODE_FAN                  = 6,
+    COMBO_MODE_BELL                 = 7,
+    COMBO_MODE_FISHING             = 8,
+    COMBO_MODE_HORSE               = 9,
+    COMBO_MODE_HORSE_ONEHAND_SWORD  = 10,
+    COMBO_MODE_HORSE_TWOHAND_SWORD  = 11,
+    COMBO_MODE_HORSE_DUALHAND_SWORD = 12,
+    COMBO_MODE_HORSE_BOW           = 13,
+    COMBO_MODE_HORSE_FAN           = 14,
+    COMBO_MODE_HORSE_BELL          = 15,
+    COMBO_MODE_WEDDING_DRESS        = 16,
+};
+
+// CRaceMotionData::EName 的攻击段（chr.MOTION_NORMAL_ATTACK / chr.MOTION_COMBO_ATTACK_*）。
+// ComboIndexVector 里存的就是这些段号。
+enum : uint16_t {
+    COMBO_NAME_NORMAL_ATTACK  = 13,
+    COMBO_NAME_COMBO_ATTACK_1 = 14,
+    COMBO_NAME_COMBO_ATTACK_8 = 21,
+};
+
+// RaceData.h: MAKE_COMBO_KEY(motion_mode, combo_type)
+inline uint32_t make_combo_key(uint16_t motion_mode, uint16_t combo_type) {
+    return (static_cast<uint32_t>(motion_mode) << 16) | static_cast<uint32_t>(combo_type);
+}
+inline uint16_t combo_key_mode(uint32_t key) { return static_cast<uint16_t>((key >> 16) & 0xFFFF); }
+inline uint16_t combo_key_type(uint32_t key) { return static_cast<uint16_t>(key & 0xFFFF); }
+
+// playersettingmodule.py 按 __LoadGame<Class>Ex(race, path) 分四块，男女同一函数体
+// （连击段表与性别无关），所以这里按职业收，不按 race。
+enum ComboClass : int {
+    COMBO_CLASS_WARRIOR  = 0,
+    COMBO_CLASS_ASSASSIN = 1,
+    COMBO_CLASS_SURA     = 2,
+    COMBO_CLASS_SHAMAN   = 3,
+    COMBO_CLASS_COUNT    = 4,
+};
+
+// CRaceData::TComboAttackDataMap 的等价：MAKE_COMBO_KEY -> ComboIndexVector。
+struct ComboTable {
+    // key = make_combo_key(mode, type)；value = 有序的 COMBO_NAME_COMBO_ATTACK_* 段号，
+    // 下标即 dwComboArrayIndex（m_dwcurComboIndex - 1）。
+    std::map<uint32_t, std::vector<uint16_t>> combos;
+
+    // GetComboDataPointer：命中返回段号向量指针，否则 nullptr。
+    const std::vector<uint16_t>* get(uint16_t motion_mode, uint16_t combo_type) const;
+    bool empty() const { return combos.empty(); }
+    size_t key_count() const { return combos.size(); }
+};
+
+struct PlayerComboTables {
+    ComboTable per_class[COMBO_CLASS_COUNT];
+    // 越界返回一张空表（不抛）。
+    const ComboTable& klass(int combo_class) const;
+};
+
+// 解析 playersettingmodule.py 里的 chrmgr.ReserveComboAttackNew / RegisterComboAttackNew
+// 调用，按 def __LoadGame<Class>Ex 分块填 per_class。照 CRaceData 语义：
+//   Reserve  -> combos[key] = vector(count, 0)（重复 key 不覆盖，同 std::map::insert）
+//   Register -> combos[key][index] = motion（key 未 Reserve 或 index 越界则跳过）
+// 认得的符号：chr.MOTION_MODE_*、chr.MOTION_COMBO_ATTACK_N（=13+N）、
+// chr.MOTION_NORMAL_ATTACK（=13）、COMBO_TYPE_N（=N-1）、COMBO_INDEX_N（=N-1）、裸整数。
+bool parse_player_combo_tables(const std::string& py_text, PlayerComboTables& out, std::string* err);
+bool parse_player_combo_tables_file(const std::string& path, PlayerComboTables& out, std::string* err);
+
+} // namespace fmt