wave5-physics-world-singleton-queries

What problem does it solve?

It solves the challenge of performing accurate runtime spatial queries in Unity DOTS by leveraging PhysicsWorldSingleton to query the current Unity Physics collision world.

Core Features & Use Cases

• Raycast and collider cast: Determine closest hits or project shapes through the world for line-of-sight and impact prediction.
• Distance and overlap queries: Find nearest bodies to a point and detect broad-phase AABB overlaps for targeting and area effects.
• Correct scheduling and safety: Ensures dependencies are completed before reading PhysicsWorldSingleton and uses appropriate allocators for query results.

Use case example: Implement ground detection by casting a ray downward every simulation tick and reacting when the closest hit intersects the desired collision layer(s).

Quick Start

In your SimulationSystemGroup update, complete dependencies before reading PhysicsWorldSingleton, then schedule a job that uses PhysicsWorldSingleton.PhysicsWorld.CollisionWorld to run CastRay or OverlapAabb with a narrowed CollisionFilter.