How do I get the mod to keep my resource packs active?
It works automatically as soon as it is active in your game. Whenever a resource pack has a broken shader, the mod substitutes a default or dummy fallback shader so Minecraft does not force your entire pack list to unload.
Where do I see what went wrong with a broken shader?
The mod displays exact shader error messages directly on your screen instead of forcing you to dig through crash reports. Depending on your settings, these alerts appear in a box in the top-left corner, in your in-game chat, or in both places at once.
How can I move or hide the top-left error box?
Open the mod's configuration settings to change how alerts are displayed. You can switch the error output between the top-left overlay box, the in-game chat, or both.
How do I reload my custom shaders quickly while testing?
Use the quick hot-reload key added by the mod to refresh your shaders without going through the resource pack menu. Check your Minecraft keybind controls to see what key it is bound to or assign it to a button you prefer.
Why do some effects look like vanilla Minecraft when my resource pack has an error?
When a custom shader fails to compile or is missing files, the mod's fallback protection swaps in a default or dummy shader for that specific effect. This keeps the rest of your resource pack working normally until you fix the broken file.
What types of shader errors does this prevent from unloading my packs?
It catches compilation failures, shader linking problems, and completely missing shader programs. It also handles missing shader imports and broken or missing post-effect JSON files.
Why am I still getting error messages if the mod is supposed to protect my packs?
The mod does not fix broken shader code for you; it just stops Minecraft from panicking and turning off your resource packs. The on-screen errors are intentional so you know exactly which file is broken and using a fallback.
What happens if a shader in my pack is missing an import file?
Instead of triggering a generic crash error or unloading your packs, the mod catches the missing import and keeps your packs active. It then prints a clear error message telling you specifically about the missing import.
How do I stop shader linker messages from spamming my game logs?
Turn on the option to hide shader linker info logs in the mod's settings. This filters out routine linker clutter so your log files stay clean and easier to read when troubleshooting real errors.
Do I need this mod on a multiplayer server or just on my client?
You only need it on your client. Because resource packs, shaders, and visual post-effects are handled entirely on your own computer, the mod works on any multiplayer server without needing to be installed server-side.