Instance Container

A serialized collection of instances that do not require individual GameObjects.

An Instance Container stores many instance transforms without individual GameObjects. Use it for foliage, debris, or props outside Unity Terrain.

See Conversion and Container Samples.

For Unity Terrain trees and details, use Terrain Provider.

---

Properties

Prefab

The prefab rendered by all instances in this container. Changing it rebuilds every instance and invalidates the previous runtime handles.

InstanceHandles

Runtime handles for the container's instances.

LocalTransforms

Container-space position, rotation, and scale. Moving the container moves all instances.

StaticSpatialCacheMode

Controls Static Spatial Caching. Caching requires a Static GameObject, an assigned prefab, at least one instance, and the project setting.

---

Example

public class FoliageSpawner : MonoBehaviour
{
    public FloraInstanceContainer container;
    public GameObject treePrefab;

    void Start()
    {
        container.Prefab = treePrefab;

        for (int x = 0; x < 10; x++)
        for (int z = 0; z < 10; z++)
        {
            Vector3 pos = new Vector3(x * 2f, 0, z * 2f);
            container.AddInstance(pos, Quaternion.identity, Vector3.one, Space.World);
        }
    }
}

Instance changes invalidate cached spatial data. Save the scene or rebuild the cache before profiling scene loading.