batihandev/unity-mcp-skills/probuilder

Unity ProBuilder Skills

Requirements

• com.unity.probuilder (≥ 6.0). If missing, install via Unity_PackageManager_ExecuteAction with operation=Add, package=com.unity.probuilder, version=6.0.9.

When to Use

Use this module for editable ProBuilder meshes, not regular primitive GameObjects. It is best for blockout, level geometry, and procedural mesh refinement.

Batch-first: For scene blockout or level generation, prefer probuilder_create_batch when creating 2+ shapes.

Common Mistakes

DO NOT (common hallucinations):

• probuilder_create_mesh does not exist -> use probuilder_create_shape
• probuilder_edit_face does not exist -> use the specific face skills such as probuilder_extrude_faces, probuilder_delete_faces, probuilder_merge_faces
• probuilder_set_material and probuilder_set_face_material are different -> whole object vs selected faces
• Regular meshes do not become ProBuilder meshes automatically
• Mesh rebuild calls (ToMesh() + Refresh()) are already handled by the skills. Do not invent a manual rebuild step

Routing:

• For ordinary primitive objects without editable topology -> use gameobject_create
• For material asset creation or shader work -> use material
• For large blockout generation -> combine this module with material and light, but keep geometry creation here

Object Targeting

Most edit/query skills accept one of:

• name
• instanceId
• path

Prefer instanceId when multiple scene objects share the same name.

Quick Reference

Create and Batch

Supported shape values: Cube, Sphere, Cylinder, Cone, Torus, Prism, Arch, Pipe, Stairs, Door, Plane.

Face and Edge Editing

Mesh, Vertex, UV, Material

Query and Pivot

Spatial Reference

Positioning Rules

• y is the center of the shape, not its bottom.
• Floor top surface at 0 with sizeY=0.3 means y = -0.15.
• To stack B on A: B.y = A.y + A.sizeY/2 + B.sizeY/2.
• Pillars should usually use y = height/2.

Human Scale Reference

Common Modeling Patterns

Furniture Decomposition

Real props should rarely be a single box. Split them into structural parts.

Typical furniture sizes: desk 1.2x0.6x0.75m, chair seat 0.45x0.45x0.45m (total 0.85m height), bookshelf 0.8x0.3x1.8m.

Blockout Workflow

1. Create major volumes with probuilder_create_batch.
2. Verify traversal and gameplay scale before adding detail.
3. Refine surfaces with face/edge operations.
4. Use vertex edits for ramps, slopes, and irregular silhouettes.
5. Apply quick colors or real materials after layout stabilizes.

C# Templates

Recipe path rule: ../../recipes/probuilder/<command>.md

See ../../recipes/probuilder/README.md for the full command index and per-command Unity_RunCommand C# templates.

Important Notes

1. ProBuilder objects keep editable topology through ProBuilderMesh.
2. Use probuilder_get_info before face edits and probuilder_get_vertices before vertex edits.
3. MeshCollider on physics-driven props must be convex.
4. Quick color assignment is fine for prototype passes; use material assets for production.
5. Package missing errors are expected if ProBuilder is not installed.