toentityarray-snapshot-pattern

What problem does it solve?

Prevents iterator invalidation and safety exceptions when iterating entity data while performing structural changes that may alter archetypes or entity state.

Core Features & Use Cases

• Safe iterate + structurally change workflow: Snapshot entity IDs and per-entity component data into NativeArrays before making structural changes.
• Per-entity conditional initialization: Use snapshot arrays to compute and write component data safely after structural changes.
• Main-thread ECS correctness: Applies to EntityQuery/SystemAPI patterns where batch structural operations are insufficient because each entity’s condition differs.

Quick Start

Ask the AI to “Generate a Unity DOTS system that snapshots matching entities with ToEntityArray and ToComponentDataArray, performs AddComponent/RemoveComponent on the query, then initializes per-entity data in a for-loop using the snapshot arrays.”