Mesh Integrator

Mesh Integrator

Mesh Integrator is a powerful Unity tool that allows you to combine the meshes of a GameObject and all its child GameObjects into a single optimized mesh. It supports both Editor and Runtime usage, making it highly flexible for a wide range of development workflows.

When to Use

Mesh Integrator is especially useful during development and in complex games where mesh merging improves performance — for example, after a structure is completed in-game. Instead of rendering many separate mesh objects, you can merge them into one to reduce draw calls and GPU overhead.

It’s also ideal when a GameObject has multiple child objects using the same material. These will be combined into a single mesh with a single material reference, which boosts performance significantly when using many instances of the object in your scene.

In specific cases, such as procedural or voxel-based games, you can even use Mesh Integrator to merge entire chunks into unified meshes for efficient rendering.

Runtime Support

You can perform mesh merging at runtime, allowing dynamic optimization as the game progresses. This is particularly useful for scenarios like:

• Combining modular objects after placement
• Finalizing generated structures
• Merging decor elements into background geometry

Caching System

Mesh Integrator includes a built-in caching system that helps share the same mesh and materials across multiple instances. This reduces memory usage and greatly improves performance by avoiding repeated mesh processing. You can see this in action in the included SampleScene2.

Programmatic Use

You can also call the runtime mesh integration functionality directly from your own scripts using static method provided by the tool. This gives you full control over when and how mesh merging happen. For API reference, see: Docs/Mesh Integrator 1.0.0.pdf.