probuilder-merge-objects

Merges multiple ProBuilder meshes into a single mesh in Unity.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires unity-mcp-cli.

What problem does it solve? Combining separate ProBuilder meshes into one object reduces draw calls and simplifies scene management, but doing it manually in the Unity Editor is repetitive and error-prone. ## Core Features & Use Cases - Mesh Merging: Combines multiple GameObjects with ProBuilderMesh components into a single unified mesh, with the first object in the list becoming the merge target. - Source Cleanup: Optionally deletes the source GameObjects after merging, keeping the scene hierarchy clean. - Detailed Reporting: Returns merge statistics including face and vertex counts before and after, target object info, and per-source status. - Use Case: Merge a table built from separate leg and top ProBuilder meshes into one object to optimize rendering performance. ## Quick Start Ask the AI to merge the selected ProBuilder meshes in the Unity scene into a single object using the probuilder-merge-objects tool.

Frequently Asked Questions about probuilder-merge-objects

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

FAQPage Schema
How do I merge ProBuilder meshes in Unity?

Call the probuilder-merge-objects tool via unity-mcp-cli with an array of GameObject references containing ProBuilderMesh components. The first object in the list becomes the merge target that all other meshes combine into.

How to combine multiple GameObjects into one mesh in Unity?

Provide the GameObject references by instanceID, hierarchy path, or name in the gameObjectRefs input array. The tool merges their ProBuilder meshes and reports face and vertex counts before and after the operation.

Does merging ProBuilder objects delete the original GameObjects?

By default the source GameObjects are deleted after merging, except for the merge target. Set the deleteSourceObjects parameter to false to keep the original objects in the scene.

Why is unity-mcp-cli not found when running the tool?

The CLI is not installed globally. Install it with npm install -g unity-mcp-cli, or prefix commands with npx unity-mcp-cli, then retry the merge operation.

What are the limitations of merging ProBuilder meshes?

All input GameObjects must have ProBuilderMesh components, and the merge produces a single combined mesh rather than preserving per-object editability. Individual sub-object transforms and separate material assignments may be consolidated into the target.