unity-probuilder

Create and edit ProBuilder meshes for Unity level blockout and greyboxing.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-probuilder-dylan8865
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-probuilder
Source: https://github.com/Dylan8865/FinalYearProject/tree/main/GameDev/Tester/.agents/skills/unity-skills/skills/probuilder
Command: npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-probuilder-dylan8865

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Building level geometry in Unity with plain primitives produces non-editable meshes, forcing designers to restart when layouts change. This Skill creates and edits ProBuilder meshes directly in the editor so level blockouts, ramps, stairs, and furniture can be refined iteratively without leaving the scene. ## Core Features & Use Cases - Parametric Shape Creation: Generate cubes, cylinders, stairs, arches, and more via probuilder_create_shape, or batch-create entire blockouts with probuilder_create_batch. - Face, Edge, and Vertex Editing: Extrude, delete, merge, and bevel faces, bridge edges, weld or move vertices, and project UVs for precise geometry refinement. - Material and Color Assignment: Apply quick prototype colors or material assets to whole objects or selected faces for gameplay-role color coding. - Use Case: Block out a platformer level by batch-creating floors and platforms, verify jump distances against gameplay scale rules, then shape a ramp by moving vertices and color-code hazards before art production. ## Quick Start Ask the AI to block out a simple level with a ground plane, two platforms, and a ramp using ProBuilder, then color the platforms 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 a level blockout in Unity with ProBuilder?▼

Use probuilder_create_batch to generate floors, walls, and platforms in one call, then verify traversal scale before refining. Follow up with face extrusion and vertex moves for ramps and irregular silhouettes.

How do I edit ProBuilder mesh vertices in Unity?▼

Call probuilder_get_vertices first to identify the correct topology, then use probuilder_move_vertices with vertex indexes and delta offsets, or probuilder_set_vertices for absolute positions. Mesh rebuild steps are handled automatically by the skills.

Does this skill work without the ProBuilder package installed?▼

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

What is the difference between probuilder_set_material and probuilder_set_face_material?▼

probuilder_set_material assigns a material or quick color to the entire object, while probuilder_set_face_material targets only selected faces by index. Use face-level assignment for gameplay color coding on specific surfaces.

Why does probuilder_combine_meshes return MODE_FORBIDDEN?▼

probuilder_combine_meshes is flagged with Modify and Delete operations, which triggers the NeverInSemi rule. It only runs under Bypass mode or after the user adds it to the Allowlist; other edit skills remain grantable under Approval mode.