Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add arjun988/blender-skills --skill collision-proxy -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/collision-proxy/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/collision-proxy/

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

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set57

The whole set →
cloth-sim Skill handles garment blockout, cloth simulation, pin groups, and bake to shape keys or caches in Blender via MCP. CX Codex +1 591installs rendering The rendering Claude Code skill configures Blender renders with Cycles and Eevee. It comes into play for final output, look checks, and compositing passes. CX Codex +1 590installs scene-assembly The scene-assembly Claude Code skill organizes large Blender scenes built from modular pieces. It activates for level layouts, cinematic sets, and scenes that use linked library collections. CX Codex +1 590installs vfx-fx The vfx-fx Claude Code skill builds cinematic and game effects in Blender through MCP. It covers smoke, fire, particles, trails, and Geometry Nodes FX setups. CX Codex +1 584installs compositing The compositing skill automates Blender compositor workflows for beauty stacks, render passes, color grading, glare, and delivery outputs via MCP. It activates during render post-processing tasks. CX Codex +1 575installs realistic-style The realistic-style Claude Code skill guides photorealistic asset work in Blender. It activates for photogrammetry cleanup, PBR materials, and cinematic or game-ready models. CX Codex +1 571installs vehicle-artist The vehicle-artist Claude Code skill guides vehicle modeling in Blender. It activates for cars, aircraft, ships, mechs, and other transport assets, with attention to proportions, panel layout, and game LODs. CX Codex +1 566installs hair-groom The hair-groom skill for Claude Code assists in creating realistic hair and fur in Blender. It streamlines workflows for characters, creatures, and game models. CX Codex +1 564installs

Project sponsors

Companies that keep this analytics open