UMassBattleNetworkRelay

初始化:记录模式与世界,清空全部 DedicatedServer 状态(投票聚合、共识历史、快照历史、挂起上传、期望客户端数 ExpectedClientCount)。DedicatedServer 模式下同时重置自主时钟(CurrentTick/SimulationTime/TimeAccumulator 归零)。

Initialization: records the mode and world, clears all DedicatedServer state (voting aggregations, agreed history, snapshot history, pending uploads, and the expected client count ExpectedClientCount). In DedicatedServer mode the autonomous clock (CurrentTick/SimulationTime/TimeAccumulator) is also reset to zero.

自主时钟(仅 DedicatedServer 活跃;ListenServer 下立即返回,时钟由 Subsystem 驱动)。累计 TimeAccumulator 达到 TickInterval 即推进一个 tick:CurrentTick++、SimulationTime += TickInterval,随后 EvaluateHashVoting 评估待处理投票。

Autonomous clock (active in DedicatedServer mode only; ListenServer returns immediately — the clock is driven by the Subsystem). Advances one tick once TimeAccumulator reaches TickInterval: CurrentTick++, SimulationTime += TickInterval, then EvaluateHashVoting runs.

自主时钟访问器:GetCurrentTick 返回当前自主 tick,GetSimulationTime 返回累计模拟时间,SetTickInterval 覆盖 TickInterval(默认 0.0333s = 30Hz)。当前仅 DedicatedServer 推进。

Autonomous clock accessors: GetCurrentTick returns the current autonomous tick, GetSimulationTime the accumulated simulation time, and SetTickInterval overrides TickInterval (default 0.0333s = 30Hz). Advanced only in DedicatedServer mode today.

接收客户端 tick hash(仅 DedicatedServer;其它模式忽略)。在 HashAggregations 中按 tick 聚合(FindOrAdd),记录首个上报的世界时间作为超时锚点。由 AMassBattleNetworkGameModeBase::ReportClientHash 转发。

Receives a client tick hash (DedicatedServer only; ignored otherwise). Aggregates by tick into HashAggregations (FindOrAdd), recording the first-report world time as the timeout anchor. Forwarded by AMassBattleNetworkGameModeBase::ReportClientHash.

评估所有超时的 Waiting 聚合(HashAggregationTimeout 起算于首报时间)。法定人数基准 = ExpectedClientCount(>0 时),否则回退为实收报告数——传报告数会使 Consensus 检查变成自比较(单个上报者恒真),单个客户端即可伪造共识(审计 M8)。Consensus/Majority → 更新 AgreedHash/LastAgreedTick/TickHashHistory(Majority 递增 MinorityResyncCount);Split → FullResyncCount++;Timeout → 保守处理:期望上报者未齐、部分法定人数不产生共识,直接 FullResyncCount++(不再以已报告者重新评估)。完成后移除已处理聚合;TickHashHistory 超过 2 × ConsensusHashHistoryLength 时按 CurrentTick - ConsensusHashHistoryLength 阈值裁剪。

Evaluates every timed-out Waiting aggregation (HashAggregationTimeout anchored at the first report). The quorum basis is ExpectedClientCount when > 0, falling back to the reporter count — passing the reporter count made the Consensus check self-comparing (trivially true for a lone reporter) and let a single client fabricate consensus (audit M8). Consensus/Majority → updates AgreedHash/LastAgreedTick/TickHashHistory (Majority also increments MinorityResyncCount); Split → FullResyncCount++; Timeout → conservative: not all expected reporters answered, a partial quorum yields no consensus, straight to FullResyncCount++ (no re-evaluation with the reporters). Handled aggregations are removed; when TickHashHistory exceeds 2 × ConsensusHashHistoryLength it is pruned by the CurrentTick - ConsensusHashHistoryLength threshold.

设置 hash 投票的期望在线客户端数(写入前经 FMath::Max 钳制到 ≥0)。投票法定人数以此为基准而非实收报告数——传报告数会使 Consensus 检查变成自比较(单个上报者恒真),单个客户端即可伪造共识(审计 M8)。由 AMassBattleNetworkGameModeBase 在 Login / Logout 时以 PlayerSlotToPlayerId.Num() 调用,保持法定人数与在线数同步。

Sets the expected connected-client count for hash voting (clamped to ≥0 via FMath::Max before writing). Voting is decided against THIS, not the number of reporters — passing the reporter count made the Consensus check self-comparing (trivially true for a lone reporter) and let a single client fabricate consensus (audit M8). Called by AMassBattleNetworkGameModeBase on Login / Logout with PlayerSlotToPlayerId.Num() to keep the quorum in sync with the connected count.

存储客户端上传的压缩快照(SnapshotHistory,标记是否共识 tick)。仅 DedicatedServer 接受——其它模式(含 ListenServer)直接返回。双重内存上界(审计 H6):① 总字节预算——已存字节总和(同 tick 覆盖写先扣除旧载荷)加上新上传超过 MaxSnapshotHistoryBytes 时,拒绝本次上传并输出警告日志;② 条目数上界——历史超过 SnapshotHistoryLength 时按「最旧优先」裁剪到上限(与自主时钟无关,替代旧的按 CurrentTick 阈值裁剪——旧裁剪在自主时钟未推进时永不触发,导致无界增长)。

Stores a client-uploaded compressed snapshot (SnapshotHistory, marking agreed ticks). DedicatedServer only — other modes (including ListenServer) return immediately. Two memory bounds (audit H6): ① total byte budget — when stored bytes (a same-tick overwrite deducts the old payload first) plus the new upload exceed MaxSnapshotHistoryBytes, the upload is rejected with a warning log; ② entry cap — when history exceeds SnapshotHistoryLength, the oldest entries are pruned down to the cap (clock-agnostic, replacing the old CurrentTick-threshold prune, which never fired when the autonomous clock had not advanced and let history grow unboundedly).