UMassBattleAgentSubsystem

默认构造函数,实现体为空({})。所有成员使用类内初始化;确定性随机流 RandomStream 的种子在 Initialize 中设置。

Default constructor with an empty body ({}). All members use in-class initializers; the deterministic RandomStream seed is set in Initialize.

USubsystem 生命周期入口。调用父类后预热 UMassAPISubsystem 与 UMassBattleSubsystem 缓存,然后把 RandomStream 以固定常量种子 0x5EEDBEEF 初始化——保证所有客户端默认确定一致;如需会话级变化,从 BP 重新设置 RandomStream(源码注释)。

USubsystem lifecycle entry. After calling the parent, it warms the UMassAPISubsystem / UMassBattleSubsystem caches and initializes RandomStream with the fixed constant seed 0x5EEDBEEF — all clients are deterministic by default; for per-session variation, re-seed RandomStream from BP (source comment).

USubsystem 生命周期出口。调用父类后清空三个子系统缓存指针、清空 ActorSpawnRequestQueue / ActorRecycleQueue,并清空 LocalVisualRegistry——本地视觉宿主随世界消亡,清空登记表防止子系统实例复用时向新世界重放过期登记项(源码注释)。

USubsystem lifecycle exit. After calling the parent, it nulls the three subsystem caches, empties ActorSpawnRequestQueue / ActorRecycleQueue, and empties LocalVisualRegistry — local visual hosts die with the world, and clearing the registry prevents a reused subsystem instance from replaying stale entries into a fresh world (source comment).

每逻辑帧 tick 入口(由 UMassBattleSubsystem::ExecuteTick 在模拟阶段之前调用)。流程:① ProcessDeferredSpawnRequests() 批量处理延迟生成;② 排空 ActorSpawnRequestQueue(Particle→Actor 绑定)——bDeterministic 时按 UniqueID 升序排序,逐请求校验实体有效性与 bIsBindingActorSwappable,从池取 Actor 或现场 SpawnActor(碰撞覆盖为 AlwaysSpawn),经 FindAvailableComponent 找空闲 UMassBattleAgentComponent(没有则运行时 NewObject 添加)后 InitializeWithEntity,写回 FVisualizing.BindingActorPtr,并按 FAgentEvent 配置把 FPoolData(PoolSpawn) 推入 MB->OnPoolQueue;③ 排空 ActorRecycleQueue(Actor→Particle)——同样确定性排序,DeinitializeFromEntity 解绑组件,全部组件解绑(IsActorFullyRecyclable)才隐藏并 ReturnActorToPool,清空绑定指针;④ SweepLocalVisuals() 每 tick 本地视觉清理。

Per-logic-frame tick entry (called by UMassBattleSubsystem::ExecuteTick before the simulation stages). Flow: ① ProcessDeferredSpawnRequests() processes deferred spawns in batch; ② drains ActorSpawnRequestQueue (Particle→Actor binding) — sorted ascending by UniqueID when bDeterministic; per request it validates the entity and bIsBindingActorSwappable, takes an actor from the pool or spawns one (collision override AlwaysSpawn), finds a free UMassBattleAgentComponent via FindAvailableComponent (NewObject + RegisterComponent at runtime if none exists) and calls InitializeWithEntity, writes back FVisualizing.BindingActorPtr, and pushes FPoolData(PoolSpawn) into MB->OnPoolQueue per FAgentEvent config; ③ drains ActorRecycleQueue (Actor→Particle) — same deterministic sort, unbinds via DeinitializeFromEntity, hides and returns the actor to the pool only when all components are unbound (IsActorFullyRecyclable), then clears the binding pointers; ④ SweepLocalVisuals() for per-tick local visual cleanup.

静态访问器:从任意世界上下文对象解析出 UWorld,再取其 Agent 子系统。世界无效时返回 nullptr(不崩溃)。

Static accessor: resolves the UWorld from any world-context object and returns its Agent subsystem. Returns nullptr if the world is invalid (does not crash).

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

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

惰性访问并缓存 UMassAPISubsystem:命中缓存直接返回;否则从当前世界取子系统并写入 MassAPISubsystem / CurrentWorld 缓存。声明为 const,经 mutable 缓存成员实现。

Lazily accesses and caches UMassAPISubsystem: returns the cache on hit; otherwise fetches the subsystem from the current world and fills the MassAPISubsystem / CurrentWorld cache. Declared const, implemented via the mutable cache members.

惰性访问并缓存 UMassBattleSubsystem(全局 UID 游标、确定性开关、池事件队列的宿主)。

Lazily accesses and caches UMassBattleSubsystem (home of the global UID cursor, the determinism switch, and the pool event queue).

惰性访问并缓存 UMassBattleHashGridSubsystem(空间哈希网格)。注意:在 Initialize 中未预热此缓存,首次使用才填充。

Lazily accesses and caches UMassBattleHashGridSubsystem (spatial hash grid). Note: this cache is NOT warmed in Initialize; it is filled on first use.

把 agent 实体的 UID→句柄映射写入 UMassBattleSubsystem 的全局 UID 注册表。守卫:UID 为负直接返回;句柄经 MA->IsValid 校验,无效返回;最后 MB->RegisterUIDEntity 双写。由 UMassBattleAgentComponent 在实体句柄重绑路径调用(MassBattleAgentComponent.cpp:934)。

Writes the agent entity's UID→handle mapping into UMassBattleSubsystem's global UID registry. Guarded: negative UID returns immediately; the handle is validated with MA->IsValid; finally MB->RegisterUIDEntity dual-writes the mapping. Called from UMassBattleAgentComponent's entity re-bind path (MassBattleAgentComponent.cpp:934).

从按类分组的 Actor 池取一个 Actor:池中弹出一个(后进先出),池空返回 nullptr。仅限游戏线程调用(头文件注释)。

Pops an actor from the class-keyed actor pool (LIFO); returns nullptr when the pool is empty. Game-thread only (header comment).

把 Actor 归还到按类分组的池(FindOrAdd 保证键存在后追加)。无效 Actor 直接忽略。仅限游戏线程调用。

Returns an actor to the class-keyed pool (appends after FindOrAdd guarantees the key exists). Invalid actors are ignored. Game-thread only.

用给定种子重新初始化 RandomStream。实现即 RandomStream.Initialize(NewSeed),影响后续所有使用该流的随机(生成点洗牌、每实体乘数等)。

