UMassBattleHostSubsystem

空构造函数,无初始化逻辑。

Empty constructor; no initialization logic.

USubsystem 生命周期入口。调用父类实现后预热两个子系统缓存(GetMassAPISubsystem / GetMassBattleSubsystem)。

USubsystem lifecycle entry. Calls the parent implementation, then warms two subsystem caches (GetMassAPISubsystem / GetMassBattleSubsystem).

USubsystem 生命周期出口。清空:八个 host 实体池、两个 spawn 缓存(内含失效 fragment 指针)、五个操作 gatherer、六个生成 gatherer、两个回收队列;显式 Stop + DestroyComponent 拆除 2D/3D 音频组件池;清空按 archetype 的弹丸/战利品池与模板缓存;最后清空三个子系统缓存指针。注释说明:按 archetype 池跨世界重置保留(实体随实体管理器 GC),但快照边界不再调用本函数。

USubsystem lifecycle exit. Empties: the eight host entity pools, both spawn caches (holding now-invalid fragment pointers), five op gatherers, six spawn gatherers, both recycle queues; explicitly stops and destroys the 2D/3D audio component pools; clears the per-archetype projectile/loot pools and template caches; finally nulls the subsystem cache pointers. Per-archetype pools survive world resets (entities GC alongside the entity manager); the function is no longer called at snapshot boundaries.

每帧 tick 入口(由 UMassBattleSubsystem::Tick 在模拟阶段之后调用)。当前仅含 profiling 标记与 TickEntityPoolCooldowns 调用。注释说明:协调器单独驱动 ProcessHostOpsQueues 与 ProcessProjectileRecycleQueue,因为它们的槽序(order)承载确定性;ResetPoolTickStats 已移至模拟阶段之前。

Per-frame tick entry (called by UMassBattleSubsystem::Tick after the sim stages). Currently only a profiling scope plus TickEntityPoolCooldowns. The coordinator drives ProcessHostOpsQueues and ProcessProjectileRecycleQueue separately because their slot order is load-bearing; ResetPoolTickStats was moved to before the sim stages.

逐帧 CPU 侧预测插值,作用于附着(Actor/FX/Sound)宿主的 UObject。仅处理 bAttached 且 FHostHierarchy.bResolvedThisTick 的实体:读取层级解析出的世界变换/线速度/角速度与 ResolvedInterpParams,经 FInterpParams 配置调用 Hierarchy->InterpState.Tick 得到插值结果,再按类型应用到 SpawnedActor->SetActorTransform / Niagara 与 Cascade SetWorldTransform / AudioComponent->SetWorldLocationAndRotation。遍历三个追踪数组时即时移除孤立实体(实体失效或 fragment 缺失)。由 UMassBattleSubsystem::Tick 帧末调用。

Per-frame CPU-side prediction interp for attached (Actor/FX/Sound) host UObjects. Processes only entities that are bAttached and whose FHostHierarchy.bResolvedThisTick is set: reads the resolved world transform / linear and angular velocity plus ResolvedInterpParams, runs Hierarchy->InterpState.Tick with FInterpParams, then applies the result per type — SpawnedActor->SetActorTransform / Niagara and Cascade SetWorldTransform / AudioComponent->SetWorldLocationAndRotation. Orphaned entries (invalid entity or missing fragment) are removed from the tracking arrays on the fly. Called at the end of the frame by UMassBattleSubsystem::Tick.

静态访问器:从任意世界上下文对象解析 UWorld 并取其 Host 子系统。世界无效时返回 nullptr。

Static accessor: resolves UWorld from any world-context object and returns its Host subsystem; nullptr when the world is invalid.

静态访问器的引用版本:失败即 checkf 断言崩溃——用于「子系统必须存在」的不变式场景。

Reference version of the static accessor: fails via checkf assertion — for invariant paths where the subsystem must exist.

五个同构的惰性访问器:命中缓存直接返回;否则从当前世界取对应子系统并写入缓存(CurrentWorld 首次解析)。Loot / Projectile / Fx 三个在 Host 内部用于弹丸/战利品 spawn 与 FxEntity 注册。

Five isomorphic lazy accessors: return the cache on hit; otherwise fetch the subsystem from the current world and fill the cache (CurrentWorld resolved on first use). The Loot / Projectile / Fx ones are used internally for projectile/loot spawns and FxEntity registration.

