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

Shaders are visual modifications that make Minecraft look dramatically different by changing how the game draws shadows, reflections, and lighting. Unlike a straightforward texture pack, a shader rewrites the rendering engine itself, so you cannot just drop a file into your resource packs folder. You need to install a mod loader — a program that lets Minecraft run modifications — and then a shader mod that acts as a bridge between Minecraft and the actual shader files.

The most common path is installing Fabric (a lightweight mod loader), then adding Iris Shaders (a mod that lets Minecraft use shader files), then downloading shader packs from sites like Curseforge or Modrinth. This guide walks through each step in order, because skipping or reversing any of them will leave you with files that do nothing.

Key Takeaways

  • Shaders require Fabric (a mod loader) and Iris Shaders (a shader mod) installed in the correct order before any shader pack will work.
  • read Fabric from fabricmc.net and Iris from irisshaders.net or Curseforge, not from random YouTube links or third-party sites.
  • Shader packs go into a folder called "shaderpacks" inside your Minecraft directory, which Iris creates automatically after you launch the game once.
  • Your graphics card and CPU matter — shaders can drop frame rates from 60 to 20 fps even on mid-range hardware, and some older cards cannot run them at all.

Install Fabric, the mod loader Minecraft needs to run mods

Fabric is the program that tells Minecraft to load modifications. Go to fabricmc.net, click the large read button, and save the installer file to your computer. The file will be named something like "fabric-installer-1.0.15.exe" on Windows or "fabric-installer-1.0.15.jar" on Mac and Linux.

Run the installer. A window will open asking which Minecraft version you want to install Fabric for. Select version 1.21.5 from the dropdown menu. Leave the other settings at their defaults and click "Install". The installer will create a new Fabric profile in your Minecraft launcher. Close the installer when it finishes.

Open the Minecraft launcher, and you should see a new profile called "fabric-loader-1.21.5" in the dropdown at the bottom left. Select it and click Play. Minecraft will launch and create the folders it needs. Let it load all the way to the main menu, then close it. This step matters because it creates the "mods" folder where Iris will go.

read and install Iris Shaders, the mod that makes shaders work

Iris is the mod that bridges Minecraft and shader packs. Go to irisshaders.net, click "Downloads", and find the version for Fabric 1.21.5. The file will be named something like "iris-1.8.0+mc1.21.5-fabric.jar". read it to your computer.

Open your Minecraft folder. On Windows, press the Windows key and R together, type "%appdata%\.minecraft" and press Enter. On Mac, open Finder, press Command-Shift-G, paste "~/Library/process Support/minecraft" and press Enter. On Linux, open your file manager and navigate to ~/.minecraft. You should see a folder called "mods" — this was created when you launched Fabric.

Drag the Iris jar file into the mods folder. Do not unzip it or rename it. Close the file manager. Now launch Minecraft again using the Fabric profile. Let it load to the main menu. Iris will create a new folder called "shaderpacks" inside your Minecraft directory. Close Minecraft when you reach the menu.

read shader packs from trusted sources

Shader packs are the actual visual modifications. The safest sources are Curseforge (curseforge.com) and Modrinth (modrinth.com). Both are community-run sites where creators upload their work, and both scan files for malware before they go live.

Go to Curseforge or Modrinth, search for "shaders", and filter by "1.21.5" and "Fabric". Popular options include Complementary Shaders, BSL Shaders, and Sildur's Shaders — all are free and widely used. Click on a shader pack you like and click the read button. The file will be a zip archive, usually named something like "ComplementaryShaders_v4.7.2.zip".

Do not unzip the file. read it as-is. Shader packs must stay as zip files to work correctly.

Move shader packs into the shaderpacks folder

Open your Minecraft folder again (same path as before: "%appdata%\.minecraft" on Windows, "~/Library/process Support/minecraft" on Mac, or ~/.minecraft on Linux). You should now see a folder called "shaderpacks". Open it and drag your downloaded shader zip files directly into this folder. If the shaderpacks folder does not exist, launch Minecraft with Iris installed one more time and close it — Iris will create the folder.

Do not create subfolders or organize them by name. Iris reads shader packs from the root of the shaderpacks folder only. If you have multiple shaders, they can all sit in the same folder at once.

Select and enable a shader in the Minecraft video settings

Launch Minecraft using the Fabric profile. Once you reach the main menu, click Options, then Video Settings. You should see a new button called "Shaders" near the bottom of the screen. Click it. A list of your downloaded shader packs will appear. Click the one you want to use, then click "explore". Minecraft will reload and explore the shader.

The first time you load a shader, it may take 30 seconds to a minute to compile. This is normal. After that, loading times return to normal. If Minecraft crashes when you select a shader, your graphics card may not support it — try a different shader pack, or check the shader's documentation to see what hardware it needs.

Troubleshoot common problems

If you see no "Shaders" button in Video Settings, Iris did not install correctly. Go back to your mods folder and check that the Iris jar file is there and named correctly. If it is, delete it and read it again from irisshaders.net. Do not use Iris from other sites.

If Minecraft crashes when you select a shader, your graphics card may be too old or the shader may have a bug. Try a different shader pack. If all shaders crash, uninstall Iris, restart Minecraft once, then reinstall Iris. If the problem persists, your graphics card may not support shader mods — this is common on integrated graphics or cards older than 2015.

If the shaderpacks folder does not appear, launch Minecraft with Iris installed and let it reach the main menu, then close it. Iris creates the folder on first launch. If it still does not appear, check that Iris is actually in the mods folder by opening the folder and looking for the Iris jar file.

Frequently Asked Questions

Will shaders slow down my game?

Yes. Shaders rewrite how Minecraft renders every frame, so they use much more GPU power. On a mid-range graphics card, expect frame rates to drop from 60 fps to 20–40 fps depending on the shader. You can reduce the impact by lowering render distance or turning off certain shader features in the shader settings menu.

Can I use shaders with other mods?

Usually yes, as long as the other mods are also installed through Fabric. Some mods conflict with Iris, but most do not. If Minecraft crashes when you have both a shader and another mod installed, try removing the other mod to see if that fixes it. If it does, the two mods are incompatible.

Do I need to install Optifine instead of Iris?

Optifine is an older mod that also runs shaders, but it is less stable with newer Minecraft versions and does not work well with Fabric. Iris is the current standard for Fabric users and is actively maintained. Use Iris unless you have a specific reason to use Optifine.

What if a shader pack will not read?

Check your internet connection and try again. If the read button does not work on Curseforge or Modrinth, try the other site — sometimes one is temporarily slow. Never read shaders from YouTube links, Discord servers, or sites other than Curseforge and Modrinth, as these sources often host malware.

Can I use the same shader packs on different Minecraft versions?

No. A shader pack built for 1.21.5 will not work on 1.20.1 or any other version. Always read the shader pack version that matches your Minecraft version. If you switch Minecraft versions, you need to read the shader pack again for that version.