# 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**