Re-initializes RandomStream with the given seed. Implementation is simply RandomStream.Initialize(NewSeed); affects all subsequent randomness using that stream (spawn-point shuffling, per-agent multipliers, etc.).

从 agent 配置 DataAsset 构建 FEntityTemplateData 模板。流程:① 取 DataAsset->ExtraData 经 UMassBattleFuncLib::Conv_BattleTemplateToEntityTemplate 转为基础模板;② 追加 FAgentTag、FMainType(Agent)、Agent/AI 两个 flag,以及 DataAsset 上的全部配置 fragment(Health/HealthBar/Damage/Debuff/Defence/Behavior/Move/Controller/Chase/Patrol/Navigation/Avoidance/Appear/Trace/Attack/Hit/Death/Visualize/TextPop/Statistics/Gather/Reinforce/Select/Event 等)与共享 fragment(FTrafficShared/FPhysicsShared/FAnimShared/FLODShared/FCurveShared/FTracingShared,共享 fragment 的 DeterministicHash 用 DataAsset 路径 hash 覆写);③ LoadAndRegisterAssets 预注册全部可达资源并把 DataAsset 本身记入 RegisteredAgentConfigDataAssetPtrs(防 GC);④ 网络模式下追加 FNetworking.Key = DataAsset 路径名 + FNetworkTag,并经 RegisterNetworkTemplateData 幂等注册进快照注册表。无效 DataAsset 打 Warning 并返回空模板。

Builds an FEntityTemplateData from an agent config DataAsset. Flow: ① converts DataAsset->ExtraData into a base template via UMassBattleFuncLib::Conv_BattleTemplateToEntityTemplate; ② adds FAgentTag, FMainType(Agent), the Agent/AI flags, plus every config fragment from the DataAsset (Health/HealthBar/Damage/Debuff/Defence/Behavior/Move/Controller/Chase/Patrol/Navigation/Avoidance/Appear/Trace/Attack/Hit/Death/Visualize/TextPop/Statistics/Gather/Reinforce/Select/Event, etc.) and shared fragments (FTrafficShared/FPhysicsShared/FAnimShared/FLODShared/FCurveShared/FTracingShared, with DeterministicHash overwritten by the DataAsset path hash); ③ LoadAndRegisterAssets pre-registers all reachable assets and records the DataAsset itself in RegisteredAgentConfigDataAssetPtrs (GC rooting); ④ in networked mode adds FNetworking.Key = DataAsset path name + FNetworkTag and idempotently registers the template into the snapshot registry via RegisterNetworkTemplateData. An invalid DataAsset logs a Warning and returns an empty template.

在矩形区域内按模板生成 agent(同步版)。流程:① 网格点生成——Region 与 Spacing 均 > 0 时按 ShapeDirection 定向生成居中网格(数量 = Floor(Region/Spacing)),否则生成 Quantity 个原点位置(由 Offset 后续散布);② 点验证——GroundObjectTypes/ObstacleObjectTypes 全空则全部点直接有效(可悬空);否则按高度范围向下 LineTraceMultiByObjectType,障碍命中或地面法线 Z < MaxSlope 余弦阈值即无效,地面命中取 ImpactPoint;③ 选点——Quantity=-1 或超出可用点数时全部采用;Sequential 取前 N 个,Random 用 RandomStream 洗牌取 N;④ Offset > 0 时加随机 XY 偏移并重测地面/障碍;⑤ 汇入 SpawnAgentsAtLocations_Internal 实际生成。

Spawns agents from a template within a rectangular region (synchronous). Flow: ① grid point generation — when both Region and Spacing are > 0, a centered grid oriented by ShapeDirection is produced (count = Floor(Region/Spacing)); otherwise Quantity points at the origin are produced (spread later by Offset); ② point validation — with both GroundObjectTypes/ObstacleObjectTypes empty all points are valid as-is (may float); otherwise a downward LineTraceMultiByObjectType over the height range runs, obstacle hits or ground normals below the MaxSlope cosine threshold invalidate a point, and ground hits yield the ImpactPoint; ③ point selection — Quantity=-1 (or exceeding available points) takes all; Sequential takes the first N; Random shuffles with RandomStream and takes N; ④ with Offset > 0, random XY offsets are applied and the ground/obstacle trace re-runs; ⑤ funnels into SpawnAgentsAtLocations_Internal for the actual spawn.

在圆形/多边形区域按模板生成 agent(同步版)。与矩形版本同构,差异在点生成:极坐标网格(Spacing.X = 切向弧长、Spacing.Y = 径向环距,从 InnerRadius 到 OuterRadius 布环;全圆 360° 不含端点、扇区含端点)或随机散布(数量 = Quantity×2,默认 1000,面积加权半径);Segments < 3 或 > 32 视为圆,否则按边数计算外接半径与扇形校验;多边形点超出外接半径即跳过;验证/选点/偏移与矩形版本相同。

Spawns agents from a template within a circular/polygonal region (synchronous). Isomorphic to the rectangular version; the difference is point generation: a polar grid (Spacing.X = tangential arc length, Spacing.Y = radial ring spacing, rings from InnerRadius to OuterRadius; full circles exclude the endpoint, sectors include both) or random scatter (Quantity×2 points, 1000 by default, area-weighted radius); Segments < 3 or > 32 is treated as a circle, otherwise the circumradius and sector check use the segment count; polygon points beyond the max radius are skipped; validation / selection / offset match the rectangular version.

矩形区域按 DataAsset 生成 agent 的便捷入口:先 MakeAgentTemplateDataFromDataAsset 建模板,再委托 SpawnAgentsByTemplateRectangular。DataAsset 无效时返回空数组。

Convenience entry for rectangular spawning from a DataAsset: builds the template via MakeAgentTemplateDataFromDataAsset, then delegates to SpawnAgentsByTemplateRectangular. Returns an empty array when the DataAsset is invalid.

圆形/多边形区域按 DataAsset 生成 agent 的便捷入口:建模板后委托 SpawnAgentsByTemplateCircular。DataAsset 无效时返回空数组。

Convenience entry for circular/polygon spawning from a DataAsset: builds the template, then delegates to SpawnAgentsByTemplateCircular. Returns an empty array when the DataAsset is invalid.

