> 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/readme.md).

# 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](/getting-started.md)
2. [Samples](/samples.md)
3. [Scripts](/scripts.md)
4. [Rendering](/rendering.md)

## Common

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

## 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](/samples/terrain-samples.md#tree-wrecking-ball)
* [Tree Effect](/samples/terrain-samples.md#tree-effect)
* [Fish Boids](/samples/runtime-samples.md#fish-boids)
* [Container Mesh Sample](/samples/container-samples.md#container-mesh-sample)
* [Container Prefab Sample](/samples/container-samples.md#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**