# SimpleStaticMeshMerger

## Documentation

https://github.com/MZSH-UEPlugins/UEPluginDocs/blob/main/SimpleStaticMeshMerger/README.md

---

## Overview

SimpleStaticMeshMerger is a lightweight Unreal Engine editor tool that merges duplicate StaticMeshActors into Instance Static Mesh (ISM) or Hierarchical Instance Static Mesh (HISM), significantly improving rendering performance.

---

## Key Features

- Auto Grouping: Intelligently groups by Mesh, Mobility, Collision, and Materials

- Real-time Preview: Visual interface with merge groups and instance display

- LevelInstance Support: One-click recursive breaking of nested LevelInstances

- Full Collision Preservation: Accurately copies all collision settings

---

## Use Cases

- Scene Optimization: Merge repeated static meshes (trees, rocks, grass)

- Urban Scenes: Merge streetlights, railings, road signs

- Pre-packaging Optimization: Reduce Draw Calls and loading stutters