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

# Getting Started

Step-by-step setup instructions for new users.

Follow this page in order to install Flora and render your first scene.

## Install

When using **Unity 6.5**, use **6000.5.8f1 or newer** to avoid the camera culling view ID regression fixed in [UUM-146214](https://unity.com/releases/editor/whats-new/6000.5.8f1).

Install Flora from the Unity Asset Store: [Installing Asset Store Packages](https://docs.unity3d.com/6000.1/Documentation/Manual/upm-ui-import.html).

Use **Window > Flora > Package Manager** to install or update modules and add-ons.

<figure><img src="https://2882982566-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyo4B7EVXffipTxnJzee6%2Fuploads%2FTi1jFFB30coOobWs7BfW%2FScreenshot%202025-11-14%20at%208.41.26%E2%80%AFAM.png?alt=media&amp;token=02f54206-492e-4e4a-8f06-afb7d92f5742" alt="Flora Package Manager" width="375"><figcaption></figcaption></figure>

### Import the examples

1. Open **Window > Package Manager**.
2. Select **Flora**.
3. Expand **Samples**.
4. Import **Examples**.

Unity copies them to `Assets/Samples/Flora/<package-version>/Examples`.

## Set up a scene

1. Create **Flora Scene Settings** from **GameObject > Flora > Scene Settings**.
2. For Terrain foliage, enable **Terrain Foliage** and **Auto Register Terrains**.
3. Configure [Runtime Settings](/scripts/runtime-settings.md) under **Edit > Project Settings > Graphics**.
4. Select **Add Render Settings Volume** if the scene needs a Flora Volume. See [Render Settings](/scripts/render-settings.md).

<figure><img src="https://2882982566-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyo4B7EVXffipTxnJzee6%2Fuploads%2Fgit-blob-e0abaf553b5b08d2fe15b28a79c6149841f10544%2Fgraphics-settings-flora.webp?alt=media" alt="Default Volume Profile with Flora settings"><figcaption></figcaption></figure>

## Convert prefab instances

To convert existing prefab objects into Flora-rendered instances:

1. Select one or more prefab instances in Hierarchy.
2. Right-click and select **Convert to Instance Renderer**.
3. Confirm the objects use [`FloraInstanceRenderer`](/scripts/instance-renderer.md).

> See [Conversion](/getting-started/conversion.md) for all conversion options.

## Verify

Import and run [Container Mesh Sample](/samples/container-samples.md#container-mesh-sample). Then choose other examples from [Samples](/samples.md) for the workflow you use.

## Quick Troubleshooting

* Nothing renders: check [**Enable Rendering**](/scripts/scene-settings.md#enablerendering).
* Terrain foliage is missing: check [**Enable Terrain Foliage**](/scripts/scene-settings.md#enableterrainfoliage), the Terrain Provider, and the Terrain's tree and detail settings.
* Motion vectors missing: check the source Renderer or Terrain motion-vector setting.
* Inspect Flora data: open [Rendering Inspector](/rendering/rendering-inspector.md).