> 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 is a GPU-instancing renderer for terrain foliage, converted prefabs, instance containers, and runtime-created populations.

## Start Here

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), [Culling Pipeline](/rendering/culling-pipeline.md)
* Reduce static scene initialization work: [Static Spatial Caching](/rendering/static-spatial-caching.md)
* Inspect rendering data: [Rendering Inspector](/rendering/rendering-inspector.md), [Debugging](/rendering/debugging.md)
* Upgrade an existing project: [Upgrade from 6.3.35](/getting-started/upgrading-from-6-3-35.md)

## Concepts

* **BRG (Batch Renderer Group)**: Unity's GPU-driven draw submission API.
* **Instance Container**: serialized transforms for a large instance set.
* **Volume Override**: global or bounded rendering and culling 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.0 or later**
* **Compute shader support** on the target platform
* **Universal Render Pipeline**, **High Definition Render Pipeline**, or a compatible custom Scriptable Render Pipeline

## Known Limitations

* Flora does not support the Built-in Render Pipeline.
* Terrain details are transient GPU data and cannot be queried through `FloraInstanceHandle` APIs.
* Child renderers under an `LODGroup` do not support non-identity local transforms in Flora's BRG path. See [Culling Pipeline](/rendering/culling-pipeline.md#known-limitation-child-lod-renderer-transforms).