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.
| Fix | When to use it |
|---|---|
| Select and enable your Iris pack | Your pack is not selected or shaders are disabled |
| Toggle or reload Iris shaders | You accidentally switched shaders off or need to reload them |
| Install matching Iris and Sodium builds | You have Sodium alone or mismatched game versions |
| Match the mod loader | Your Iris build does not match Fabric or NeoForge |
| Correct the Sodium dependency | Iris reports a missing or incompatible dependency |
| Install standalone Java | Your JAR installer will not open |
| Remove conflicting rendering mods | Your Iris installation includes incompatible mods |
| Check mod and resource-pack compatibility | You use Distant Horizons, Voxy, or core-shader resource packs |
| Install matching OptiFine | Your OptiFine build does not match Minecraft |
| Select your OptiFine pack | Your shader menu is set to OFF |
| Disable conflicting quality settings | OptiFine reports an antialiasing or anisotropic-filtering conflict |
| Disable Fast Render | OptiFine explicitly reports that conflict |
| Reset Iris pack options | Your custom settings caused rendering problems |
| Reduce Iris shadow distance | Your frame rate is poor and the control is enabled |
| Reduce OptiFine rendering quality | Your shaders work but run slowly |
| Contact the pack developer | Only one shader pack fails |
| Select the more capable GPU | Your Windows 11 PC has multiple GPUs |
| Update the graphics driver | You need the appropriate NVIDIA or AMD driver |
| Roll back the graphics driver | Rendering broke after a driver update |
| Enable Vibrant Visuals | You use Bedrock on a compatible device |
| Check hardware eligibility | Your Bedrock graphics option is disabled |
| Choose compatible content | Your world or texture pack prevents Vibrant Visuals from working |
| End local split-screen | Bedrock switches away from Vibrant Visuals |
| Update Bedrock | You need graphics fixes or Nintendo Switch 2 support |
| Reduce Vibrant Visuals demands | Your compatible device runs the mode slowly |
| Open a ray tracing world | You 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.