在虚幻引擎中用 Mass Entity ECS…

适用于使用 UE Mass Entity（ECS）进行成千上万实体模拟时的架构设计、处理器编写与性能优化。

适用场景

解决思路

1. 先读取 `.agents/ue-project-context.md`，确认 MassEntity 插件（以及 MassAI、MassCrowd、MassGameplay）是否启用、目标实体数量与性能预算、是否使用 MassCrowd 车道导航或 ZoneGraph、以及已有的 processor/fragment/trait/entity config 资产。
2. 向开发者确认：模拟的实体类型（人群、抛射物、交通、野生动物、自定义）、每个实体携带的数据（位置、速度、生命值、自定义状态）、可视化方式与 LOD 策略（ISM、骨骼、actor promotion）、是否多人（哪些实体需要复制）、峰值实体数量（数百还是数万）。
3. 按 archetype ECS 模型组织数据：Entity 用 `FMassEntityHandle`（8 字节 Index + SerialNumber）；Fragment 继承 `FMassFragment` 存每实体可变数据；Tag 继承 `FMassTag` 作零尺寸布尔标记；Shared Fragment 继承 `FMassSharedFragment` 存每 archetype 可变数据；Const Shared Fragment 继承 `FMassConstSharedFragment` 存每 archetype 不可变数据；Chunk Fragment 继承 `FMassChunkFragment` 存每内存块数据；Archetype 用 `FMassArchetypeHandle` 表示 fragment/tag 类型的唯一组合。

适用边界 · 注意事项

• 项目未启用 MassEntity 插件，或实体规模只有几十个、用普通 Actor/Component 即可满足时，不必引入 Mass Entity 的复杂度。
• 需要逐实体复杂行为树或大量 UObject 交互、且实体数量不大时，Mass Entity 的 ECS 约束与游戏线程限制会得不偿失。
• 不熟悉 archetype 内存布局与延迟命令语义时，直接在 ForEachEntityChunk 内做结构变更会导致崩溃，应先掌握 Defer 机制再上手。

经验正文