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

# Debugging

A guide to using the rendering debugger in Flora.

Use Flora's [Rendering Debugger](https://docs.unity3d.com/6000.2/Documentation/Manual/urp/features/rendering-debugger.html) tab for live diagnostics.

Use the [Rendering Inspector](/rendering/rendering-inspector.md) for Editor-only snapshots.

<figure><img src="https://2882982566-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyo4B7EVXffipTxnJzee6%2Fuploads%2FS2We1kURdHyOlNBXlwP1%2FScreenshot%202025-11-14%20at%208.47.52%E2%80%AFAM.png?alt=media&amp;token=4977f967-e513-4ad8-9db5-e9fedca9e7da" alt="Rendering Debugger tab"><figcaption></figcaption></figure>

## Open the debugger

* Select **Window > Flora > Rendering Debugger**.
* In Play mode or a development Player build, press **Ctrl + Shift + Backspace**.

<figure><img src="https://2882982566-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyo4B7EVXffipTxnJzee6%2Fuploads%2Fgit-blob-5db3ad2560efc566269bc44c21f918b1e881e67d%2Frendering-debugger-runtime.webp?alt=media" alt="Flora debugger hotkey" width="563"><figcaption></figcaption></figure>

The **Flora** tab requires an active `FloraSystem`. Like URP and HDRP debug modes, selected Flora diagnostics remain active until you disable them or reset the Rendering Debugger; opening or closing the window does not enable or disable rendering work.

## Debug shading

**Debug Shading Mode** colors instances by the selected value:

* **LOD**
* **InstanceHandle** (Editor only)
* **RandomID**
* **Render Prototype**
* **Draw** or **DrawVariant**
* **CullingBatch**
* **BatchDomain**

Related controls:

* **Debug Shading Opacity** - blends debug colors with normal shading.
* **Enable GPU Checks** - enables GPU validation and may affect performance.
* **Open Rendering Inspector** - opens the [Rendering Inspector](/rendering/rendering-inspector.md).

## LOD

* **None** - normal LOD selection.
* **ForceLOD** - forces the selected **LOD Index**.
* **OnlyLOD** - renders only the selected **LOD Index**.

## GPU occlusion

These controls require GPU occlusion in [Runtime Settings](/scripts/runtime-settings.md) and on the Camera.

* **Occlusion Overlay** - draws occlusion results.
* **Count Visible** - adds visible-instance counts.
* **Depth Overlay** - shows the occluder depth pyramid.
* **Range Min / Range Max** - remaps the depth display.

## Culling overrides

* **Disable Density Culling** - makes density culling pass every instance.
* **Disable GPU Occlusion Culling** - makes GPU occlusion pass every instance.

Use these overrides to isolate why instances are missing.

## Culling grid

* **Heatmap** - colors the grid by occupancy.
* **Level** - colors grid levels.
* **Blocks**, **Cells**, and **Chunks** - select the structure to draw.
* **Draw Distance** - limits the overlay range.

## Culling stats

In Play mode or a development Player build, open **Display Stats > Flora Culling**. Statistics are disabled by default and use separate controls:

* **Collect CPU Stats** - samples CPU culling statistics.
* **Collect GPU Stats** - samples GPU culling counters and performs asynchronous readback.

Both modes sample at the displayed five-hertz refresh rate. The per-view table includes:

* CPU-visible chunks, instances, and draws
* GPU candidate and visible chunks
* active draw bins
* visible and occluded instances
* visible draws
* exact and fallback LOD counts

GPU statistics add compute counters on sampled frames and may affect performance. Disable collection when profiling normal rendering performance. For Editor-only inspection without continuous collection, use the [Rendering Inspector](/rendering/rendering-inspector.md).

## Quick diagnosis

* Missing instances: disable density culling, then GPU occlusion culling.
* Wrong LOD: use **ForceLOD** or **OnlyLOD**.
* Unexpected grouping: enable the culling-grid overlay.
* Structural issues: open the [Rendering Inspector](/rendering/rendering-inspector.md).