From c9ac7edfa55ea58c9093d0ba11d1fa75dc076622 Mon Sep 17 00:00:00 2001
From: LunaShark <121734810+lunairekitty@users.noreply.github.com>
Date: Sat, 25 Apr 2026 23:25:33 -0400
Subject: [PATCH] Enhance volumetric lighting troubleshooting section

Added troubleshooting tips for volumetric lighting issues related to light source cutoffs.
---
 docs/lighting/volumetrics/troubleshooting.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/lighting/volumetrics/troubleshooting.md b/docs/lighting/volumetrics/troubleshooting.md
index 59c50df8..d75092fb 100644
--- a/docs/lighting/volumetrics/troubleshooting.md
+++ b/docs/lighting/volumetrics/troubleshooting.md
@@ -23,6 +23,10 @@ This is a list of currently known issues and some troubleshooting tips for any i
 
 * Volumetric lighting is shadow dependant, you need to make sure the `Shadowed` flag is checked when making shadowed volumetrics. If the flag is enabled but volumetrics are still leaking, then you might have too many dynamic shadows updating at once. See [clustered troubleshooting page](/lighting/clustered/troubleshooting) for more information related to the issue.
 
+### "The volumetrics are just a bright white sphere on the light!"
+
+* Volumetric lighting relies on the light's 50% and 0% cutoff distances to know how long and far to display the volumetric effect. Make sure that these are set. If you need example settings, check out the [clustered quick start guide](/lighting/clustered/quick_start).
+
 ### "My volumetrics are broken and corrupt!"
 
 * Certain AMD GPU models are known to have trouble running the clustered renderer, and since volumetrics are shadow dependant, this issue relates to them as well. **If you experience this, let us know what GPU brand/model, operating system and other hardware specs you're using.** Clustered lights may also act weird when running the game on Linux under DXVK, however the circumstances in which they break should not be possible in production.