How to Fix Minecraft Shaders Not Working

Fix Minecraft shaders not working by enabling your pack, matching your loader to the game version, and resolving graphics or mod conflicts.

Contents

Don't Miss the Good Stuff

Get tech news that matters delivered to your inbox.

Fix Minecraft shaders not working by enabling your shader pack, matching Iris or OptiFine to your Minecraft version, and resolving incompatible rendering mods. In Bedrock Edition, check Vibrant Visuals hardware and content compatibility. The Windows graphics troubleshooting below uses Windows 11 menus.

The short version

  • Enable the pack: In Iris, select your pack, choose Shaders: Enabled, and select Apply.
  • Match your installation: Your shader loader must match your Minecraft version and mod loader.
  • Check conflicts: Iris conflicts with OptiFine, Canvas, and Vulkan rendering mods.
  • Use the Bedrock route: Vibrant Visuals needs compatible hardware and content.

FixWhen to use it
Select and enable your Iris packYour pack is not selected or shaders are disabled
Toggle or reload Iris shadersYou accidentally switched shaders off or need to reload them
Install matching Iris and Sodium buildsYou have Sodium alone or mismatched game versions
Match the mod loaderYour Iris build does not match Fabric or NeoForge
Correct the Sodium dependencyIris reports a missing or incompatible dependency
Install standalone JavaYour JAR installer will not open
Remove conflicting rendering modsYour Iris installation includes incompatible mods
Check mod and resource-pack compatibilityYou use Distant Horizons, Voxy, or core-shader resource packs
Install matching OptiFineYour OptiFine build does not match Minecraft
Select your OptiFine packYour shader menu is set to OFF
Disable conflicting quality settingsOptiFine reports an antialiasing or anisotropic-filtering conflict
Disable Fast RenderOptiFine explicitly reports that conflict
Reset Iris pack optionsYour custom settings caused rendering problems
Reduce Iris shadow distanceYour frame rate is poor and the control is enabled
Reduce OptiFine rendering qualityYour shaders work but run slowly
Contact the pack developerOnly one shader pack fails
Select the more capable GPUYour Windows 11 PC has multiple GPUs
Update the graphics driverYou need the appropriate NVIDIA or AMD driver
Roll back the graphics driverRendering broke after a driver update
Enable Vibrant VisualsYou use Bedrock on a compatible device
Check hardware eligibilityYour Bedrock graphics option is disabled
Choose compatible contentYour world or texture pack prevents Vibrant Visuals from working
End local split-screenBedrock switches away from Vibrant Visuals
Update BedrockYou need graphics fixes or Nintendo Switch 2 support
Reduce Vibrant Visuals demandsYour compatible device runs the mode slowly
Open a ray tracing worldYou need compatible resources to check Bedrock ray tracing

Enable and reload your Iris shader pack

In Java Edition with Iris, open Options > Video Settings > Shader Packs.... Select Open Shader Pack Folder... and put your downloaded shader pack in that folder. Return to the shader screen, select the pack, change Shaders: Disabled to Shaders: Enabled, and select Apply.

An accidental keyboard toggle can switch shaders off. With Iris’s default bindings, press K to toggle shaders. In Iris for Minecraft 26.2 and 26.3, press F3+R to reload shaders and I to open shader-pack selection; plain R reloads only when Iris debug options are enabled. Iris builds for 26.1 and earlier use R to reload and O to open shader-pack selection. Your remapped bindings take precedence over these defaults.

Sodium alone does not provide shader-pack support. If your installation only has Sodium, install a matching Iris setup. If you use OptiFine, follow its shader-menu steps below.

Match Iris to your game and mod loader

Open the official Iris download page and choose Download for Windows or Download Universal JAR. Run the installer, select the Minecraft version you intend to play, and install Iris and Sodium together. Launch the resulting Iris installation.

For an existing modded setup, match the Iris build to both Minecraft and the mod loader. Iris supports Fabric and NeoForge, but you must not install its Fabric or NeoForge builds into Forge. Choose a build available for your game version rather than assuming the newest loader supports every release.

If Iris reports a Sodium dependency error, rerun the Iris installer or replace the incorrect dependency manually. Removing the incorrect Sodium file takes that build out of the installation. Close Minecraft, remove the incorrect file, place the compatible Sodium build required by Iris in that installation’s mods folder, and relaunch.

If the JAR installer will not open, install a suitable standalone Java runtime and reopen it. Use the Eclipse Temurin download page to choose the operating system, architecture, package type, and Java version required by the installer. You do not need to replace the runtime of an already working Minecraft installation for this installer step.

Resolve conflicting rendering mods and resource packs

Iris identifies OptiFine, Canvas, and Vulkan rendering mods as incompatible. Removing those mods takes them out of that Iris installation. Close Minecraft, remove their files from that installation’s mods folder, then relaunch.

On Minecraft 1.21.1 and newer, Indium also conflicts with Iris. Removing its file takes Indium out of that installation. Close Minecraft, remove Indium from the installation’s mods folder, and relaunch.

For Distant Horizons or Voxy, select a shader pack that explicitly supports the particular mod you use. Alternatively, you can remove the conflicting mod, which takes it out of that installation. Also disable resource packs that replace Minecraft’s core shaders while using an Iris shader pack.

Use the matching OptiFine controls

If you use OptiFine, find your exact Minecraft version on the official OptiFine download page. Check whether the build is a preview and whether Forge compatibility is listed, then install only a matching build. Keep OptiFine in a separate installation from Iris.

