Troubleshooting & Fixes

Fixes for the common Complementary Shaders problems: black screens, missing shader entries, crashes and broken effects.

A triage guide for when Complementary Shaders will not load, apply or look right, work through the checks in order and find your symptom's fix.

Troubleshooting & Fixes

A black or blank world after enabling Complementary Shaders usually has a short list of causes. Here they are, in the order worth checking.

Troubleshooting & Fixes

The ZIP is in the folder but the shader list is empty? The folder, file and loader checks that explain almost every 'not showing up' case.

Troubleshooting & Fixes

Crashes when enabling Complementary Shaders or loading a world: how to read the situation, isolate the cause, and get back to a stable setup.

Troubleshooting & Fixes

When Complementary Shaders loads but looks wrong, flickering shadows, dead water, washed-out light, these are the settings and conflicts to check.

Troubleshooting & Fixes

Minecraft updated and Complementary Shaders broke? The loader-first checklist that fixes most post-update problems without losing your setup.