Iris and mods work together, but you need to install them in the right order

Iris is a shader loader — it lets you use shader packs that change how Minecraft looks. Most mods work fine with Iris, but Iris itself must be installed before you add shader packs. If you install mods first and then Iris, you may run into crashes or mods that stop working. The safest path is to install Fabric (the mod loader), then Iris, then your other mods.

This guide walks you through each step in the order that prevents the most common problems. You will need about 15 minutes and a clean Minecraft installation to start with.

Key Takeaways

  • Iris is a shader loader, not a mod itself, so it installs differently than regular mods.
  • You must install Fabric first, then Iris, then any other mods you want to use.
  • Shader packs go into a separate folder and do not need to be installed — Iris finds them automatically.
  • If Minecraft crashes after adding Iris, check that you are using the Iris version that matches your Fabric version.
  • Some mods conflict with Iris or shaders; if the game crashes, remove mods one at a time to find the culprit.

Install Fabric before anything else

Fabric is the mod loader that both Iris and most other mods need to run. Download the installer from fabricmc.net. Click the button for your Minecraft version (usually the latest one), then click "Download installer".

Run the installer file. A window will open asking where your Minecraft folder is — it usually finds it automatically. Click "Install" and wait for the progress bar to finish. When it says "Installation successful", close the window. Fabric is now ready.

Launch Minecraft once through the Fabric launcher to make sure it works. You should see "Fabric" in the bottom left corner of the title screen. If you see an error instead, reinstall Fabric and check that you downloaded the right version for your operating system.

Download and place the Iris mod file

Go to modrinth.com and search for "Iris". Click the Iris result (it will say "Iris" with a small eye icon). On the right side, click the version number that matches your Minecraft version. Then click "Download" next to the Fabric version.

A .jar file will download. Do not open it or run it — just save it. Open your Minecraft folder (on Windows, press Windows key + R, type %appdata%\.minecraft, and press Enter; on Mac, open Finder, press Command + Shift + G, type ~/Library/Application Support/minecraft, and press Enter). Inside the minecraft folder, open the mods folder. If there is no mods folder, create one.

Drag the Iris .jar file into the mods folder. Do not unzip it or move it anywhere else. Close the folder and launch Minecraft. If it starts without errors, Iris is installed correctly.

Add shader packs without installing them

Shader packs are different from mods — you do not install them, you just place them in a folder where Iris looks for them. Download a shader pack from sites like shadersmod.net or curseforge.com. The file will be a .zip file.

In your Minecraft folder, create a new folder called "shaderpacks" (if it does not already exist). Drag the shader pack .zip file into this folder. Do not unzip it. Launch Minecraft, go to Options > Video Settings > Shaders, and you should see your shader pack listed. Click it to turn it on.

If the shader pack does not appear, check that the .zip file is actually in the shaderpacks folder and that you did not accidentally unzip it. Iris only recognizes .zip files, not unzipped folders.

Install other mods after Iris is working

Once Iris is running and you have tested a shader pack, you can add other mods. Download mod .jar files from modrinth.com or curseforge.com. Make sure each mod says it is for Fabric and for your Minecraft version. Drag each .jar file into the mods folder, just like you did with Iris.

Launch Minecraft and check that it starts. If it crashes, the most likely cause is a mod that conflicts with Iris or with another mod you installed. Remove the last mod you added, launch Minecraft again, and see if it works. If it does, that mod is the problem. If it still crashes, remove the next-to-last mod and repeat.

Some mods that change how the game renders (like Sodium or Canvas) will crash if you use them with Iris. Iris already handles rendering, so you do not need these mods. If you want better performance, use Iris with a lightweight shader pack instead.

Troubleshoot crashes and missing files

If Minecraft crashes when you launch it with Iris installed, the most common cause is a version mismatch. Check the Iris download page and make sure you downloaded the version for your exact Minecraft version. Uninstall Iris (delete the Iris .jar from the mods folder) and download the correct version.

If Minecraft crashes when you turn on a shader pack, the shader pack may not be compatible with your graphics card or Iris version. Try a different shader pack. If all shader packs crash, uninstall Iris and reinstall it from scratch.

If Minecraft crashes after you add a new mod, that mod is likely conflicting with Iris or another mod. Remove it from the mods folder and try a different mod instead. Some mods list their conflicts on their download page — read the description before installing.

Check your graphics card and Java version

Iris and shader packs are demanding. If Minecraft runs slowly or crashes often, your graphics card may not be powerful enough. Iris works best on graphics cards made in the last five years. If your computer is older, try a simple shader pack instead of a complex one, or use Iris without any shader pack at all.

Minecraft also needs a recent version of Java. If you are not sure which version you have, launch Minecraft and look at the bottom left of the title screen — it will say "Java Edition" and a version number. If the version is older than Java 17, download a newer version from oracle.com. Uninstall the old version first, then install the new one, and launch Minecraft again.

Frequently Asked Questions

Can I use Iris with OptiFine mods?

No. OptiFine and Iris do the same job in different ways and will crash if you try to use both. Choose one or the other. Iris is usually better for shader packs, while OptiFine is better if you want to tweak individual settings.

Why does my shader pack look wrong or have missing textures?

The shader pack may not be compatible with your graphics card or Iris version. Try a different shader pack. If all of them look wrong, uninstall Iris and reinstall the latest version from modrinth.com.

Do I need to unzip shader pack files?

No. Leave them as .zip files in the shaderpacks folder. Iris reads them directly without unzipping. If you unzip them, Iris will not find them.

What if a mod says it is for Forge, not Fabric?

You cannot use Forge mods with Fabric. Download the Fabric version of the mod instead, or use a different mod that has a Fabric version. Most popular mods have versions for both loaders.

Can I use Iris on a server?

Iris works on your computer only — it changes how the game looks on your screen. Servers do not see shaders. You can use Iris on any server that allows Fabric mods.