矩形区域按模板生成 agent 的延迟版:与同步版共享点生成逻辑,但不做地面/障碍验证(验证推迟到 ProcessDeferredSpawnRequests 内并行执行,保留全部候选点以支持失败重试),按 PositioningMode 洗牌后经 SpawnAgentsAtLocations_Internal(bDeferred=true)入队。Substeps > 0 时生成分摊到 (Substeps + 1) 个 tick,且首 tick 跳过(bFirstTickPending);全部完成后触发 OnFinished 委托。

The deferred rectangular-template spawn: shares the point-generation logic with the synchronous version, but skips ground/obstacle validation here (validation happens in parallel inside ProcessDeferredSpawnRequests; all candidate points are kept for retry), shuffles per PositioningMode, and enqueues via SpawnAgentsAtLocations_Internal (bDeferred=true). With Substeps > 0 spawns spread across (Substeps + 1) ticks and the first tick is skipped (bFirstTickPending); OnFinished fires when everything completes.

圆形/多边形区域按模板生成 agent 的延迟版:点生成与同步版一致(极坐标网格或随机散布),不做验证直接入队,其余行为与 SpawnAgentsByTemplateRectangularDeferred 相同。

The deferred circular/polygon-template spawn: point generation matches the synchronous version (polar grid or random scatter); no validation here, enqueued directly; otherwise behaves like SpawnAgentsByTemplateRectangularDeferred.

矩形区域按 DataAsset 延迟生成:建模板后委托 SpawnAgentsByTemplateRectangularDeferred。DataAsset 无效时直接返回。

Deferred rectangular spawn from a DataAsset: builds the template, then delegates to SpawnAgentsByTemplateRectangularDeferred. Returns immediately when the DataAsset is invalid.

圆形/多边形区域按 DataAsset 延迟生成:建模板后委托 SpawnAgentsByTemplateCircularDeferred。DataAsset 无效时直接返回。

Deferred circular/polygon spawn from a DataAsset: builds the template, then delegates to SpawnAgentsByTemplateCircularDeferred. Returns immediately when the DataAsset is invalid.

激活/停用单个 agent:仅设置/清除 Activated flag,不做 tag 操作(避免昂贵的 archetype 迁移);激活时额外调用 SyncAgentTagsAndController 同步子类型/队伍标签与控制器状态。无效句柄静默返回。

Activates/deactivates a single agent: only sets/clears the Activated flag — no tag operations (avoiding expensive archetype migration); on activation it also calls SyncAgentTagsAndController to sync subtype/team tags and controller state. Invalid handles return silently.

批量激活/停用:对数组内每个有效句柄执行与 ActivateAgent 相同的逻辑。

Batch activate/deactivate: runs the same logic as ActivateAgent for every valid handle in the array.

从当前 fragment 值同步 agent 的 SubType/Team tag 与控制器状态:① SubType.Index ≠ PreviousIndex 时移除旧 tag、添加新 tag 并更新 PreviousIndex;② Team.index ≠ PreviousIndex 时同理(索引 ≥ 0 才操作);③ Controlling.PreviousControlMode = Controller.ControlMode。使用直接(非延迟)tag 变更——在手动初始化或激活后调用,确保下一处理器 tick 前 tag 正确;头文件注释明确「不要每帧调用」。PlayerDrivenFlag 不在此处同步(由 SetAgentControlMode / AddAgentMovementInput / ReactionProcessor 设置)。

Syncs the agent's SubType/Team tags and controller state from current fragment values: ① when SubType.Index ≠ PreviousIndex, removes the old tag, adds the new one, and updates PreviousIndex; ② likewise for Team.index ≠ PreviousIndex (only when the index ≥ 0); ③ Controlling.PreviousControlMode = Controller.ControlMode. Uses direct (non-deferred) tag mutations — call after manual init or activation so tags are correct before the next processor tick; the header comment says "do not call per-frame". PlayerDrivenFlag is not synced here (set by SetAgentControlMode / AddAgentMovementInput / ReactionProcessor).

端侧本地 select(网络模式下锁步外,即时反馈):设置本地 Selected/BeingSelect flag,并按 FSelect.SpawnOnSelected / SpawnOnBeingSelect 配置生成本地视觉宿主(经 Host 子系统 SpawnActorHost/SpawnFxHost/SpawnSoundHost)。流程:去重 pass → Phase 1(并行,数量达阈值时)过滤(有效性、Query 匹配、FSelect.bEnable、flag 未设置)并设置 flag、提取位置/旋转 → Phase 2(串行)逐 agent 生成宿主、写入 FBeingSelect 状态数组,网络模式下把非 FNetworkTag 的本地宿主登记进 LocalVisualRegistry(键 = agent UID,镜像 flag 位)。锁步命令路径调用(ExecuteNetCommand)仍生成同步宿主(FNetworkTag),被 HasTag 检查排除在登记表外。

