🔁How to instance repeated meshes
A Model Mesh Node is one draw. Ten copies of the same .glb are ten draws. They still share one file. That is normal kitbash. See How to kitbash a level from mesh models.
Instancing is one node that draws many copies of the same geometry in one pass. Use it when you need dozens or hundreds of the same small prop (grass, rocks, coins), not for a handful of unique kit pieces.
Registered editor names (Mesh category):
Instanced Model Mesh Node
ENGINE.InstancedModelMeshNode
Repeat a .glb (modelUrl)
Instanced Mesh Node
ENGINE.InstancedMeshNode
Repeat built-in geometry (default is a box)
Measure FPS first: Performance & optimization.
Point it at the mesh
On Instanced Model Mesh Node, set modelUrl to a fully qualified path such as @project/assets/models/prop.glb.
Leave Model Material empty to keep packed kit materials. Override only when every instance should share a different .material.json. Same rule as a Model Mesh Node: How to set up materials.
Add LOD only if you have extra meshes
LOD is optional. LOD0 is the node’s main mesh (modelUrl or the primitive geometry).
On Instanced Model Mesh Node, extra lods entries each need a modelUrl and a camera distance greater than 0. Farther distances use simpler .glb files. Tiers with distance at 0 or below are ignored.
On Instanced Mesh Node, extra lods entries use geometry plus distance.
Compaction (cull / LOD) also runs when more than one LOD tier exists.
Test in Play
Enter Play mode. Watch FPS in the same view that was slow with separate Model Mesh Nodes. Capture a profiler JSON if it is still slow: How to use the profiler.
When not to instance
A few unique kit pieces
Separate Model Mesh Nodes, one .glb
Mesh plus light, trigger, or gameplay children
A prefab, then instances of that prefab
Player or NPC character
Character pawn / NPC prefab, not an instanced node
updatePhysicsOnInstanceTransform defaults off. Leave it off unless instance motion must push physics that frame.
Common mistakes
Expected to type every copy in the Inspector
instances is hidden. Ask the agent.
Named it Instant Mesh
The Mesh category labels are Instanced Model Mesh Node and Instanced Mesh Node.
Instanced a unique building
Keep unique architecture as Model Mesh Nodes.
Raised maxInstances “to be safe”
Match the real count. Default is 1000.
Set cullDistance and everything vanished
Distance is world units from the camera. 0 disables. Lower the value only after you see FPS.
What You've Done
You can add an Instanced Model Mesh Node (or Instanced Mesh Node), set modelUrl or primitive geometry, let the agent fill copies, and turn on distance cull or extra LOD. Next: Performance & optimization, or How to kitbash a level from mesh models if most of the level should stay as ordinary nodes.
Last updated
Was this helpful?

