# Overview

{% embed url="<https://youtu.be/qT5EFgaZBaQ?si=mI0p5Sn954KDo1Ea>" %}

Flora lets you render large numbers of objects as **instances** (drawn from shared prefab data instead of one full `GameObject` rendering path per item). It is designed for terrain foliage, container and instance-renderer workflows, converted scene prefabs, and runtime-spawned populations.

## Start Here

If you are new to BRG/instancing, follow this order:

1. [Getting Started](https://flora.magneticarcade.com/getting-started)
2. [Samples](https://flora.magneticarcade.com/samples)
3. [Scripts](https://flora.magneticarcade.com/scripts)
4. [Rendering](https://flora.magneticarcade.com/rendering)

## Common

* Render terrain trees/details with Flora: [Terrain Provider](https://flora.magneticarcade.com/scripts/terrain-provider)
* Render instances without Unity `Terrain`: [Instance Container](https://flora.magneticarcade.com/scripts/instance-container), [Instance Renderer](https://flora.magneticarcade.com/scripts/instance-renderer), [Container Samples](https://flora.magneticarcade.com/samples/container-samples)
* Convert existing prefab objects: [Conversion](https://flora.magneticarcade.com/getting-started/conversion)
* Spawn and control instances in code: [System](https://flora.magneticarcade.com/scripts/system)
* Tune visibility/performance: [Render Settings](https://flora.magneticarcade.com/scripts/render-settings), [Density Settings](https://flora.magneticarcade.com/scripts/density-settings), [Culling Pipeline](https://flora.magneticarcade.com/rendering/culling-pipeline)

## Concepts

* **BRG (Batch Renderer Group)**: Unity GPU-driven rendering path Flora uses for scalable draw submission.
* **Instance Container**: a serialized list of instance transforms for large static/semi-static sets.
* **Volume Override**: scene regions that override render/density settings.

## Samples

* [Tree Wrecking Ball](https://flora.magneticarcade.com/samples/terrain-samples#tree-wrecking-ball)
* [Tree Effect](https://flora.magneticarcade.com/samples/terrain-samples#tree-effect)
* [Fish Boids](https://flora.magneticarcade.com/samples/runtime-samples#fish-boids)
* [Container Mesh Sample](https://flora.magneticarcade.com/samples/container-samples#container-mesh-sample)
* [Container Prefab Sample](https://flora.magneticarcade.com/samples/container-samples#container-prefab-sample)

## Additional Resources

* [Asset Store](https://u3d.as/3z4E)
* [Unity Forum](https://discussions.unity.com/t/released-50-off-new-flora-renderer/1670348)
* [Discord](https://discord.gg/bsTzQbCY)
* [Roadmap](https://trello.com/b/TLKPM8Eg/flora)

## Requirements

* **Unity 6 LTS, 6.3 LTS**
* **Compute Shader Support** on **Target Platform**
* **Universal, High Definition,** or **Custom Scriptable Render Pipeline**


---

# 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/readme.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.
