> For the complete documentation index, see [llms.txt](https://flora.magneticarcade.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://flora.magneticarcade.com/scripts/instance-renderer.md).

# Instance Renderer

Renders a scene-backed instance with Flora.

The `FloraInstanceRenderer` is a component that enables Flora rendering for a scene object with a `LODGroup` or `MeshRenderer`. A prefab reference is optional; the scene object supplies the render definition and owns the registered instance.

Adding this component to the **root object** automatically registers it with the [FloraSystem](/scripts/system.md) and renders the instance using GPU instancing.

Disabling or removing the component will:

* Unregister the instance from Flora
* Reactivate Unity’s built-in `MeshRenderer` or `LODGroup` rendering path

<figure><img src="https://2882982566-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyo4B7EVXffipTxnJzee6%2Fuploads%2Fgit-blob-30f86ffe8edac2cd699d8aa09e48ac9f0b892ff6%2Finstanced-renderer-scene-01.webp?alt=media" alt="Flora Instance Renderer component"><figcaption></figcaption></figure>

***

## Properties

### `InstanceHandle`

When the component is active, this property holds the `FloraInstanceHandle` for the instance.

* Use this handle to interact with the [FloraSystem](/scripts/system.md)
* If the component is disabled or destroyed, the handle becomes invalid

### `SpeedTreeWindProxyMode`

Overrides the scene-wide [SpeedTree wind](/rendering/speedtree-wind.md) sampling policy for this renderer:

* `UseSceneSettings` follows `FloraSceneSettings.SceneSpeedTreeWindProxyMode`. This is the default.
* `PerPrototype` shares wind with matching render prototypes and samples position-dependent wind at the world origin.
* `PerInstance` samples wind separately for this renderer.

> **Performance:** `PerInstance` creates a separate hidden wind proxy and rendering binding for every Instance Renderer using it. This reduces batching and is intended for a limited number of scene-backed trees that require position-dependent wind. Prefer `PerPrototype` for forests and repeated vegetation.

Changing the mode refreshes the Flora registration automatically.

### `SpeedTreeWindProxyAnchor`

Optional transform used as the sampling position in `PerInstance` mode. When it is unset, Flora uses this component's transform. Moving the resolved anchor moves the hidden wind proxy.

```csharp
instanceRenderer.SpeedTreeWindProxyMode = FloraSpeedTreeWindProxyOverride.PerInstance;
instanceRenderer.SpeedTreeWindProxyAnchor = windSampleAnchor;
```