协议总索引

八大模块涉及的全部协议，号码全部核对自 Src/Core/Define/Net/NetDefine.ts。 拿到一个陌生协议号先来这里查。

1. 命名与编号规律

1.1 号段分布

2. 传送

3. 传送点与地图

4. 副本（含结算）

5. 爬塔

5.1 局内（副本内实时 HUD）

5.2 局外（存档与排行）

6. 关卡玩法（重生 / 计时器 / 子弹）

7. 场景加载与流送

8. 使用规范

8.1 注册与注销必须配对

protected override OnRegisterNetEvent(): void {
    Net.Register(ENotifyMessageId.WorldDungeonTowerStarStartSCNotify, this.OnTowerStarStart);
    Net.Register(ENotifyMessageId.WorldDungeonTowerStarUpdateSCNotify, this.OnTowerStarUpdate);
}
protected override OnUnRegisterNetEvent(): void {
    Net.UnRegister(ENotifyMessageId.WorldDungeonTowerStarStartSCNotify);
    Net.UnRegister(ENotifyMessageId.WorldDungeonTowerStarUpdateSCNotify);
}

8.2 int64 必须转换

// ❌ protobuf 的 int64 是 Long 对象，直接算得 NaN
const t = progress.condition.waitTimeData.endTimeMs;

// ✅
const t = MathUtils.LongToNumber(progress.condition?.waitTimeData?.endTimeMs ?? 0);

时间戳、uid、大数值属性都要转。这是「数值算出来是 NaN」的头号原因。

8.3 收包端的四条防御

8.4 增删协议的正确姿势