Skip to content
Kitbay

fix-3d-physics-collisions

LicenseRef-Unity-Companion-LicenseUpdated on Nov 6, 20261,239GitHub starsIncludes scripts

A Unity skill for diagnosing 3D PhysX problems: collision or trigger callbacks that never fire, bodies that tunnel through one another, raycasts that fail to hit, and badly behaving Mesh Colliders.

What the skill teaches

A Unity skill for diagnosing 3D PhysX problems: collision or trigger callbacks that never fire, bodies that tunnel through one another, raycasts that fail to hit, and badly behaving Mesh Colliders. The agent identifies the symptom, works through the matching checklist (collisions, triggers, raycasts or other symptoms), reads console errors, and can use a bundled collision debugger script to inspect what the physics engine sees. It requires Unity 6000.3 or later, keeps to a tool budget, has a fixed report format, and works through the Unity CLI against the open Editor.

Capabilities

  • Diagnose collision and trigger callbacks not firing
  • Fix objects passing through each other
  • Debug raycasts that miss
  • Fix Mesh Collider problems