Shaders change how Minecraft renders light, water, and sky — but they require a mod loader first

Shaders are visual mods that overhaul Minecraft's lighting, shadows, reflections, and weather effects. They make the game look dramatically different — water becomes reflective, sunlight casts real shadows, and clouds gain depth. To use them in Java Edition 1.21.5, you need to install a mod loader (usually Fabric or Forge), then download shader files, then load them through a shader mod like Iris.

The process has three separate steps, and skipping or mixing them up is the most common reason shaders don't work. This guide walks through each one in order.

Key Takeaways

  • Shaders require Fabric mod loader and the Iris shader mod installed before they will load at all.
  • You download shader files separately from the mod loader — they go into a specific folder inside your .minecraft directory.
  • Fabric is simpler to set up than Forge for shaders and works reliably with Iris on version 1.21.5.
  • If shaders don't appear in your in-game menu after installation, the most common cause is shader files in the wrong folder or a missing Iris mod.

Install Fabric mod loader for Minecraft 1.21.5

Fabric is the mod loader most players use for shaders because it's lightweight and works well with Iris. Download the Fabric installer from fabricmc.net — look for the button labeled "Download installer" on the main page. Run the installer file once it finishes downloading.

The installer window will open. Make sure the game version dropdown shows "1.21.5" — if it doesn't, click the dropdown and select it. Leave all other settings as they are and click "Install". The installer will create the Fabric loader files in your .minecraft folder automatically.

Close the installer when it finishes. You now have Fabric installed, but you won't see any change in the launcher yet — Fabric only becomes visible once you launch the game.

Download and install the Iris shader mod

Iris is the mod that actually lets Minecraft load and display shaders. Go to irisshaders.net and click "Download" in the top menu. You'll see a list of versions — find "1.21.5" and click the download link next to it. This downloads a .jar file.

Open your .minecraft folder. On Windows, press Windows key + R, type %appdata%\.minecraft and press Enter. On Mac, open Finder, press Command + Shift + G, paste ~/Library/Application Support/minecraft and press Enter. On Linux, navigate to ~/.minecraft.

Inside the .minecraft folder, open the mods folder. If it doesn't exist, create a new folder and name it "mods". Drag the Iris .jar file you downloaded into this mods folder. That's it — Iris is now installed.

Create the shaders folder and download shader files

Shader files go in a specific location that Iris creates automatically the first time you launch the game with it installed. Launch Minecraft through the launcher, select the Fabric profile (it should appear in your profile list now), and click Play. The game will load and create the necessary folders.

Once the game loads, quit back to the launcher. Open your .minecraft folder again and look for a new folder called shaderpacks. If you don't see it, create one manually and name it exactly "shaderpacks" (no spaces, lowercase).

Now download shader files. Common shader packs for 1.21.5 include Complementary Shaders, BSL Shaders, and Sildur's Vibrant Shaders. Go to curseforge.com, search for the shader pack name, and download the .zip file. Do not unzip it — shader packs stay as .zip files. Drag the .zip file into your shaderpacks folder.

Load shaders in-game and troubleshoot if they don't appear

Launch Minecraft again with the Fabric profile. Once you're in a world, press Escape to open the pause menu. Look for a button labeled "Shader Options" or "Shaders" — this button only appears if Iris installed correctly. Click it and you should see a list of shader packs you downloaded. Select one and the game will apply it immediately.

If you don't see the Shader Options button, the most common causes are: Iris didn't install to the mods folder, the mods folder doesn't exist, or you're launching the wrong profile. Go back and check that the Iris .jar file is actually in your mods folder, that the folder is named exactly "mods", and that you're launching the Fabric profile, not the default Java Edition profile.

If shaders load but your game runs slowly, lower the shader quality settings in the Shader Options menu or try a lighter shader pack. Shaders are demanding — even mid-range graphics cards can struggle with some packs at high settings.

Update shaders when new versions release

Shader packs update regularly. To update one, download the new .zip file from the same place you got the original, then replace the old .zip file in your shaderpacks folder with the new one. You don't need to uninstall the old version first — just overwrite it.

If a shader pack stops working after a Minecraft update, check curseforge.com to see if a newer version of that shader pack supports your Minecraft version. Some shader packs update quickly for new versions; others don't. If the pack you like hasn't updated, try a different one temporarily.

Frequently Asked Questions

Can I use shaders with mods like Optifine or other shader mods?

No. Iris and Optifine both try to control how Minecraft renders graphics, so they conflict. Use Iris with Fabric, not Optifine. If you were using Optifine before, uninstall it from your mods folder first.

Why do my shaders look washed out or wrong?

This usually means your graphics driver is outdated or your GPU doesn't support the shader pack fully. Update your graphics driver through your GPU manufacturer's website (NVIDIA, AMD, or Intel). If that doesn't help, try a different shader pack — some are more demanding than others.

Do I need to install Forge instead of Fabric?

Fabric is simpler and works better with Iris for shaders. Forge is heavier and slower. Use Fabric unless you need a specific mod that only works with Forge.

What if the shaderpacks folder doesn't appear after I launch the game?

Create it manually. Open your .minecraft folder, right-click in the empty space, select "New Folder", and name it "shaderpacks" exactly. Then restart the game and the folder should be recognized.

Can I use shaders on Minecraft Bedrock Edition?

No. Shaders through Iris only work on Java Edition. Bedrock has a different rendering system and doesn't support shader mods the same way.