unity-physics-3dlisted
Install: claude install-skill tipoLi5890/unity-dev-skills
# unity-physics-3d — a triage ladder, not a list of things to try
> **Your prior knowledge about PhysX callbacks is unreliable, and the errors are silent.**
> Almost nothing in this domain throws. A collider that will never collide looks identical in the
> inspector to one that will. Work the ladder; do not reason from what "should" happen.
## Symptom → where to look
First match wins. **Stop at the first cause you confirm** and write the diagnosis; the rest of the
ladder is for when that check comes back clean.
| Symptom | Go to |
|---|---|
| `OnCollisionEnter` / `OnTriggerEnter` never fires | §1 |
| Objects pass through each other at speed; a fast object passes through a wall | §2 |
| A hit is reported before the two objects visibly touch | §2 — speculative contacts |
| `Physics.Raycast` misses something clearly in front of it | §3 |
| A click finds no UI, or a world ray keeps hitting the HUD | §3 — two raycasters, two worlds |
| `AddForce` seems to stop working once the object settles | [`reference/sleep-shapes-build.md`](reference/sleep-shapes-build.md) §4 — and it is **not** the sleep state |
| `OnTriggerStay` / `OnCollisionStay` ran for a while, then went quiet | [`reference/sleep-shapes-build.md`](reference/sleep-shapes-build.md) §4 — the body fell asleep |
| Everything frozen but raycasts still hit | [`reference/sleep-shapes-build.md`](reference/sleep-shapes-build.md) §4 |
| Ragdoll explodes on the first frame | [`reference/sleep-shapes-build.md`](reference/sleep-s