← ClaudeAtlas

unity-physics-3dlisted

3D PhysX bugs: OnTriggerEnter never fires, tunnelling, raycast misses, exploding ragdolls.
tipoLi5890/unity-dev-skills · ★ 2 · AI & Automation · score 75
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