Peer-local select (off-lockstep in networked mode — instant feedback): sets the local Selected/BeingSelect flags and spawns local visual hosts per the FSelect.SpawnOnSelected / SpawnOnBeingSelect config (via the host subsystem's SpawnActorHost/SpawnFxHost/SpawnSoundHost). Flow: dedup pass → Phase 1 (parallel when count reaches the threshold) filters (validity, query match, FSelect.bEnable, flag not already set), sets the flag, extracts position/rotation → Phase 2 (serial) spawns hosts per agent, writes them into the FBeingSelect state arrays, and in networked mode registers non-FNetworkTag local hosts into LocalVisualRegistry (keyed by agent UID, mirroring the flag bits). Lockstep-command-path calls (ExecuteNetCommand) still produce synchronized hosts (FNetworkTag), excluded from the registry by the HasTag check.

端侧本地 deselect(锁步外):清除本地 select flag,并经 FBeingSelect fragment 数组销毁本地视觉宿主——DestroyStateData lambda 对每个仍有效的 Actor/Fx/Sound 宿主置 bShouldDestroy = true(走 HostMonoProcessor 销毁管线)后 Reset() 数组。流程:去重 pass → 并行(阈值)或串行处理(清 flag + 销毁宿主)→ 末尾串行 pass(仅网络模式)把清除位镜像进 LocalVisualRegistry,空登记项移除。锁步路径宿主(FNetworkTag)不在此处理,由各自的确定性命令路径销毁。

Peer-local deselect (off-lockstep): clears the local select flags and destroys the local visual hosts via the FBeingSelect fragment arrays — the DestroyStateData lambda sets bShouldDestroy = true on every still-valid Actor/Fx/Sound host (routing through the HostMonoProcessor destroy pipeline) then Reset()s the arrays. Flow: dedup pass → parallel (threshold) or serial processing (clear flags + destroy hosts) → final serial pass (networked mode only) mirrors the cleared bits into LocalVisualRegistry, removing empty entries. Lockstep-path hosts (FNetworkTag) are untouched here and destroyed via their deterministic command path.

把每个本地视觉宿主重挂到最新快照 resync 重建的 agent 上(每次 resync 由 UMassBattleNetworkSubsystem::ProcessDeferredSnapshot 调用一次,在组件 RebindToEntity pass 之后)。流程:逐登记项——agent 已消失则 DestroyEntryHosts 销毁其宿主并移除登记项;否则对三类数据(Actor/Fx/Sound × BeingSelect/Selected/AttachedVisuals)逐一重链:经 IsHostOwnedByUID 判定归属(已销毁/回收/复用的剔除),重指向 FHostHierarchy.AttachmentEntity(仅 ExternalEntity 源)与 config 的 AttachToEntity(FX 的 PairedFxEntity 父级经 FFxVisualizing.ParentEntity 跟随;注释强调 InitialRelativeTransform 是固定偏移,勿重算以免视觉跳变);然后重放本地 select flag(SnapshotStrippedRenderFlagsMask 已从恢复中剥离);最后把 Selected/BeingSelect 宿主数组镜像回 FBeingSelect fragment(重建 agent 的数组为空,写回使 DeselectAgents 的 DestroyStateData 恰好销毁这些宿主;AttachedVisuals 不镜像)。非网络模式下为空操作(登记表恒空)。

Re-attaches every local visual host to the agent rebuilt by the latest snapshot resync (called once per resync from UMassBattleNetworkSubsystem::ProcessDeferredSnapshot, after the component RebindToEntity pass). Flow: per entry — if the agent is gone, DestroyEntryHosts destroys its hosts and the entry is removed; otherwise all three data groups (Actor/Fx/Sound × BeingSelect/Selected/AttachedVisuals) are re-linked: ownership is probed via IsHostOwnedByUID (destroyed/recycled/reused hosts are dropped), FHostHierarchy.AttachmentEntity (ExternalEntity sources only) and the config AttachToEntity are re-pointed (an FX's PairedFxEntity parent follows via FFxVisualizing.ParentEntity; the comment stresses InitialRelativeTransform is a fixed offset — do NOT recompute, to avoid visual snapping); the peer-local select flags are then replayed (stripped from the restore by SnapshotStrippedRenderFlagsMask); finally the Selected/BeingSelect host arrays are mirrored back into the FBeingSelect fragment (the rebuilt agent's arrays are empty; the write-back makes DeselectAgents' DestroyStateData destroy exactly these hosts; AttachedVisuals is NOT mirrored). No-op in non-networked mode (registry stays empty).

每 tick 清理(由 ExecuteTick 末尾调用):移除 agent 已消失的登记项(先 DestroyEntryHosts 销毁其宿主)与已被销毁/回收/复用的宿主(逐数组经 IsHostOwnedByUID 剔除);空登记项移除。兜底 resync 钩子被跳过的路径(快照 apply 失败)。仅限游戏线程。

Per-tick cleanup (called at the end of ExecuteTick): removes entries whose agent is gone (destroying their hosts via DestroyEntryHosts first) and hosts that were destroyed/recycled/reused (pruned per array via IsHostOwnedByUID); empty entries are removed. Catches the paths where the resync hook was skipped (failed snapshot apply). Game-thread only.

按 EQS 查询结果生成 agent(异步,蓝图 latent 节点):校验失败(子系统/模板/Query/Querier 缺失或 Quantity ≤ 0)时 Branches = Invalid 并返回;否则 LoadAndRegisterAssets 预注册资源,以自增 EQSRequestIDCounter 存入 PendingEQSRequests,经 UEnvQueryManager::RunQuery(AllMatching) 发起查询并绑定 OnEQSQueryFinished;同时为蓝图挂一个空的 FMassPendingLatentAction 使节点保持挂起;查询返回后把请求从 RequestID 键改为 QueryID 键。成功发起后 Branches = Valid。生成本身在 OnEQSQueryFinished 回调中完成。

Spawns agents from EQS query results (async, Blueprint latent node): on validation failure (missing subsystems/template/Query/Querier or Quantity ≤ 0) sets Branches = Invalid and returns; otherwise calls LoadAndRegisterAssets, stores the request in PendingEQSRequests under an incrementing EQSRequestIDCounter, issues the query via UEnvQueryManager::RunQuery(AllMatching) bound to OnEQSQueryFinished, and attaches a no-op FMassPendingLatentAction so the Blueprint node stays pending; after the query returns, the request is re-keyed from the RequestID to the QueryID. On successful issue, Branches = Valid. The actual spawning happens in the OnEQSQueryFinished callback.

按 EQS 查询结果从 DataAsset 生成 agent:DataAsset 无效时 Branches = Invalid 并返回;否则建模板后委托 SpawnAgentsByTemplateEQS(Branches 由后者写入)。

Spawns agents from a DataAsset using EQS query results: an invalid DataAsset sets Branches = Invalid and returns; otherwise it builds the template and delegates to SpawnAgentsByTemplateEQS (which writes Branches).

读取 agent 的控制模式:实体带 FAgentController 时返回其 ControlMode;否则回退为按 PlayerDrivenFlag 判定(带 = PlayerDriven,否则 AI)。无效句柄返回 AI。

Reads an agent's control mode: returns FAgentController::ControlMode when the fragment exists; otherwise falls back to the PlayerDrivenFlag (set → PlayerDriven, else AI). Invalid handles return AI.

设置 agent 控制模式。切到 PlayerDriven:写 FAgentController.ControlMode、设置 PlayerDrivenFlag、FMoving.bMoveToLocked = true、bMovingToGoal = true;切回 AI:清 flag、bMoveToLocked = bMovingToGoal = false、清零 PendingInputVector/DesiredVelocity、MoveState = None(让 AI 从干净状态重新开始)。缺 FMoving/FAgentController 或句柄无效时返回。

Sets an agent's control mode. To PlayerDriven: writes FAgentController.ControlMode, sets the PlayerDrivenFlag, FMoving.bMoveToLocked = true, bMovingToGoal = true; back to AI: clears the flag, bMoveToLocked = bMovingToGoal = false, zeroes PendingInputVector/DesiredVelocity, MoveState = None (so AI restarts from a clean state). Returns when FMoving/FAgentController are missing or the handle is invalid.

给 agent 添加移动输入(对应 APawn::Internal_AddMovementInput):bMoveInputIgnored 且非强制时丢弃;否则直接设置 PendingInputVector = WorldDirection × Scale(调用者传入完整合并输入)、bMoveToLocked = bMovingToGoal = true,并把 FAgentController.ControlMode 置为 PlayerDriven、设置 PlayerDrivenFlag。

Adds movement input to an agent (mirrors APawn::Internal_AddMovementInput): discarded when bMoveInputIgnored and not forced; otherwise directly sets PendingInputVector = WorldDirection × Scale (the caller passes the full combined input), bMoveToLocked = bMovingToGoal = true, sets FAgentController.ControlMode to PlayerDriven and the PlayerDrivenFlag.

停止一批 agent 的全部移动:逐实体清零 CurrentVelocity/DesiredVelocity,bMovingToGoal = false、MoveState = None、ActiveMoveToTaskID = 0、bMoveToLocked = bMoveToSuspended = false;清除 FNavigating 的 RequestedNavMode 与 PathPoints;清除 AStarMovingTo 与 BPTask_MoveTo 两个 flag。无效句柄跳过。

Stops all movement for a batch of agents: per entity, zeroes CurrentVelocity/DesiredVelocity, sets bMovingToGoal = false, MoveState = None, ActiveMoveToTaskID = 0, bMoveToLocked = bMoveToSuspended = false; clears FNavigating's RequestedNavMode and PathPoints; clears the AStarMovingTo and BPTask_MoveTo flags. Invalid handles are skipped.

请求一批 agent 停止当前主动移动:对每个有效实体置 FMove.XY.bStopActiveMovement = true(由移动处理器消费该一次性请求)。

Requests a batch of agents to stop their current active movement: sets FMove.XY.bStopActiveMovement = true on each valid entity (a one-shot request consumed by the movement processor).

切换单个 agent 的行为状态。守卫:句柄/必需 fragment 缺失、Dying/PendingDestroy、bMoveToLocked 且目标非 Idle 时返回 false;目标行为对应的配置 fragment bEnable 为假或为不支持的状态(如 Return——被动反馈,非行为)时降级为 Idle。成功时:写 FBehaving.ActiveBehavior/RequestedBehavior,清除全部行为 flag 与 FAppearingTag,重置 FAppearing/FPatrolling/FAttacking/FReinforcing/FReturning,按目标行为设置对应 flag(Appear 额外设 Dissolve 并加 FAppearingTag;Chase 设 bMovingToGoal = true),最后 FNavigating.TimeLeft = 0。

Switches a single agent's behavior state. Guards: returns false on invalid handle / missing required fragments, Dying/PendingDestroy flags, or bMoveToLocked with a non-Idle target; targets whose config fragment bEnable is false, or unsupported states (e.g. Return — a passive feedback, not a behavior), degrade to Idle. On success: writes FBehaving.ActiveBehavior/RequestedBehavior, clears all behavior flags and FAppearingTag, resets FAppearing/FPatrolling/FAttacking/FReinforcing/FReturning, sets the flag for the target behavior (Appear also sets Dissolve and adds FAppearingTag; Chase sets bMovingToGoal = true), then FNavigating.TimeLeft = 0.

设置实体的事件接收 Actor:agent(FAgentTag)写 FAgentEvent.EventReceiveSoftActor;projectile(FProjectileTag)写 FProjectileEvent.EventReceiveSoftActor;其它实体类型或无效句柄忽略。

Sets an entity's event receiver actor: agents (FAgentTag) write FAgentEvent.EventReceiveSoftActor; projectiles (FProjectileTag) write FProjectileEvent.EventReceiveSoftActor; other entity types or invalid handles are ignored.

设置实体使用的流场:写 FNavigation.FlowFieldToUse 后调用 UMassBattleSubsystem::ResolveAgentRuntimeObjectPtrs 解析运行时指针(同步到 FNavigating.FlowFieldToUsePtr)。

Sets the flow field an entity uses: writes FNavigation.FlowFieldToUse, then calls UMassBattleSubsystem::ResolveAgentRuntimeObjectPtrs to resolve runtime pointers (syncing FNavigating.FlowFieldToUsePtr).

设置 agent 角速度:写 FMoving.CurrentAngularVelocity。无效句柄/缺 fragment 忽略。

Sets an agent's angular velocity: writes FMoving.CurrentAngularVelocity. Invalid handles / missing fragments are ignored.

设置 agent 线速度:写 FMoving.CurrentVelocity(FVector3f)。无效句柄/缺 fragment 忽略。

Sets an agent's linear velocity: writes FMoving.CurrentVelocity (FVector3f). Invalid handles / missing fragments are ignored.

设置 agent 缩放:写 FScaling.Scale。无效句柄/缺 fragment 忽略。

Sets an agent's scale: writes FScaling.Scale. Invalid handles / missing fragments are ignored.

设置 agent 旋转:写 FRotating.Rotation、RotationQuat(由 NewRotation.Quaternion() 转换)与 Direction(四元数前向)。无效句柄/缺 fragment 忽略。

Sets an agent's rotation: writes FRotating.Rotation, RotationQuat (from NewRotation.Quaternion()) and Direction (quaternion forward). Invalid handles / missing fragments are ignored.

设置 agent 位置:写 FLocating.Location。无效句柄/缺 fragment 忽略。

Sets an agent's location: writes FLocating.Location. Invalid handles / missing fragments are ignored.

读取 agent 线速度(FMoving.CurrentVelocity)。无效句柄/缺 fragment 返回 FVector::ZeroVector。

Reads an agent's linear velocity (FMoving.CurrentVelocity). Returns FVector::ZeroVector for invalid handles / missing fragments.

读取 agent 右向量(FRotating.RotationQuat.GetRightVector())。失败返回 FVector::RightVector。

Reads an agent's right vector (FRotating.RotationQuat.GetRightVector()). Returns FVector::RightVector on failure.

读取 agent 上向量(FRotating.RotationQuat.GetUpVector())。失败返回 FVector::UpVector。

Reads an agent's up vector (FRotating.RotationQuat.GetUpVector()). Returns FVector::UpVector on failure.

读取 agent 前向向量(FRotating.Direction)。失败返回 FVector::ForwardVector。

Reads an agent's forward vector (FRotating.Direction). Returns FVector::ForwardVector on failure.

读取 agent 变换:由 FRotating.RotationQuat、FLocating.Location、FScaling.Scale 组装 FTransform。三个 fragment 任一缺失或句柄无效返回 FTransform::Identity。

Reads an agent's transform: assembled from FRotating.RotationQuat, FLocating.Location, and FScaling.Scale. Returns FTransform::Identity when any fragment is missing or the handle is invalid.

读取 agent 缩放三件套:先全部初始化为默认值(1.f / OneVector / OneVector),再写 FScaling.Scale 与 JiggleMultiplier;渲染缩放取自 FVisualize.Transform 的 Scale3D(非 agent 实体无 FVisualize 时回退为均匀 FVector(Scale))。

Reads an agent's scale triple: initializes all outputs to defaults first (1.f / OneVector / OneVector), then writes FScaling.Scale and JiggleMultiplier; the render scale comes from FVisualize.Transform's Scale3D (falling back to uniform FVector(Scale) for non-agent entities without FVisualize).

读取 agent 旋转三件套:先全部初始化为默认值(ZeroRotator / Identity / ForwardVector),再写 FRotating.Rotation、RotationQuat 与 Direction。

Reads an agent's rotation triple: initializes all outputs to defaults first (ZeroRotator / Identity / ForwardVector), then writes FRotating.Rotation, RotationQuat, and Direction.

计算一批 agent 的平均位置:累加有效实体的 FLocating.Location 后除以有效数量(double 除法)。空数组、MA 缺失或全部无效返回 FVector::ZeroVector。

Computes the average location of a batch of agents: sums the FLocating.Location of valid entities and divides by the valid count (double division). Returns FVector::ZeroVector for an empty array, missing MA, or all-invalid input.

读取 agent 位置三件套:先全部初始化为零,再写 FLocating.Location、PreLocation 与 InitialLocation。

Reads an agent's location triple: initializes all outputs to zero first, then writes FLocating.Location, PreLocation, and InitialLocation.

生成战利品宿主:组装 FLootConfig_Final(bEnable=true、LootConfigDataAsset、Multipliers.Ballistic、SpawnTransform、OwnerEntity=Spawner、FromPoint=生成点、Delay=0)后经 UMassBattleHostSubsystem::SpawnLootHost 生成。网络模式下锁步外调用被 [RULE7] 拦截(打 Error 并返回);确定性命令路径(ExecuteNetCommand)放行。DataAsset 或 MB 缺失时返回。

Spawns a loot host: assembles an FLootConfig_Final (bEnable=true, LootConfigDataAsset, Multipliers.Ballistic, SpawnTransform, OwnerEntity=Spawner, FromPoint=spawn point, Delay=0) and spawns via UMassBattleHostSubsystem::SpawnLootHost. Off-lockstep calls in networked mode are blocked by [RULE7] (logs an Error and returns); deterministic command-path calls (ExecuteNetCommand) pass. Returns when the DataAsset or MB is missing.

在世界位置生成合批 FX:校验 FxConfig.bEnable 与至少一个资源(SoftNiagara/SoftCascade/SubType_Index)后,组装 FFxConfig_Final,SpawnTransform = LocalOffsetToWorld(世界位置 + 本地偏移),InitialRelativeTransform 相对附着实体(有效时)或基础生成变换计算,经 SpawnFxHost 生成。自动分流:锁步命令窗口 → 同步版;锁步外(BP 直调)→ 纯表现版(FX/Sound 永不破坏确定性)。网络模式下,附着且无 FNetworkTag 的本地宿主登记进 LocalVisualRegistry(键 = 父实体 UID,AttachedVisuals.FxHostEntities);不附着的即抛 FX 无需登记。

Spawns a batched FX at a world location: after validating FxConfig.bEnable and at least one asset (SoftNiagara/SoftCascade/SubType_Index), it assembles an FFxConfig_Final, computes SpawnTransform = LocalOffsetToWorld (world location + local offset), computes InitialRelativeTransform relative to the attach entity (when valid) or the base spawn transform, and spawns via SpawnFxHost. Auto-split: lockstep command window → synchronized version; off-lockstep (direct BP call) → local-only version (FX/Sound never corrupt determinism). In networked mode, attached local hosts without FNetworkTag are registered into LocalVisualRegistry (keyed by the parent entity's UID, AttachedVisuals.FxHostEntities); unattached one-shot FX needs no registration.

播放动画 montage(模拟侧驱动):AnimIndex == INVALID_ANIM_INDEX(255) 且实体带 FDeterminism 时,从 FAnimShared.AnimData.OtherAnimData 用 FDeterminism.RandomStream 随机选槽——模拟侧消耗 RNG,进入 SYNC(FAnimating) 快照,绝不落在渲染阶段(自 RenderProcessor 迁移);随后写 SelectedMontageAnimIndex(Clamp 0..255)、MontagePlayRate、bMontageLooping,置 AnimState = Montage、bUpdateAnimState = true。

Plays an animation montage (sim-side driven): when AnimIndex == INVALID_ANIM_INDEX (255) and the entity has FDeterminism, a slot is randomly picked from FAnimShared.AnimData.OtherAnimData using FDeterminism.RandomStream — the RNG draw happens on the sim side so it enters the SYNC(FAnimating) snapshot and never runs in the render pass (migrated from RenderProcessor); then it writes SelectedMontageAnimIndex (Clamped 0..255), MontagePlayRate, bMontageLooping, sets AnimState = Montage, bUpdateAnimState = true.

把 Cascade 粒子系统附着到实体:组装 FFxConfig_Final(bAttached=true、CascadeAsset、AttachToEntity、InitialRelativeTransform=相对变换)后经 SpawnFxHost 生成。自动分流:锁步窗口 → 同步版;锁步外 → 纯表现版。网络模式下附着本地宿主登记 LocalVisualRegistry(同 SpawnBatchedFx 机制)。资源无效返回。

Attaches a Cascade particle system to an entity: assembles an FFxConfig_Final (bAttached=true, CascadeAsset, AttachToEntity, InitialRelativeTransform=relative transform) and spawns via SpawnFxHost. Auto-split: lockstep window → synchronized version; off-lockstep → local-only version. In networked mode, attached local hosts are registered in LocalVisualRegistry (same mechanism as SpawnBatchedFx). Returns when the asset is invalid.

把 Niagara 系统附着到实体:与 AttachCascadeToAgent 完全同构,仅资源类型为 UNiagaraSystem(写 FFxConfig_Final.NiagaraAsset)。

Attaches a Niagara system to an entity: fully isomorphic to AttachCascadeToAgent, except the asset type is UNiagaraSystem (written to FFxConfig_Final.NiagaraAsset).

把现有 Actor 作为宿主附着到实体:组装 FActorSpawnConfig_Final(bAttached=true、bSpawned=true——把现有 Actor 视为已生成、SpawnedActor=ActorToAttach、AttachToEntity、InitialRelativeTransform)后经 SpawnActorHost 生成。锁步外生成天然安全(四元分流分配 UID=-1、跳过 FNetworkTag),网络模式下附着本地宿主登记 LocalVisualRegistry。资源无效返回。

Attaches an existing actor to an entity as a host: assembles an FActorSpawnConfig_Final (bAttached=true, bSpawned=true — treating the existing actor as already spawned, SpawnedActor=ActorToAttach, AttachToEntity, InitialRelativeTransform) and spawns via SpawnActorHost. Off-lockstep spawning is safe by design (the four-way split allocates UID=-1 and skips FNetworkTag); in networked mode, attached local hosts are registered in LocalVisualRegistry. Returns when the actor is invalid.

把 agent 实体作为宿主附着到另一实体:组装 FAgentHostConfig_Final(bAttached=true、Transform=相对变换、AgentToAttach、AttachToEntity)后经 SpawnAgentHost 生成。[RULE7 保留]——agent host 是模拟实体(折叠进逐实体 hash),挂接关系是锁步状态,网络模式下锁步外调用被拦截(打 Error 并返回);仅限锁步命令路径(ExecuteNetCommand)。与纯视觉的 FX/actor/sound 宿主形成对比(后者有安全的本地路径)。

Attaches an agent entity to another entity as a host: assembles an FAgentHostConfig_Final (bAttached=true, Transform=relative transform, AgentToAttach, AttachToEntity) and spawns via SpawnAgentHost. [RULE7 retained] — agent hosts are simulation entities (folded into the per-entity hash), so the attach relationship is lockstep state; off-lockstep calls in networked mode are blocked (logs an Error and returns); lockstep command path only (ExecuteNetCommand). In contrast to purely-visual FX/actor/sound hosts (which have a safe local-only path).

全部 public agent 生成 API(矩形/圆形/EQS/deferred)的唯一汇聚点。入口守卫:网络模式下锁步外直接打 [RULE7] Error 并返回空(命令路径外的 BP/C++ 调用会在单端消耗全局 UID);模板无效/为空或位置列表为空返回空。bDeferred=true 时在 DeferredSpawnLock 下构造 FDeferredAgentSpawnRequest(含从模板 FMove 读取的 GroundTraceChannel、规范化高度范围、Substeps 钳制、bFirstTickPending)入队后返回空。非延迟路径三阶段:Phase 1 串行预计算——逐 agent 分配 UID(PreAssignedUID >= 0 时复用,否则 AllocNextUID)、用子系统 RandomStream 串行采样四组随机乘数、以 UID 派生确定性局部流,计算出生点(飞行高度或胶囊地面偏移)、出生旋转(FacePlayer 取玩家 0 / CustomRotation)、地面倾斜(FlowField 多点采样或射线多点采样,俯仰/翻滚钳制,TiltMode 区分 OnlyCollider/OnlyMesh/ColliderAndMesh)、初速度(注入 CurrentVelocity,不写 LaunchVelSum——避免触发 Launching 状态 3 秒冻结)、动画槽与随机起始帧;Phase 2 MA.BuildEntities 批量建实体;Phase 3 MBParallelFor(BackgroundPriority)并行填 fragment(确定性种子、位置/旋转/移动/巡逻原点/动画/表示/OnBirth 行为解析——flag 与 ActiveBehavior 必须同步/乘数应用),随后串行注册 UID 映射、为 Appear 实体加 FAppearingTag、ResolveAgentRuntimeObjectPtrs。

The single funnel for all public agent-spawn APIs (rectangular/circular/EQS/deferred). Entry guards: in networked mode, off-lockstep calls log a [RULE7] Error and return empty (BP/C++ calls outside the command path would consume global UIDs on one peer only); invalid/empty templates or empty location lists return empty. With bDeferred=true, an FDeferredAgentSpawnRequest is constructed under DeferredSpawnLock (GroundTraceChannel read from the template's FMove, normalized height range, clamped Substeps, bFirstTickPending) and enqueued, returning empty. The non-deferred path runs three phases: Phase 1 serial pre-compute — per agent, allocates a UID (reused when PreAssignedUID >= 0, else AllocNextUID), samples the four random multiplier ranges serially from the subsystem RandomStream, derives a deterministic local stream from the UID, and computes the spawn point (fly height or capsule ground offset), spawn rotation (FacePlayer toward player 0 / CustomRotation), ground tilt (FlowField multi-point sampling or raycast multi-point sampling, clamped pitch/roll, TiltMode distinguishing OnlyCollider/OnlyMesh/ColliderAndMesh), initial velocity (injected into CurrentVelocity, NOT LaunchVelSum — avoiding the Launching state's 3-second freeze), and animation slots with random start frames; Phase 2 batch-creates entities via MA.BuildEntities; Phase 3 fills fragments in parallel via MBParallelFor (BackgroundPriority) — deterministic seed, location/rotation/movement/patrol origin/animation/representation/OnBirth behavior resolution (flag and ActiveBehavior must stay in sync) /multiplier application — followed by serial UID registration, FAppearingTag for Appear entities, and ResolveAgentRuntimeObjectPtrs.

延迟生成请求的每 tick 批量处理(ExecuteTick 第一步调用)。流程:空队列快速返回(先于锁步守卫,避免网络模式空队列刷 Error)→ 锁步外守卫([RULE7] 拦截并打 Error)→ 加锁把请求 MoveTemp 到局部数组 → 逐请求计算本 tick 生成数(bFirstTickPending 置 false 跳过本 tick;Substeps > 0 时按剩余 tick 数向上取整均分;目标达成或位置耗尽则本 tick 为 0;全部为 0 时未完成请求重新入队并返回)→ 分配连续 UID 块、构建共享模板与碰撞查询参数 → Phase 1a 串行采样随机乘数(子系统 RandomStream,保证跨请求/索引确定性)→ Phase 1 并行(位置验证——障碍/坡度/落地,出生点/旋转/倾斜/初速度/动画计算)→ Phase 2 按请求批量 BuildEntities → Phase 3 并行填 fragment → 解析运行时指针、注册 UID 映射、加 FAppearingTag → 按请求累计有效句柄、更新进度、完成(达量或耗尽)则触发 OnFinished,未完成请求置顶重新入队。

Per-tick batch processing of deferred spawn requests (the first step of ExecuteTick). Flow: fast-exit on an empty queue (before the off-lockstep guard, so networked mode with an empty queue doesn't spam Errors) → off-lockstep guard ([RULE7] blocks with an Error) → requests are MoveTemp'd into a local array under lock → per request, the tick's spawn count is computed (bFirstTickPending clears and skips this tick; Substeps > 0 distributes evenly by remaining ticks with ceiling division; zero when the target is reached or locations are exhausted; if all are zero, unfinished requests are re-enqueued and the function returns) → a contiguous UID block is allocated, shared templates and collision query params are built → Phase 1a serially samples the random multipliers (subsystem RandomStream, deterministic across requests and indices) → Phase 1 in parallel (location validation — obstacle/slope/ground, plus spawn point/rotation/tilt/initial velocity/animation computation) → Phase 2 batch-creates entities per request via BuildEntities → Phase 3 fills fragments in parallel → runtime pointers resolve, UID mappings register, FAppearingTag is added → valid handles accumulate per request, progress updates, completed requests (target reached or exhausted) fire OnFinished, and unfinished requests are re-enqueued at the front.

EQS 查询完成回调:按 Result->QueryID 从 PendingEQSRequests 取出请求并移除;移除对应的 latent 动作(FMassPendingLatentAction);GetAllAsLocations 取位置列表,非空则经 SpawnAgentsAtLocations_Internal(非延迟、bAutoActivated=true、无委托)生成,空则打 Warning。

EQS query completion callback: looks up the request in PendingEQSRequests by Result->QueryID and removes it; removes the corresponding latent action (FMassPendingLatentAction); fetches the location list via GetAllAsLocations and, when non-empty, spawns through SpawnAgentsAtLocations_Internal (non-deferred, bAutoActivated=true, no delegate); logs a Warning when no locations are yielded.

预注册模板可达的全部资源(热循环避免 LoadSynchronous):经 MB.RegisterSpawnContentAssets 遍历 Appear/Hit/Death 的事件内容(SpawActor + SpawnFx + PlaySound),经 RegisterSpawnContentAssetsWithProjectile 处理 Attack(含 SpawnProjectile,触发子资源级联注册链),最后 InitializeAgentTemplateRuntimeObjectPtrs 初始化运行时对象指针。原仅供 EQS 路径调用,后推广到全部生成路径(源码注释)。

Pre-registers all assets reachable from the template (so the hot loop never hits LoadSynchronous): walks the event-content structs Appear/Hit/Death via MB.RegisterSpawnContentAssets (SpawnActor + SpawnFx + PlaySound), processes Attack (with SpawnProjectile) via RegisterSpawnContentAssetsWithProjectile (triggering the cascade-chain asset registration), and finally calls InitializeAgentTemplateRuntimeObjectPtrs. Originally only called from the EQS path; extended to all spawn paths (source comment).

用确定性流计算动画随机起始帧:AnimLength > 0 时在 [TimeOffset.X, TimeOffset.Y] 区间采样随机时间,乘 SampleRate 后对动画长度取模,返回 StartFrame + 偏移;长度无效时直接返回 StartFrame。

Computes a random animation start frame with a deterministic stream: when AnimLength > 0, samples a random time in [TimeOffset.X, TimeOffset.Y], multiplies by SampleRate, wraps by the animation length, and returns StartFrame + offset; returns StartFrame when the length is invalid.

在 Actor 上找第一个未绑定(Handle.Index == 0)的 UMassBattleAgentComponent;全部已绑定或 Actor 无效返回 nullptr。支持多组件 Actor。

Finds the first unbound (Handle.Index == 0) UMassBattleAgentComponent on the actor; returns nullptr when all are bound or the actor is invalid. Supports multi-component actors.

统计 Actor 上当前绑定到实体的组件数(Handle.Index != 0 即视为已绑定)。Actor 无效返回 0。

Counts the actor's components currently bound to entities (Handle.Index != 0 counts as bound). Returns 0 for an invalid actor.

判定 Actor 是否可整体回池:GetActiveComponentCount == 0(无任何活动组件绑定)。供回收队列决定「全部组件解绑才回池,否则保持可见」。

Determines whether the actor can be returned to the pool: GetActiveComponentCount == 0 (no active component bindings). Used by the recycle queue to decide "return to pool only when all components are unbound; otherwise keep visible".

归属判定:宿主 config 的 AttachToEntity 是否仍指向 UID == AgentUID 的实体。区分「仍是本 agent 的宿主」与「已回池被他方复用」(复用的句柄仍然有效,仅 IsValid 不足以判定归属)。带 FNetworkTag 的宿主(快照托管)直接返回 false;从 FFxConfig_Final / FActorSpawnConfig_Final / FSoundConfig_Final 探测归属实体(按序),最终 MB->FindUIDByEntity(Owner) == AgentUID。

Ownership probe: whether the host config's AttachToEntity still points at an entity whose UID == AgentUID. Distinguishes "still this agent's host" from "pool-recycled and reused by someone else" (recycled handles stay valid, so IsValid alone is NOT a sufficient ownership test). Hosts with FNetworkTag (snapshot-managed) return false immediately; the owning entity is probed from FFxConfig_Final / FActorSpawnConfig_Final / FSoundConfig_Final (in order), concluding with MB->FindUIDByEntity(Owner) == AgentUID.

销毁登记项下所有仍有效且仍归其所有的宿主并重置登记项:对 BeingSelectData / SelectedData / AttachedVisuals 三组的 Actor/Fx/Sound 数组逐一置 bShouldDestroy = true(走 HostMonoProcessor 既有销毁管线——UObject 释放 → 池回收,绝不用 DestroyEntity 绕过),最后 Entry.Reset()。

Destroys all still-valid hosts owned by the entry and resets it: for each of the Actor/Fx/Sound arrays in BeingSelectData / SelectedData / AttachedVisuals, sets bShouldDestroy = true (routing through HostMonoProcessor's existing destroy pipeline — UObject release → pool recycle; never bypass with DestroyEntity), then Entry.Reset().