宿主系统的核心串行排空入口(约 1900 行,由 UMassBattleSubsystem::Tick 每帧在阶段边界调用,空闲时快速路径零成本——每帧 5 次调用)。固定段序:① debuff 生成请求(ProcessDebuffSpawnQueues,最早并行阶段产生,最先消费);② 五类 host 生成请求(Actor/Fx/Sound/Projectile/Loot)各自 Merge → 确定性排序(TriggerUID → Sequence,非 Shipping 下校验重复键)→ 批量弹池(AllocateHostEntityBatch:每 (类型,网络类) 单锁单趟降序扫描,指派结果与逐请求分配逐字节一致;Sound 段裁决拒绝的尾段经 ReleaseBatchSlots 归还)+ 并行写 fragment(每实体唯一写者,零 mutation;池空/脏槽回落串行构建,批耗尽后的回落传 bSkipPoolRetry=true 跳过弹池重试);③ FxEntity 配对实体(按 HostUID → AttachUID → SubType → StyleType 确定性链排序后 SpawnFxEntitySerial);④ 五类延迟 UObject 操作队列(ActorOps/FxOps/SoundOps/ProjectileOps/LootOps)——先并行预校验(实体/片段/资产注册表解析),再串行执行 Spawn/Destroy/Transform(资产 LoadSynchronous、Actor SpawnActor、Niagara/Cascade ManualRelease、音频组件池命中或新建;Destroy op 的 UObject 释放延迟收集到 DeferredUObjectDestroys,由渲染后统一移除阶段的 ProcessDeferredUObjectDestroys 执行);⑤ FX 完成检查(串行,UObject 访问);⑥ 弹丸/战利品 ops 段:每 Config 分配 UID → 并行计算轨迹/散布/偏移 → 按 archetype 分组 → 串行弹池/BatchCreate 补齐 → 单次全局并行写 fragment → 注册 UID 映射;⑦ host 实体回收队列入池(无需排序——池为大根堆,弹池序只取决于内容)。Sound 段内嵌模拟层并发裁决:按 Sound 资产分组(RetriggerTime 节流 / MaxCount 上限,PreventNew 拒绝、StopOldest 逐最老、StopLowestPriority 逐最低优先级,MinPlayTime 保护),裁决前先 PrescanSoundRecycles 预扫。

