# Additional Renderer Settings

Attach this component to a prefab to add per-prefab caps for distance, shadows, and density participation.

***

### Properties

#### <mark style="color:yellow;">AdditionalPerInstanceData</mark>

* Allocates optional per-instance shader data for this prefab.
  * `RandomID` exposes a stable per-instance random value as `flora_RandomID` or the Shader Graph `InstanceRandomID` node.
  * `VariationColor` exposes a per-instance color as `flora_VariationColor` or the Shader Graph `InstanceVariationColor` node.
* Enable only the data your shaders need; each enabled flag increases per-instance data.
* See [Shaders and Materials](/rendering/shaders-and-materials.md) for shader setup.

#### <mark style="color:yellow;">InitialVariationColor</mark>

* Initial value for `VariationColor` instances.
* Ignored unless `AdditionalPerInstanceData` includes `VariationColor`.
* Individual instances can override it at runtime with `FloraSystem.SetInstanceVariationColor(...)` or `SetInstanceVariationColors(...)`.

#### <mark style="color:yellow;">MaxRenderDistance</mark>

* Adds a per-prefab **maximum render distance cap**.
  * `0` — Prefab cap disabled.
  * Non-zero — Combined with other active caps; the smallest non-zero cap wins.

#### <mark style="color:yellow;">MaxShadowDistance</mark>

* Adds a per-prefab **maximum shadow distance cap**.
  * `0` — Prefab cap disabled.
  * Non-zero — Combined with other active caps; the smallest non-zero cap wins.

#### <mark style="color:yellow;">MinShadowLOD</mark>

* Sets the **lowest LOD index** allowed for rendering shadows.
  * `0` — Highest detail.
  * Higher values reduce shadow fidelity to improve performance.

#### <mark style="color:yellow;">AffectedByGlobalDensity</mark>

* If enabled, instances can be culled based on the current [Global Density](/scripts/density-settings.md#globaldensity).

#### <mark style="color:yellow;">AffectedByRangeDensity</mark>

* If enabled, instances can be culled based on [Range Density](/scripts/density-settings.md#rangedensity) values in the scene.

#### <mark style="color:yellow;">AffectedByMinimumScreenSize</mark>

* If enabled, instances can be culled by [`MinScreenSize`](/scripts/render-settings.md#minscreensize).
* Disable this for prefabs that should ignore minimum screen-size culling even when the active [Render Settings](/scripts/render-settings.md) enable it.

#### <mark style="color:yellow;">RequiresPerInstanceRandomID</mark> *(Obsolete)*

* Migrated to `AdditionalPerInstanceData.RandomID`.
* Kept for older serialized assets only.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://flora.magneticarcade.com/scripts/additional-renderer-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.