probuilder-set-face-material

Assigns materials to specific ProBuilder mesh faces by index or direction.

1|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill probuilder-set-face-material-fermisloth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: probuilder-set-face-material
Source: https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment/tree/main/.agent/skills/probuilder-set-face-material
Command: npx skills add https://github.com/Fermisloth/Project-Aegis-Adaptive-Outbreak-Containment --skill probuilder-set-face-material-fermisloth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Applying different materials to individual faces of a ProBuilder mesh in Unity normally requires manual editor work, making it hard to automate multi-material mesh creation through tooling. ## Core Features & Use Cases - Face-Level Material Assignment: Apply a material to specific faces of a ProBuilderMesh using explicit face indices. - Semantic Face Selection: Target faces by direction (Up, Down, Left, Right, Forward, Back) instead of numeric indices. - Use Case: When building a level blockout in Unity, assign a grass material to the top face of a ProBuilder cube and a stone material to its sides in a single automated call. ## Quick Start Ask the AI to set the material on the top face of your ProBuilder object by specifying the GameObject, the material asset path, and faceDirection as up.

Frequently Asked Questions about probuilder-set-face-material

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

FAQPage Schema
How do I assign a material to specific faces of a ProBuilder mesh in Unity?

Use the probuilder-set-face-material tool with a GameObject reference, a material asset path, and either face indices or a face direction. The tool applies the material to the selected faces and returns the updated material index and affected faces.

How do I select ProBuilder faces by direction instead of index?

Pass the faceDirection parameter with one of Up, Down, Left, Right, Forward, or Back instead of faceIndices. This semantic selection targets all faces pointing in that direction without needing to know their numeric indices.

Can I use both faceIndices and faceDirection in the same call?

No, you must use either faceIndices or faceDirection, not both. Use ProBuilder_GetMeshInfo first to obtain valid face indices if you prefer index-based selection.

What should I do if unity-mcp-cli is not found?

Install it globally with npm install -g unity-mcp-cli, or prefix commands with npx unity-mcp-cli. The unity-initial-setup skill contains detailed installation instructions.

What input does the materialPath parameter accept?

The materialPath parameter accepts a path to a material asset such as Assets/Materials/MyMaterial.mat, or the material name directly. It is a required parameter alongside the GameObject reference.