wave5-collision-filter-layer-masking

What problem does it solve?

This Skill helps you control which physics bodies collide with each other and which spatial queries detect, preventing unwanted contacts and false-positive raycasts/overlaps that waste CPU time.

Core Features & Use Cases

• Collision pair filtering: Use CollisionFilter.BelongsTo and CollisionFilter.CollidesWith bitmasks so only intended body pairs interact.
• Query-time layer targeting: Apply the same filtering to rays/queries so they hit only specific layers (e.g., projectiles hitting ground and enemies, not allies).
• Performance optimization: Reduce broadphase candidate pairs and narrowphase evaluations in dense scenes by tightening filters instead of using defaults.

Quick Start

Tell your AI to update your Unity Physics colliders and raycast/query filters so BelongsTo is set on bodies (who they are) and CollidesWith is set on queries/bodies (who they can hit), using shared 1u << layerIndex constants and aligning both sides of the rule.