wave5-stateful-physics-event-buffers

Use a per-entity DynamicBuffer<StatefulTriggerEvent> to track overlap lifecycles across fixed simulation ticks, branching on StatefulEventState.Enter, Stay, and Exit in a Burst job. This stateful event buffer approach eliminates manual overlap history tracking for reliable trigger lifecycle detection.

Schedule your system in the FixedStepSimulationSystemGroup and order it after StatefulTriggerEventBufferSystem or StatefulCollisionEventBufferSystem. This fixed-step ordering ensures you read populated event buffers only after the physics simulation updates them for the current tick.

Apply the stateful collision event buffer pattern via DynamicBuffer<StatefulCollisionEvent> to distinguish first contact, ongoing contact, and final contact. This enables precise impact response and damage zone lifecycle management across fixed ticks for reliable landing detection in Unity DOTS.

Yes, you must add StatefulTriggerEventBufferAuthoring to your trigger-zone entities. This authoring component initializes the required DynamicBuffer for storing stateful physics events, enabling ECS gameplay logic like portal activation and pickup detection to function reliably.

Missing overlap events during fixed step updates typically occur if system ordering is incorrect or buffer processing mishandles Enter, Stay, and Exit states. Ensure your system runs after StatefulTriggerEventBufferSystem to read valid event data and safely process the physics trigger lifecycle.