Unity ProBuilder Skills

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Blocking out levels
• Building or editing ProBuilder geometry
• Prototyping shapes in-editor
• 搭建关卡灰盒、创建或编辑 ProBuilder 几何体、在编辑器内快速搭形

Unity ProBuilder Skills

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

Requires: com.unity.probuilder package. Batch-first: For scene blockout or level generation, prefer probuilder_create_batch when creating 2+ shapes.

Guardrails

Operating Mode (v1.9 three-tier):

• Approval (default): query skills (e.g. probuilder_get_info, probuilder_get_vertices) run directly. Create/modify skills are FullAuto — call once, get MODE_RESTRICTED, run the grant protocol; a successful /permission/grant executes the skill server-side and returns the result in the same response.
• Auto / Bypass: SemiAuto and FullAuto run directly.
• Auto-forbidden in this module: probuilder_combine_meshes (SkillOperation.Modify | Delete, the Delete bit triggers NeverInSemi). It is callable only under Bypass mode or after the user adds it to the Allowlist; the grant flow returns MODE_FORBIDDEN. Note probuilder_delete_faces is Operation = SkillOperation.Modify only and remains grantable under Approval/Auto.
• When com.unity.probuilder is missing, every skill returns a package-missing diagnostic instead of executing.

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