collision-proxy — Claude Code skill for Blender colliders
The collision-proxy Claude Code skill creates game collision proxies in Blender through MCP. It activates for physics colliders, hitboxes, and blocking geometry.
MIT 582 installs ★ 4,589 updated 2026-11-06
npx skills add arjun988/blender-skills --skill collision-proxy -a claude-codeWhat collision-proxy does
The skill guides collider creation and prepares proxies for export alongside a game model. It uses boxes, capsules, spheres, and convex hulls; complex objects can use several convex pieces. Proxies follow the target engine’s naming rules and go in a separate collection named COL_Collision_[Asset].
For Unreal, names follow patterns such as UCX_SM_Asset_01, and UCX proxies must be convex. In Unity, the skill favors engine primitives where possible; mesh colliders on dynamic Rigidbody objects need the convex setting. It also checks that blockers stop the player and that colliders do not extend into large invisible walls. Apply scale and align the origin with the render mesh.
What it helps with
- build colliders for game assets
- split a complex object into convex proxies
- name UCX colliders for Unreal
- prepare a hitbox or blocking volume for export
Example prompts for the agent
- Create colliders for this game model and name them for Unreal.
- Build convex proxies for the vehicle and put them in
COL_Collision_Car. - Make a hitbox for this interactable and check its blocking geometry.
How to install collision-proxy
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill collision-proxy -a claude-code2Manually: put the files in place
~/.claude/skills/collision-proxy/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/collision-proxy/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill collision-proxy -a codex2Manually: put the files in place
.agents/skills/collision-proxy/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill collision-proxy -a cursor2Manually: put the files in place
.cursor/skills/collision-proxy/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arjun988/blender-skills .claude/skills/collision-proxy2Manually: put the files in place
.github/skills/collision-proxy/SKILL.md1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill collision-proxy -a gemini-cli2Platform CLI
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/collision-proxyManually: put the files in place
.devin/skills/collision-proxy/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill collision-proxy -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about collision-proxy
How do I install collision-proxy in Claude Code?
Run npx skills add arjun988/blender-skills --skill collision-proxy -a claude-code. The skill file is placed at ~/.claude/skills/collision-proxy/SKILL.md.
What does collision-proxy do?
It helps create game colliders in Blender, name them for Unreal or Unity, and prepare the proxies for export with the model.
What naming rules does collision-proxy use for Unreal UCX?
Use names such as UCX_SM_Asset_01 and UCX_SM_Asset_02, tied to the model name. UCX colliders must be convex.
Source text
SKILL.md · MIT
--- name: collision-proxy description: Collision proxy authoring for games including UCX/UHX naming, convex hulls, capsules, and simple collider meshes in Blender via MCP. license: MIT metadata: author: https://github.com/arjun988 version: "1.0.0" domain: blender role: specialist triggers: collision, collider, UCX, UHX, convex hull, physics proxy, hitbox, blocking volume related-skills: lod-pipeline, unity-export, unreal-export, asset-optimization, physics-sim --- # Collision Proxy Simple, stable colliders. Prefer primitives and convex pieces over render mesh. ## When to Use - Game physics / blocking volumes - Unreal UCX export - Unity mesh or primitive colliders - Hitboxes for interactables ## Workflow ``` Identify collision needs → Build proxies → Name correctly → Test overlaps → Export with render mesh ``` ## Collider Types | Type | Use | |------|-----| | Box | Crates, walls, simple props | | Capsule | Characters, poles | | Sphere | Balls, soft approximates | | Convex hull | Organic / irregular single body | | Multiple convex (UCX) | Vehicles, complex props | ## Unreal Naming ``` UCX_SM_Asset_01 UCX_SM_Asset_02 ``` - Must match associated mesh naming rules for auto-association - Convex only for UCX ## Unity Notes - Prefer engine primitives when possible - Mesh colliders: convex toggle for dynamic rigidbodies - Keep proxy collection exportable ## Authoring Rules 1. Slightly smaller than visual mesh to reduce snagging (project-dependent) 2. No holes; watertight convex pieces 3. Apply scale 4. Origin aligned with render mesh 5. Collection: `COL_Collision_[Asset]` ## Validation - [ ] Player cannot fall through intended blockers - [ ] No huge invisible walls beyond mesh - [ ] Wheel/character capsules oriented correctly - [ ] Named for target engine ## Constraints ### MUST DO - Prefer few simple shapes over one complex mesh - Match engine naming conventions - Keep proxies in dedicated collection ### MUST NOT DO - Use render LOD0 as physics mesh by default - Non-convex UCX for Unreal auto-convex workflows ## Reference Guide | Topic | Reference | Load When | |-------|-----------|----------| | Collider Recipes | `references/collider-recipes.md` | When needed | | Engine Naming | `references/engine-naming.md` | When needed |
© https://github.com/arjun988 · MIT · arjun988/blender-skills