Fix: Godot 4 Physics ShapeCast3D Broad Phase Fails on Many Bodies

Combat scene: 1000 NPCs; line-of-sight cast costs 10ms.

Reduce body count

Distance-cull far bodies. Active count drops; broad phase fast.

Or use spatial hashing

Custom data structure for queries; bypasses physics for simple cases.

Profile broad phase

Physics profiler shows broad phase cost. Confirm bottleneck.

“Broad phase scales with body count. Reduce count for performance.”

If your physics queries are slow, the body count is the first suspect. Audit.

Related reading

• Fix: Godot Physics Shape Cast 3D No Hit On Thin Plane
• Fix: Godot Physics Shape Cast 3D Misses Thin Walls At Extreme Distance
• Fix: Godot Tilemap Physics Shape Collision With Character Jitter
• Fix: Godot Physics Shape Margin Thin Collider Tunnels