arjun988/blender-skills

collision-proxy

Collision proxy authoring for games including UCX/UHX naming, convex hulls, capsules, and simple collider meshes in Blender via MCP.

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/arjun988/blender-skills --skill collision-proxy

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

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

TypeUse
BoxCrates, walls, simple props
CapsuleCharacters, poles
SphereBalls, soft approximates
Convex hullOrganic / 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

TopicReferenceLoad When
Collider Recipesreferences/collider-recipes.mdWhen needed
Engine Namingreferences/engine-naming.mdWhen needed

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills