Troubleshoot Shader Compatibility Issues

Common Shader Problems

When using mods that rely on Luminance for shader support, you may encounter visual glitches, missing effects, or crashes. Luminance helps fix shader namespace issues that occur in vanilla Minecraft, but problems can still arise.

Steps to Resolve Issues

1. Verify Luminance is installed — Check your mods folder to confirm Luminance is present. It's a library mod, so it won't appear as a separate menu option.

2. Ensure Iris Shaders is updated — Luminance works with Iris to handle shader rendering. Update Iris to the latest compatible version.

3. Test with a different shader pack — Some packs may have conflicts. Try switching to another shader to isolate the problem.

4. Disable other shader-dependent mods temporarily — If multiple mods use Luminance, disable them one at a time to identify conflicts.

5. Check mod load order — Ensure Luminance loads before any mods that depend on it.

6. Review shader logs — Check your game logs for shader compilation errors or namespace-related warnings.

If issues persist, the problem likely lies with a specific shader pack or dependent mod rather than Luminance itself.