Fix: Godot 4 Shader Canvas Light Mode Add Disables Occlusion

Glowing torch with light_mode Add bleeds through walls.

Use Mix mode

Respects occluders. Pre-multiplied alpha; same look without occlusion bypass.

Or stencil pre-pass

Mark occluded regions; shader respects.

Audit per light

Each light's mode and occluder respect. Mismatched expectations = the bug.

“Light modes have different occlusion semantics. Document each.”

If your lights bleed through walls, the light_mode is the suspect. Mix is the safe default.

Related reading

• Fix: Godot Shader Canvas Light Mode Misses Secondary Lights
• Fix: Godot Shader Canvas Light Occluder Extra Shadow Frame
• Fix: Godot Shader Canvas Light Cancel After Mask Changes
• Fix: Godot Shader Canvas 2D Light Not Affecting