unity-probuilder

Create and edit ProBuilder meshes in Unity for level blockout and prototyping.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-probuilder-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-probuilder
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/probuilder
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-probuilder-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building level geometry and prototype shapes in Unity normally requires manual editor work or external modeling tools. This Skill lets you create, edit, and refine editable ProBuilder meshes programmatically, covering blockout, face/edge editing, vertex manipulation, and material assignment. ## Core Features & Use Cases - Parametric Shape Creation: Generate cubes, cylinders, stairs, arches, and more individually or in batches with probuilder_create_shape and probuilder_create_batch. - Topology Editing: Extrude, delete, merge, and detach faces; bevel and bridge edges; move, weld, and set vertices for ramps and irregular silhouettes. - Materials and Querying: Apply quick colors or material assets to whole objects or selected faces, and inspect mesh stats with probuilder_get_info and probuilder_get_vertices. - Use Case: Block out a platformer level by batch-creating floors and platforms, verifying jump distances against gameplay scale rules, then refining ramps with vertex edits and color-coding surfaces by gameplay role. ## Quick Start Use the probuilder skill to create a 20x12 ground plane and a raised 3x3 platform, then color the platform blue.

Frequently Asked Questions about unity-probuilder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create ProBuilder shapes in Unity from a script?

Use probuilder_create_shape with a shape type such as Cube, Cylinder, or Stairs plus size and position parameters. For multiple shapes, probuilder_create_batch accepts an items array and an optional defaultParent in a single call.

How do I edit ProBuilder faces and vertices programmatically?

Query the mesh first with probuilder_get_info or probuilder_get_vertices to identify indexes, then apply probuilder_extrude_faces, probuilder_delete_faces, probuilder_bevel_edges, or probuilder_move_vertices with the target indexes.

Does this skill work without the ProBuilder package installed?

No. Every skill in the module returns a package-missing diagnostic when com.unity.probuilder is not installed. Install the ProBuilder package through Unity Package Manager before calling any skill.

What is the difference between probuilder_set_material and probuilder_set_face_material?

probuilder_set_material assigns a material or quick RGB color to the entire object, while probuilder_set_face_material targets selected faces by index or submesh. They are separate skills and not interchangeable.

Why does probuilder_combine_meshes return MODE_FORBIDDEN?

probuilder_combine_meshes is flagged with Modify and Delete operations, which blocks it in SemiAuto modes. It only runs under Bypass mode or after being added to the Allowlist; the grant flow returns MODE_FORBIDDEN otherwise.

When should I use ProBuilder instead of regular GameObject primitives?

Use ProBuilder when you need editable topology for blockout, ramps, or refined level geometry. For ordinary primitives without editable topology, use gameobject_create instead, since regular meshes do not become ProBuilder meshes automatically.