In an OptiFine build with shader controls, open Video Settings > Shaders... > Shaders Folder. Place the shader pack there, return, and select it instead of OFF.

When OptiFine displays an antialiasing or anisotropic-filtering compatibility warning, open Video Settings > Quality.... Set Antialiasing to OFF and restart Minecraft, then set Anisotropic Filtering to OFF. Apply these changes only to OptiFine builds exposing those settings and warnings.

If OptiFine explicitly reports a conflict with Fast Render and exposes that control, open Video Settings > Performance.... Set Fast Render to OFF.

Restore shader settings and reduce rendering demands

If Iris visuals broke after you customized a pack, restore its options. Resetting replaces your custom shader-pack options with their defaults. Open Shader Packs... > Shader Pack Settings..., hold Shift, and click Reset.

For poor frame rates in Iris, open Video Settings and reduce Max Shadow Distance when the control is enabled. A pack that specifies its own shadow distance disables this control. Reducing shadow distance addresses rendering load; it cannot repair incompatible shader code.

For poor frame rates with OptiFine, open Video Settings > Shaders... and reduce Render Quality or Shadow Quality. If only one pack fails, contact that pack’s developer.

Check your graphics processor and driver

On a Windows 11 PC with multiple GPUs, try selecting the more capable GPU for Minecraft. Open Start > Settings > System > Display > Graphics. If the relevant game application is listed under Custom options for apps, select it and choose Options.

Select High performance, then select Save and restart the game. Applying this Windows graphics preference to Minecraft is a troubleshooting option, not a guaranteed shader fix.

For supported NVIDIA or AMD hardware, find and update your graphics driver using the manufacturer’s driver appropriate to your GPU and operating system. NVIDIA provides drivers for supported Windows and Linux systems. AMD offers product selection and a Windows automatic detection tool.

If rendering broke immediately after a driver update, you can roll back on Windows 11 when you have administrator permissions and an available previous driver. Rolling back replaces the currently installed graphics driver with the previous one. Right-click Start, open Device Manager, expand Display adapters, and right-click your GPU.

Select Properties > Driver > Roll Back Driver, choose the applicable reason, and select Yes. Restart if prompted. If a previous driver is unavailable, use the appropriate manufacturer driver for your supported hardware instead.

Check Bedrock Vibrant Visuals compatibility

In Bedrock Edition on a compatible device, open Settings > Video from Minecraft’s main menu and set Graphics Mode to Vibrant Visuals. Old HAL-based Bedrock shader packs stopped working after the RenderDragon transition on Android, iOS, Nintendo Switch, and Windows UWP x86. Use modern compatible content such as Vibrant Visuals on an eligible device instead of reimporting those old packs.

If the graphics option is disabled, check your hardware eligibility. Minecraft lists Android Adreno 640, Mali-G68, Mali-G77, or Xclipse 530 or higher; iOS A12 or M1 or higher; and Windows running Minecraft on DX12. These requirements do not guarantee compatibility for every device variant.

Content compatibility matters separately from hardware. In Marketplace, choose content carrying the Vibrant Visuals label and try it when an existing world or texture pack prevents the mode from working. If you are playing local split-screen, end split-screen and play with one local player, because split-screen makes Minecraft switch away from Vibrant Visuals.

Update Bedrock to 26.60 or a subsequent compatible release for fixes that include some PlayStation crashes and unresponsive graphics controls. Version 26.60 also adds Nintendo Switch 2 support with Vibrant Visuals. That support concerns Nintendo Switch 2 specifically, not the original Nintendo Switch.

For slow performance on a compatible device, open Settings > Video and choose Favor Performance. Expand Vibrant Visuals Options for individual adjustments. These settings reduce performance demands; they do not resolve incompatible shader imports.

Test Bedrock ray tracing with compatible content

For Bedrock ray tracing on a qualifying Windows PC, open Marketplace and select a world identified as supporting ray tracing. Download and open that world to check the feature with its required resources.

You need a hardware ray tracing GPU, such as NVIDIA RTX 20-series or newer or AMD RX 6000-series or newer, alongside the other system requirements. This setup applies specifically to Bedrock for Windows. VR and mixed-reality headsets are unsupported for this ray tracing setup.

Frequently Asked Questions

Can Complementary install both the shader pack and Iris?

Yes, Complementary’s automatic installer installs Complementary and Iris together and lets you choose the desired visual style. Use it with a Minecraft version supported by the current installer and Iris.

Why will the Complementary installer not open even though Minecraft runs?

Complementary says its installer requires a suitable standalone Java runtime because Minecraft’s bundled Java is insufficient. Your game can run while the installer’s Java requirement remains unmet.

Why are normal and specular material effects missing in OptiFine?

Open Video Settings > Shaders... and enable Normal Map and Specular Map when your shader and resource pack supply those materials. These switches cannot create material textures that your pack does not include.

Is OptiFine shader FXAA the same as its antialiasing compatibility setting?

No, shader-menu FXAA is separate from the Antialiasing setting associated with OptiFine’s compatibility warning. You should not treat that warning’s fix as an instruction to disable every antialiasing control.

Can an old Sildur’s Fabulous tutorial fix a current Java installation?

Sildur’s vanilla Fabulous resource-pack route is limited to Minecraft 1.16.5. For other versions, use a matching shader-loader installation rather than treating that older route as a general fix.

Who should help when the problem is specific to Iris or a third-party client?

For a failure that appears to be in Iris, select Support on the official Iris site. If the problem is unique to a third-party Minecraft client, contact that client’s team.

Share