The core serial drain entry of the host system (~1900 lines, called each frame at stage boundaries by UMassBattleSubsystem::Tick; the all-empty fast path costs nothing — 5 calls per frame). Fixed stage order: ① debuff spawn requests (ProcessDebuffSpawnQueues — produced by the earliest parallel stages, consumed first); ② five host-spawn request kinds (Actor/Fx/Sound/Projectile/Loot), each Merge → deterministic sort (TriggerUID → Sequence; duplicate keys log errors in non-Shipping) → batch pool pop (AllocateHostEntityBatch: ONE lock + ONE descending scan per (type, network class), assignment byte-identical to sequential per-request allocation; the Sound segment's adjudication-rejected tail is returned via ReleaseBatchSlots) + parallel fragment write (unique writer per entity, no mutation; pool-empty/dirty slots fall back to serial build with bSkipPoolRetry=true, skipping the pool retry); ③ FxEntity paired entities (sorted by the HostUID → AttachUID → SubType → StyleType deterministic chain, then SpawnFxEntitySerial); ④ five deferred UObject op queues (ActorOps/FxOps/SoundOps/ProjectileOps/LootOps) — parallel pre-pass (entity/fragment/asset-registry resolution) then serial Spawn/Destroy/Transform (LoadSynchronous, Actor SpawnActor, Niagara/Cascade ManualRelease, audio component pool hit or fresh spawn; UObject releases from the Destroy ops are deferred into DeferredUObjectDestroys, executed by ProcessDeferredUObjectDestroys in the unified post-render removal phase); ⑤ FX completion checks (serial, UObject access); ⑥ projectile/loot ops stages: per-Config UID allocation → parallel trajectory/spread/offset computation → archetype grouping → serial pool pop / BatchCreate shortfall → single global parallel fragment write → UID registration; ⑦ host entity recycle queue into pools (no sort — pools are max-heaps, pop order depends only on content). The Sound stage embeds simulation-layer concurrency adjudication: grouped per sound asset (RetriggerTime throttle / MaxCount cap with PreventNew reject, StopOldest evict, StopLowestPriority evict, MinPlayTime protection), preceded by PrescanSoundRecycles.

执行 ProcessHostOpsQueues 的 Destroy op 延迟收集的 UObject 释放(DeferredUObjectDestroys)。每逻辑帧一次,在渲染后统一移除阶段调用——渲染处理器之后、ProcessDestroyQueues 之前(见 UMassBattleSubsystem::Tick):渲染前拆解的宿主仍须渲染最后一帧;先于实体销毁执行时配置片段仍可读取以清理指针。按类别分派:Actor → Destroy() 并置空 SpawnedActor;Fx → Niagara/Cascade 组件 Manual Release 归还池并置空 SpawnedNiagaraSystem/SpawnedCascadeSystem;Sound → Stop() 后经 RecycleAudioComponent 归还组件池并置空 SpawnedSound。顺序 = 收集序(确定性 drain 序,双端一致)。MA 无效时直接清空队列返回。

Executes the UObject releases deferred by ProcessHostOpsQueues' Destroy op cases (DeferredUObjectDestroys). Called once per logic frame in the unified post-render removal phase — after the render processors, before ProcessDestroyQueues (see UMassBattleSubsystem::Tick): a host torn down pre-render must still render its final frame, and running before the entity destroy queue keeps config fragments readable for pointer cleanup. Dispatched per kind: Actor → Destroy() + null SpawnedActor; Fx → Niagara/Cascade components released to their pools (Manual Release) + null SpawnedNiagaraSystem/SpawnedCascadeSystem; Sound → Stop() then RecycleAudioComponent back to the component pool + null SpawnedSound. Order = gather order (deterministic drain order, identical on all peers). Resets the queue and returns early when MA is invalid.

弹丸/战利品回收队列的串行排空(由 UMassBattleSubsystem::Tick 帧末调用)。Merge 后逐条处理:DA 无效或实体已失效 → 直接 DestroyEntity;否则把 PoolCountdown 重置为统一的 PoolIdleLifeSpan 并按其 UniqueID 推入对应按 archetype 池桶(大根堆)。无需排序——弹池序只取决于池内容。

Serial drains of the projectile/loot recycle queues (called at the end of the frame by UMassBattleSubsystem::Tick). After Merge: an invalid DA or dead entity is destroyed outright; otherwise PoolCountdown is reset to the unified PoolIdleLifeSpan and the entity is pushed into its per-archetype pool bucket (max-heap) by UniqueID. No sort needed — pop order depends only on pool content.

从指定类型池弹一个宿主实体。持 PoolAllocationLock 自旋锁,并行处理器可安全调用。逐项弹出最大 UID 槽直至匹配:FNetworkTag 状态与 bNetworkSync 不符的槽暂存放回(槽的 tag 创建时定死——同步生成不复用纯表现槽、反之亦然,双向都会破坏 hash/UID 状态;弹池结果与形状无关,各端仍选同一槽);失效句柄直接丢弃(实体已被处理器销毁,如 TTL)。命中时 FromPool 计数 +1;池空或全失效时 Fresh 计数 +1 并返回无效句柄(调用方回落 BuildEntityDefer)。

Pops a host entity from the pool of the given type. Holds the PoolAllocationLock spin lock, so parallel processors may call it safely. Pops the largest-UID slot repeatedly until a match: slots whose FNetworkTag state differs from bNetworkSync are stashed and re-pushed (a slot's tag is fixed at creation — sync spawns never reuse local-only slots and vice versa; both directions would corrupt hash/UID state; the pop result is shape-independent, so peers still pick the same slot); stale handles are discarded (entity already destroyed by a processor, e.g. TTL). On hit, FromPool is incremented; when the pool is empty or all-stale, Fresh is incremented and an invalid handle is returned (caller falls back to BuildEntityDefer).

drain 段的批量弹池变体:每 (类型, 网络类) 每 tick 持一次 PoolAllocationLock、单趟降序扫描,收集至多 Wanted 个匹配槽;反类槽(FNetworkTag 状态不符)单次暂存到 BatchMismatchScratch、单趟回插。逐请求分配每请求重复弹插同一批反类槽(O(N*M) 空转)——批量单趟弹出同一降序序列,指派结果(drain 序请求获得 UID 降序匹配槽)与逐请求 AllocateHostEntity 调用逐字节一致;弹池结果与堆形状无关(见 HostEntityPools 注释)。函数内不计统计——drain 循环按消费逐请求计 FromPool/Fresh(同时消除逐请求路径池空重试的 Fresh 双计)。

Batch pool-pop variant for the drain segments: ONE lock on PoolAllocationLock + ONE descending scan per (Type, network class) per tick, collecting up to Wanted matching slots; opposite-class slots are stashed once into BatchMismatchScratch and re-pushed in a single pass. Per-request allocation re-pops those mismatches on EVERY request (O(N*M) churn) — the batch pops the identical descending sequence in one pass, so the assignment (drain-order requests receive matching slots in descending-UID order) is byte-identical to sequential AllocateHostEntity calls; pop results stay shape-independent (see the HostEntityPools note). No stats inside — the drain loops tally FromPool/Fresh per consumed request (also removing the per-request path's double Fresh tally on pool-miss retries).

归还批量未消费的尾段入池。Sound 段专用——并发裁决在批量按请求总数(上限)取数后拒绝部分请求,尾段由此归还。与回收 drain 同款 push 纪律(UID 键取自 FDeterminism;失效句柄防御性丢弃——实际 drain 中不会失效)。

Returns the unconsumed tail of a batch to the pool. Used by the Sound segment, where adjudication rejects requests after the batch was sized to the full request count (upper bound). Same push discipline as the recycle drain (UID key from FDeterminism; stale handles dropped defensively — cannot go stale mid-drain in practice).

把宿主实体归还池以待复用。仅入队 HostEntityRecycleQueue(FParallelGatherer,无锁)——实际入池由 ProcessHostOpsQueues 末端串行执行。并行处理器可安全调用。

Returns a host entity to the pool for reuse. Only enqueues into HostEntityRecycleQueue (FParallelGatherer, lock-free) — the actual pool push happens serially at the tail of ProcessHostOpsQueues. Safe to call from parallel processors.

[RULE8] 锁步宿主生成前的附着目标校验:目标无效、非宿主实体(agent/projectile/loot——均为锁步实体)或带 FNetworkTag 的同步宿主均放行;仅「本地宿主父级(UID=-1,从不注册)」违规——此时 fail loud 打 Error 日志(生成继续,日志标出开发者/配置错误),因为快照恢复的父引用修复会悬挂。由所有锁步 spawn 分支调用。

[RULE8] Attach-target validation before lockstep host spawns: invalid targets, non-host parents (agent/projectile/loot — all lockstep entities) and sync hosts carrying FNetworkTag all pass; only a local-only host parent (UID=-1, never registered) violates the rule — fail loud with an Error log (spawn proceeds; the log marks the developer/config error), because the snapshot-restore parent fixup would dangle. Called by every lockstep spawn branch.

五类 host 的串行构建入口(由 ProcessHostOpsQueues drain 段的池空/脏槽分支调用;drain 现经 AllocateHostEntityBatch 批量弹池,批耗尽后的回落构建传 bSkipPoolRetry=true 跳过内部弹池重试)。流程:先 AllocateHostEntity 弹池——命中则经 WriteXxxHostSerialClean 串行清理残留 UObject 后写 fragment;池空则构建模板:FMainType(Host) + FDeterminism(恒分配 UID,AllocNextUID 并 RandomStream.Initialize(UID)) + FHostHierarchy(延迟期间始终追踪父级:AttachToEntity 优先,否则 OwnerEntity) + FHostControllerTag + 类别 fragment + 网络标记(仅 bNetworkedMode && bLockstepNetworked:FNetworkTag + FNetworking.Key 命中对应骨架模板;Actor/Sound 恒带 FCpuInterpTag;Fx 依 InterpMode==CPU || (SubType_Index<0 && bAttached) 条件带),最后 BuildEntityDefer。SpawnProjectileHostSerial 与 SpawnLootHostSerial 的网络参与条件为整局 bNetworkedMode(无 per-config 开关)。

Serial build entries for the five host kinds (called by the pool-empty / dirty-slot branches of the ProcessHostOpsQueues drain; the drain now batch-pops via AllocateHostEntityBatch, and the fallback build right after a batch exhausted the class pool passes bSkipPoolRetry=true to skip the internal pool retry). Flow: first AllocateHostEntity — on hit, WriteXxxHostSerialClean cleans leftover UObjects serially then writes fragments; on pool-empty, build a template: FMainType(Host) + FDeterminism (always allocates a UID via AllocNextUID and RandomStream.Initialize(UID)) + FHostHierarchy (parent always tracked during delay: AttachToEntity preferred, else OwnerEntity) + FHostControllerTag + the kind's fragment + network markers (only when bNetworkedMode && bLockstepNetworked: FNetworkTag + FNetworking.Key hitting the matching skeleton template; Actor/Sound always carry FCpuInterpTag; Fx adds it on InterpMode==CPU || (SubType_Index<0 && bAttached)), then BuildEntityDefer. SpawnProjectileHostSerial / SpawnLootHostSerial gate network participation on the whole-session bNetworkedMode (no per-config switch).

六类 host 的即时生成入口(锁步外调用点也可用)。Actor/Fx/Sound 为「无 Context 重载」:按是否处于锁步命令窗口(UMassBattleNetworkSubsystem::IsInCommandExecution)自动分流——锁步窗口内 → 同步版(分配 UID + 网络 fragment);锁步外(BP 直调)→ 纯表现版(UID=-1 哨兵、无网络 fragment,一次锁步外生成就会偏移各端 UID 空间 → 永久失步,故刻意跳过两个游标)。bAllocIdentity = !bNetworkMode || (bLockstepPath && bLockstepNetworked),bSyncParticipant = bNetworkMode && bLockstepPath && bLockstepNetworked。SpawnProjectileHost / SpawnLootHost / SpawnAgentHost 直接以整局网络模式决定。四元分流:弹池命中 → 串行清理+写;池空 → 构建模板(BuildEntityDefer)。

Immediate spawn entries for the six host kinds (usable from off-lockstep call sites too). Actor/Fx/Sound are context-free overloads that auto-split on whether the lockstep command window is open (UMassBattleNetworkSubsystem::IsInCommandExecution): inside the window → sync version (UID allocated + network fragments); off-lockstep (BP direct call) → local-only version (UID=-1 sentinel, no network fragments — a single off-lockstep spawn would shift every peer's UID space → permanent desync, so both cursors are deliberately skipped). bAllocIdentity = !bNetworkMode || (bLockstepPath && bLockstepNetworked); bSyncParticipant = bNetworkMode && bLockstepPath && bLockstepNetworked. SpawnProjectileHost / SpawnLootHost / SpawnAgentHost gate on the session-wide network mode directly. Four-way split: pool hit → serial clean + write; pool-empty → template build (BuildEntityDefer).

FX 配对实体(fallback,非池)的串行构建。模板与池实体同 archetype(永不迁移):FBatchedFxTag + FSubType + FStyleType + FLocating + FRotating + FScaling + FEntityFlagFragment(Activated/BurstFx)+ FFxVisualizing + FMainType(FxEntity) + FDeterminism。关键细节:非池路径必须播种 ParentGT(否则 ParentLocArray 原点拉丝),且 ParentGTScale 必须是父级缩放而非 FX 自身 SpawnScale(播种 SpawnScale 会使首帧按 SpawnScale 倍渲染);UID 仅当 bNetworked(或非网络模式)时分配,纯表现宿主派生的 FX 实体保持 -1;构建后写回宿主的 PairedFxEntity,并延迟(实体 build 完成后)经 FMassDeferredSetCommand 注册 UID 映射。

Serial build of an FX paired entity (fallback, non-pool). Template shares the pool archetype (never migrates): FBatchedFxTag + FSubType + FStyleType + FLocating + FRotating + FScaling + FEntityFlagFragment (Activated/BurstFx) + FFxVisualizing + FMainType(FxEntity) + FDeterminism. Key details: the non-pool path must seed ParentGT (else the ParentLocArray renders a ribbon from the origin), and ParentGTScale must be the PARENT's scale, not the FX's own SpawnScale (seeding SpawnScale flashes first-frame renders at SpawnScale×); UID is allocated only when bNetworked (or in non-networked mode) — FX entities derived from local-only hosts keep -1; after build, PairedFxEntity is written back to the host and the UID mapping is registered deferred (after the entity is built) via FMassDeferredSetCommand.

FX 骨架模板键映射,镜像 SpawnFxHost 的 FCpuInterpTag 条件:InterpMode==CPU || (SubType_Index<0 && bAttached) → "FxHost_CPU",否则 "FxHost"。每个 archetype 解析到自己的 key,保证快照 TemplateKey 恢复时总能命中对应骨架。

FX skeleton template key mapping, mirroring the FCpuInterpTag condition in SpawnFxHost: InterpMode==CPU || (SubType_Index<0 && bAttached) → "FxHost_CPU", else "FxHost". Each archetype resolves to its own key so the snapshot TemplateKey always hits the matching skeleton at restore.

FxEntity 骨架模板键,固定返回 "FxEntity"。

FxEntity skeleton template key; always returns "FxEntity".

构建 FX 骨架模板——仅身份(archetype 组合),运行时字段恢复时被快照 blob 覆盖。按 Key 分两支:"FxEntity" 组合 FBatchedFxTag + FNetworkTag + FSubType + FStyleType + FLocating + FRotating + FScaling + FEntityFlagFragment + FFxVisualizing + FMainType(FxEntity) + FDeterminism + FNetworking(Key);"FxHost"/"FxHost_CPU" 组合 FHostControllerTag + FNetworkTag + FMainType(Host) + FFxConfig_Final + FHostHierarchy + FDeterminism + FNetworking(Key)(CPU 变体带 FCpuInterpTag)。纪律:组合必须与网络 spawn 分支(SpawnFxHost 新建分支 / HostMonoProcessor fallback FxEntity 分支)完全一致,否则恢复出的实体掉出处理器查询。

Builds an FX skeleton template — identity only (archetype composition); runtime fields are overwritten by the snapshot blob on restore. Two branches by Key: "FxEntity" composes FBatchedFxTag + FNetworkTag + FSubType + FStyleType + FLocating + FRotating + FScaling + FEntityFlagFragment + FFxVisualizing + FMainType(FxEntity) + FDeterminism + FNetworking(Key); "FxHost"/"FxHost_CPU" compose FHostControllerTag + FNetworkTag + FMainType(Host) + FFxConfig_Final + FHostHierarchy + FDeterminism + FNetworking(Key) (the CPU variant adds FCpuInterpTag). Rule: the composition MUST match the networked spawn branches (SpawnFxHost new branch / HostMonoProcessor fallback FX-entity branch) exactly, otherwise restored entities fall out of processor queries.

五类单 key 骨架模板构建,组合模式一致:FHostControllerTag + FNetworkTag + FMainType(Host) + 类别 fragment(FProjectileConfig_Final / FLootConfig_Final / FActorSpawnConfig_Final / FSoundConfig_Final / FAgentHostConfig_Final) + FHostHierarchy + FDeterminism + FNetworking(Key)。Actor/Sound 恒带 FCpuInterpTag(宿主恒 CPU 插值);Agent 无。纪律:组合必须与对应 SpawnXxxHost 网络新建分支完全一致,否则恢复出的宿主掉出处理器查询。

Five single-key skeleton template builders with one composition pattern: FHostControllerTag + FNetworkTag + FMainType(Host) + the kind's fragment (FProjectileConfig_Final / FLootConfig_Final / FActorSpawnConfig_Final / FSoundConfig_Final / FAgentHostConfig_Final) + FHostHierarchy + FDeterminism + FNetworking(Key). Actor/Sound always carry FCpuInterpTag; Agent does not. Rule: the composition MUST match the corresponding networked SpawnXxxHost new branch exactly, otherwise restored hosts fall out of processor queries.

六个骨架模板幂等注册入口:把各自骨架(FxHost / FxHost_CPU / FxEntity; ProjectileHost; LootHost; ActorHost; SoundHost; AgentHost)经 RegisterNetworkTemplateData 注册进网络快照注册表(重复进入返回已有注册)。全部由 UMassBattleNetworkSubsystem::Initialize 调用一次——先于任何 peer 应用任何快照。

Six idempotent skeleton registration entries: register their skeletons (FxHost / FxHost_CPU / FxEntity; ProjectileHost; LootHost; ActorHost; SoundHost; AgentHost) into the network snapshot registry via RegisterNetworkTemplateData (re-entry returns the existing registration). All called once from UMassBattleNetworkSubsystem::Initialize — before any snapshot is applied on any peer.

销毁所有池内实体并清空全部池与回收队列(工具方法,如关卡拆除)。收集所有休眠句柄后经 UMassAPIFuncLib::DestroyEntities 批量销毁;同时丢弃 pending 回收条目与 host 生成 gatherer 中可能携带快照前帧的过期句柄。注释:不再于快照边界调用——池已是快照状态(恢复放回 pass 重建)。

Destroys every pooled entity and empties all pools + recycle queues (utility, e.g. level teardown). Collects all dormant handles, destroys them via UMassAPIFuncLib::DestroyEntities, and drops pending recycle entries and pre-snapshot stale handles in the spawn gatherers. No longer called at the snapshot boundary — pools are snapshot state now (restore push-back pass rebuilds them).

快照恢复路径:把重建的休眠宿主放回对应类型池。堆 push 序无关紧要——等内容的双端 max-heap 弹池恒取同一最大 UID 实体(恢复放回 = 快照内容 = 服务器池内容);恢复端按 (类型, UID) 升序调用 = 服务器 UID 升序池序 → LIFO 弹池对齐。

Snapshot restore path: pushes a rebuilt dormant host back into its pool. Heap push order is irrelevant — max-heap pops pick the same largest-UID entity from equal content (restore push-back = snapshot content = server pool content); restore iterates (type, UID) ascending = the server's UID-sorted pool order → LIFO pop parity.

快照恢复路径:把重建的休眠弹丸/战利品实体放回其按 DA 分组的池(镜像回收段的池推入,单线程)。DA 非空时按实体 UID 推入对应桶。

Snapshot restore paths: push a rebuilt dormant projectile/loot entity back into its per-DA pool (mirrors the recycle-drain pool push, single-threaded). Pushed into the bucket keyed by the DA when the DA is non-null.

恢复路径:resync 的 DestroyQuery 已销毁全部带 FNetworkTag 的池内实体,池数组全是失效句柄——清空它们(三个池族),让放回 pass 纯粹按 (类型, UID) 从 payload 重建池。

Restore path: the resync DestroyQuery destroyed every pooled entity (they carry FNetworkTag), so all pool arrays hold stale handles — empty them (all three pool families) so the push-back pass rebuilds pools purely from the payload in (type, UID) order.

从按 archetype 池弹一个休眠实体。仅限单线程上下文(调用方分别是 ProcessHostOpsQueues 的弹丸/战利品段与 TryReuseProjectileFromPool)——确定性弹池序。max-heap 弹最大 UID 实体,锁步同步内容下双端一致。池空或 DA 无效返回无效句柄(调用方回落新建)。

Pops one dormant entity from the per-archetype pool. Single-threaded only (callers are the projectile/loot stages of ProcessHostOpsQueues and TryReuseProjectileFromPool) — deterministic pop order. The max-heap pops the largest-UID entity, identical on both peers from lockstep-synchronized content. Returns an invalid handle when the pool is empty or the DA is null (caller falls back to building fresh).

为给定 Sound 资产弹一个已停止的 UAudioComponent(2D/3D 池按参数选择)。逐项弹出直至找到有效组件或池空——组件可能在回收与复用之间被 GC(Sound 资产被卸载),顺带以同锁步方式弹出 Cooldowns 保持双数组等长不变量。池空返回 nullptr(调用方回落 UGameplayStatics::SpawnSound*)。仅游戏线程。

Pops a stopped UAudioComponent for the given Sound asset (2D/3D pool selected by argument). Pops entries until a live one is found or the pool empties — components may have been GC'd between recycle and reuse (sound asset unloaded); Cooldowns is popped in lockstep to keep the twin-array invariant. Returns nullptr when the pool is empty (caller falls back to UGameplayStatics::SpawnSound*). Game-thread only.

把已停止的音频组件推回池。调用方须已对组件调用 Stop()。池无上限增长,冷却 drain 回收空闲条目。每次 push 把冷却重置为统一的 PoolIdleLifeSpan。

Pushes a stopped audio component back to the pool. The caller is responsible for having already called Stop() on the component. The pool grows unbounded; the cooldown drain reclaims idle entries. Cooldown resets to the unified PoolIdleLifeSpan on every push.

返回指定池当前可用实体数。注意:读取的 TArray 可能正被 ProcessSpawnQueues 或 AllocateHostEntity 修改——在 spawn 处理器(并行)上下文中这是启发式检查,非严格值。

Returns the current number of available entities in the specified pool. Note: this reads a TArray that may be modified by ProcessSpawnQueues or AllocateHostEntity — in the spawn processor (parallel) context this is a heuristic check, not strict.

快照重建(resync)期间收集一个恢复的活跃(非池)Sound 宿主。重建 pass 已遍历全部宿主,无需独立查询。键组装必须与 MakeSoundConcurrencyKey 完全一致("A:" + 路径 + bLimitToOwner 时的 "|O:" + 属主 UID)。由 UMassBattleNetworkSubsystem 恢复循环调用。

Collects one restored ACTIVE (non-pooled) Sound host during snapshot rebuild (resync). The rebuild pass already walks every host, so no standalone query is needed. Key assembly must mirror MakeSoundConcurrencyKey exactly ("A:" + path + "|O:" + owner UID when bLimitToOwner). Called by the UMassBattleNetworkSubsystem restore loop.

重建循环结束后提交并发状态:清空触发历史(LastTriggerTimeByOwner——触发历史不跨 resync),并把每组按 (StartTime, UID) 排序——与捕获端插入保持的顺序一致,StopOldest 双端扫描同序。

Commits the concurrency state after the rebuild loop: clears the trigger history (LastTriggerTimeByOwner — trigger history does not survive a resync) and sorts every group by (StartTime, UID) — the same order the capture side maintains on insert, so StopOldest scans identically on both peers.

对按 archetype 弹丸/战利品池与按 Sound 音频组件池逐条目递减冷却。弹丸/战利品桶:两遍清扫(先递减、后删除)保证每条目恰好递减一次(堆形状双端本就不同,就地删除会把已访问条目换入未访问槽 → 重复/漏递减 → PoolCountdown 失步);失效句柄直接丢弃;冷却到期条目无条件移除并入 EntitiesToDestroyQueue(无下限,桶可缩到 0)。音频池:逐条目递减,过期组件无条件 DestroyComponent,Components/Cooldowns 双数组同锁步移除;防御性对齐双数组长度。由 ExecuteTick 每 MB tick 调用一次,仅游戏线程。

Ticks each entry's cooldown across the per-archetype projectile/loot pools and per-sound audio component pools. Projectile/loot buckets: a two-phase sweep (decrement pass, then removal pass) so every entry is decremented exactly once (heap shape legitimately differs per peer; in-place removal would swap already-visited entries into unvisited slots → double/missed decrements → PoolCountdown desync); stale handles are discarded; expired entries are removed unconditionally and queued into EntitiesToDestroyQueue (no floor — buckets can shrink to 0). Audio pools: each cooldown is decremented; expired components get DestroyComponent unconditionally and both arrays are trimmed in lockstep; array lengths are defensively re-synced. Called once per MassBattle tick from ExecuteTick. Game-thread only.

清零 tick 统计(实现中循环索引 0..5 共 6 个 host 池统计,加弹丸/战利品/音频各一)。由 UMassBattleSubsystem::Tick 在模拟阶段之前调用,先于级间生成,使统计反映本帧活动。

Resets the pool tick stats (the implementation loops indices 0..5 — six host pool stats — plus projectile/loot/audio). Called by UMassBattleSubsystem::Tick before the sim stages, preceding inter-stage spawns so the stats reflect this frame's activity.

三个 Fresh 计数记录器(原子加/自增),供实体级池的新建路径(ProcessHostOpsQueues 的补齐分支与音频新建分支)记账——这类池的新建不在 AllocateHostEntity 内,故需单独记录。

Three atomic Fresh-counter recorders for the entity-level pool fresh-build paths (the ProcessHostOpsQueues shortfall branches and the audio fresh-spawn branch) — these builds don't flow through AllocateHostEntity, so they are tallied separately.

三个总计查询:汇总所有按 archetype 桶 / 2D+3D 音频池的休眠条目数,供调试打印(非热路径)。

Three total queries summing dormant entries across all per-archetype buckets / 2D+3D audio pools for the debug printer (not a hot-path call).

按数据资产缓存 archetype-only 模板(DA 静态状态,无逐生成数据)。首次访问经 MakeProjectileTemplateFromDataAsset / MakeLootTemplateFromDataAsset 构建并缓存,供 ProcessHostOpsQueues 的 BatchCreate 复用——消除逐 Config 模板构建。缓存失效(IsValid 为假)时重建。调用方不得在下次世界重置后保留返回指针。

Caches an archetype-only template per data asset (DA-driven static state, no per-spawn data). Built lazily from MakeProjectileTemplateFromDataAsset / MakeLootTemplateFromDataAsset on first access and reused by ProcessHostOpsQueues for BatchCreate — eliminates per-Config template construction. Rebuilt when the cache entry goes invalid. Callers must not retain the pointer past the next world reset.

自身帧(尊重 bAttached)批量生成助手(Appear/Hit/Death Actor/FX/Sound)。逐配置:动画过滤(BindToAnimIndex)、bEnable 与资产非空过滤;拷贝为 XxxConfig_Final 并覆写 OwnerEntity、按 RandHelper(MAX_int32) 播种随机流、可选覆写行为状态、Delay /= SpeedMultiplier;附着时经 LocalOffsetToWorld 计算 SpawnTransform 与 InitialRelativeTransform,否则仅位置。随后走并行池直取路径(仅非确定性 !bDeterministic):弹池命中且槽干净 → 仅写 fragment(每实体唯一写者,零 mutation;池实体已带固定 UID,弹取不消费全局计数器,顺序无关);脏槽回收回落 gatherer;池空回落 gatherer。Sound 版带并发配置的请求必须走串行 drain(裁决在游戏线程,池直取在 worker 线程不能碰 ActiveSoundHostUIDs)。最终以 (TriggerUID, SeqInOut++) 入队对应生成 gatherer。

Self-frame (bAttached-respecting) batch spawn helpers (Appear/Hit/Death Actor/FX/Sound). Per config: anim filter (BindToAnimIndex), bEnable and asset-non-null filters; copies into XxxConfig_Final and overwrites OwnerEntity, seeds the random stream via RandHelper(MAX_int32), optionally overrides the behavior state, applies Delay /= SpeedMultiplier; attached configs get SpawnTransform + InitialRelativeTransform via LocalOffsetToWorld, otherwise location-only. Then the parallel pool-direct path (non-deterministic only): pool hit with a clean slot → fragment write only (unique writer, no mutation; pooled entities carry a fixed UID, so popping never consumes the global counter — order-independent); dirty slots are recycled back to the gatherer; pool-empty falls through to the gatherer. The Sound variant routes concurrency-enabled requests through the serial drain (adjudication lives on the game thread; worker threads cannot touch ActiveSoundHostUIDs). Finally enqueues (TriggerUID, SeqInOut++) into the matching spawn gatherer.

ESpawnOrigin 驱动(AtSelf/AtTarget)的批量生成助手(Attack 系列,由 MassBattleAgentBehaviorProcessor 调用)。AtSelf:附着 OwnerEntity,以自身帧计算变换;AtTarget:目标实体须有效且带 FRotating(目标完整旋转,统一),附着 TargetEntity,以目标位置+自身帧旋转计算变换。过滤、随机播种、池直取与入队逻辑同 SpawnActorBatch 系列。Projectile 版额外写入 TargetEntity / ToPoint,并从目标 FMoving 读 TargetVelocity;弹丸无 UObject,无脏守卫。

Origin-driven (AtSelf/AtTarget) batch spawn helpers (the Attack series, called by MassBattleAgentBehaviorProcessor). AtSelf: attaches to OwnerEntity and computes the transform in the self frame. AtTarget: requires a valid target with FRotating (full target rotation, unified), attaches to TargetEntity and computes the transform from the target location plus the self-frame rotation. Filtering, seeding, pool-direct and enqueue logic match the SpawnActorBatch series. The Projectile variant additionally writes TargetEntity / ToPoint and reads TargetVelocity from the target's FMoving; projectile slots carry no UObject, so there is no dirty guard.

战利品批量生成助手(自身帧,无附着——战利品自由掉落;Death loot,由 MassBattleAgentReactionProcessor 调用)。无动画过滤(FLootConfig 无 BindToAnimIndex);写入 FromPoint / FlowFieldPtr / FlowFieldSoftPtr(快照友好软来源);SpawnTransform 恒为 LocalOffsetToWorld 结果。

Loot batch spawn helper (self-frame, no attach — loot drops free; Death loot, called by MassBattleAgentReactionProcessor). No anim filter (FLootConfig has no BindToAnimIndex); writes FromPoint / FlowFieldPtr / FlowFieldSoftPtr (snapshot-friendly soft source); SpawnTransform is always the LocalOffsetToWorld result.

把已有 Host 实体链接为另一 Host 实体的子节点。校验:两句柄有效、非同一实体、均带 FHostControllerTag;子节点必须尚无父级(AttachmentSource == WorldAnchor);从 ParentHost 向上遍历检测环(遇到 ChildHost 或重复访问即拒绝)。成功后写子节点的层级字段(AttachmentSource = ParentHost + AttachmentEntity + ParentHost),把相对变换写入子节点所属类别配置(InitialRelativeTransform + bAttached = true),并以头插维护父级的侵入式子链表。

Links an existing Host entity as a child of another Host entity. Validates: both handles valid, not the same entity, both carry FHostControllerTag; the child must not already have a parent (AttachmentSource == WorldAnchor); walks up from ParentHost to detect cycles (rejects when ChildHost or an already-visited handle is encountered). On success writes the child's hierarchy fields (AttachmentSource = ParentHost + AttachmentEntity + ParentHost), writes the relative transform into whichever config fragment the child has (InitialRelativeTransform + bAttached = true), and inserts at the head of the parent's intrusive child list.

把子 Host 从父级解绑,提升为新 WorldAnchor 根;其子树保持不变(子节点仍通过 ParentHost 指向此 Host)。校验:句柄有效、带 FHostControllerTag、确为 ParentHost 子节点。经 O(1) 拼接从父级侵入式子链表移除(含头指针更新),随后清空子节点的全部层级字段。

Unlinks a child Host from its parent, promoting it to a new WorldAnchor root; its subtree remains intact (children still point to this Host via ParentHost). Validates: valid handle, carries FHostControllerTag, is a ParentHost child. Removes from the parent's intrusive child list via O(1) splice (including the head-pointer update), then clears all of the child's hierarchy fields.