Invalid Shader
Shaders fail to load with an unsupported-pipeline error. The shader mod and your Minecraft version do not line up, or the shaderpack itself targets a different setup.
What does this error mean?
Shaderpacks run through a shader loader (OptiFine or Iris) that hooks Minecraft's rendering. An unsupported shader pipeline means the loader cannot apply the pack, usually a version mismatch between Minecraft, the loader, and the pack. This is a client-side issue.
Unsupported shader pipeline
Most Common Causes
- OptiFine/Iris version not matching the Minecraft version.
- A shaderpack built for a different shader loader.
- An outdated shaderpack for a newer pipeline.
- Conflicting rendering mods installed alongside.
- GPU drivers too old to support the shader features.
How To Diagnose
- Confirm the OptiFine/Iris build matches your Minecraft version.
- Check the shaderpack's supported loader and version.
- Test a known-good simple shaderpack to isolate the issue.
- Update GPU drivers and retry.
Recommended Fixes
- Match loader to version
Install the OptiFine or Iris build made for your exact Minecraft version. - Use a compatible pack
Pick a shaderpack that supports your loader and version. - Update GPU drivers
Install the latest drivers so required shader features are available. - Remove conflicting render mods
Drop other rendering mods that clash with the shader loader.
Frequently Asked Questions
Iris pairs with Sodium on Fabric for performance, OptiFine is standalone. Use whichever your pack supports.
No, shaders are entirely client-side rendering and never run on the server.
Most often a version mismatch, align the pack, the loader, and your Minecraft version.