Iris is an open-source shader mod for Minecraft: Java Edition that loads OptiFine-format and Iris-enhanced shader packs. It ships with Sodium for optimized rendering, so shaders and performance come from the same setup. Created by coderbot and maintained by IMS212 and the wider contributor team, it runs on Fabric and NeoForge and works with popular packs like Complementary and Sildur's Vibrant.
Iris is the mod that lets Minecraft load shader packs. That's the whole job. It isn't a shader pack itself, and it isn't a mod loader either: it sits between the two, and mixing those up is the single most common reason people get stuck installing shaders.
Here's the stack, top to bottom. You have Minecraft: Java Edition. You have a mod loader like Fabric or NeoForge, which lets the game run mods at all. Iris is one of those mods, and its purpose is to load shader packs. The shader pack (Complementary, Sildur's Vibrant, whatever you've picked) is a separate file that Iris reads. And bundled alongside Iris comes Sodium, which rewrites Minecraft's renderer to claw back performance.
The project is open source under the LGPL-3.0-only licence. It was created by a developer known as coderbot and is now maintained by IMS212 along with the wider Iris contributor team, who describe it as built by the community, for the community.
Officially, Iris describes itself as an open-source shader mod for Minecraft: Java Edition, and on Modrinth as a modern shader pack loader designed to be compatible with existing OptiFine shader packs.
That compatibility point matters. Shader packs have been written in OptiFine's format for years, and Iris loads them without the pack needing a rewrite. It also supports Iris-enhanced packs, ones built to use features Iris adds on top of the OptiFine format.
Iris exists because of a specific problem. OptiFine was the standard way to run shaders for a long time, but it's closed-source, has a history of clashing with other mods, and can't run alongside Sodium. The older ShadersMod stopped being updated after 1.12. So Iris was built to load existing shader packs on modern Minecraft while keeping mod compatibility and performance intact.
It's client-side only. Servers don't need it, and it doesn't change gameplay, just how your game draws the world.
This trips people up constantly, so here's the accurate version.
Iris ships with Sodium. The official site puts it plainly: Iris includes Sodium for optimal performance, out of the box. The official Iris Installer downloads and installs both together; you don't choose between them.
If you install manually instead, from Modrinth or CurseForge, the official download page states next to both options that you will also need Sodium. So Sodium isn't something you can skip on the manual route either.
The two do completely different jobs, which is why they pair so well. Sodium replaces Minecraft's rendering engine with a faster one. Iris adds shader support on top. Neither duplicates the other's work, and Iris was designed around Sodium from the start; recent Iris releases even list which Sodium version they've been updated against.
The official position is that Iris supports almost all shader packs. The project also publishes two honest documents on its GitHub: a list of shader packs that aren't supported, and a list of limitations in Iris that can't be fixed. Worth a look if a specific pack misbehaves.
Two packs we've covered in detail both work with Iris:
One thing to know about resource packs: most work fine alongside shaders, but resource packs that use core shaders (the kind that work without any mods) won't function while a shader pack is enabled.
Iris supports Minecraft 1.16.5 and everything newer, including the latest releases. The official FAQ notes that if a version is missing from the installer, it's usually because a later release covers servers on that version anyway.
On mod loaders, the official position is specific:
Forge isn't an oversight. The developers have explained that supporting it properly would mean not just running on Forge but staying compatible with sprawling Forge modpacks, and the Forge toolchain doesn't sit well with a mod that patches as much of the game as Iris does. That time goes into the Fabric and NeoForge builds instead.
Quilt is also listed as a platform on Iris's Modrinth page, though the official FAQ only names Fabric and NeoForge. If you're on Quilt, it's available; just be aware the project's own documentation is written around the other two.
Three separate things get muddled together here, so let's split them:
So an Iris setup generally runs shaders better than the alternatives, but that's Sodium doing the lifting, not Iris itself. And no shader setup makes Minecraft faster than running it with no shaders at all.
If performance is tight, the lever to pull is the shader pack's own settings. Most packs ship with quality presets (Sildur's splits into separate preset downloads, Complementary offers profiles from Potato to Ultra), and dropping down a level costs far less than you'd think visually.
They can't be used together (installing both will crash the game), so this is a genuine either/or.
Where Iris wins: it's open source, it works alongside Sodium, it keeps pace with new Minecraft releases quickly, and it plays well with modern Fabric and NeoForge mod setups. On current Minecraft versions it's often the only working option, since OptiFine has historically taken weeks to months to catch up after a release.
Where OptiFine still has a case: it's an all-in-one package, and a lot of what it does has nothing to do with shaders: connected textures, custom entity models and textures, emissive textures, zoom, dynamic lights, and a much deeper video settings menu. Iris doesn't replicate those. If your favourite resource pack depends on OptiFine-specific features, or you're playing an older version where OptiFine is well supported, it's a reasonable choice.
Iris also publishes its own list of unfixable limitations, which is worth reading rather than assuming feature parity. For most people running shaders on a recent Minecraft version, Iris is the practical pick; for players who want OptiFine's extra graphics features specifically, it isn't a straight replacement.
The official line is that most mods work with Iris. A few rendering-related mods need attention:
Hacked clients like Meteor and Wurst aren't supported. Clients such as Lunar may have their own Iris support, but any problems specific to those go to their teams rather than the Iris developers.
No. Iris is a Java Edition mod, and there's no Bedrock version.
The Iris team are blunt about why this matters: Bedrock can't be modded the way Java can because of platform restrictions, and they warn that any Bedrock shader mod on mobile that doesn't use Bedrock's own built-in features is a scam. If you're searching for "Iris shaders Bedrock" and finding download sites offering it, that's what you're looking at.
Bedrock on Windows does have legitimate options (the Iris FAQ points people toward BetterRTX), but Iris itself isn't one of them.
No. Fabric API isn't listed as a dependency for Iris, required or optional. You can run Iris without it.
That said, most other Fabric mods do depend on Fabric API, so if you're building out a modpack around your shader setup, you'll likely end up installing it for those mods rather than for Iris.
The official website is irisshaders.dev. From there you'll find the installer, plus the project's official Modrinth and CurseForge pages and the source code on GitHub.
Be a little careful with search results. Iris is popular enough to attract sites using near-identical names that present themselves as official, and older mirrors of the project site still float around with outdated instructions. If you didn't arrive via irisshaders.dev, Modrinth, CurseForge, or the project's GitHub, it's worth double-checking.
Everything official comes from irisshaders.dev. The download page gives you four routes, and the difference between them comes down to how much it does for you.
That last point is the practical difference. The installer downloads and installs Iris and Sodium together. Going the Modrinth or CurseForge route means grabbing Sodium yourself; the official download page says so directly next to both options.
If you're not comfortable managing mod files by hand, use the installer. It exists precisely so you don't have to think about any of this.
You'll also want at least one shader pack, downloaded separately from its own project page. Iris on its own gives you the menu but nothing to put in it.
.exe or the Universal JAR.Launch the game once at this point even if you have no shader packs yet; it makes sure everything is set up before you start adding files.
If you already have a modded setup, or you'd rather place files yourself:
mods folder is created..jar files into your mods folder.New to installing mods generally? Our guide to installing Minecraft mods covers the groundwork.
You can keep as many packs in the shaderpacks folder as you like and switch between them from the Shader Packs menu: no reinstalling, no restarting. Handy for testing which one your hardware handles best, or for keeping a lighter pack around for when you're doing something demanding.
Most packs also have their own settings, reachable from the same menu once the pack is selected. That's usually a better first move than swapping packs entirely if performance is the problem.
shaderpacks and not mods, then refresh the menu.Still no shaders after all that? Our guide to diagnosing shaders that will not load covers black screens, GPU selection and conflicting mods.
No builds match these filters.
No, It's not. Iris is the mod that loads shader packs. The visuals come from a separate pack like Complementary or Sildur's Vibrant, which you download and place in your shaderpacks folder.
Iris ships with Sodium: the official installer sets up both together. If you install manually from Modrinth or CurseForge instead, the official download page says you'll need Sodium as well.
It depends what you need. Iris is open source, runs with Sodium, and updates to new Minecraft versions quickly, usually the better choice on current versions. OptiFine bundles extra graphics features Iris doesn't have, like connected textures and custom entity models. They can't be used together.
No. Fabric API isn't listed as a dependency for Iris. Most other Fabric mods do need it, so you may end up installing it for them, but not for Iris itself.
Yes, it does.
Usually because the zip was extracted; it needs to stay zipped. Also check it's in the shaderpacks folder rather than mods, then refresh the menu.
Iris itself isn't a performance mod; it loads shaders. The Sodium component that ships with it is what improves rendering performance. Shader packs themselves reduce FPS, since they add rendering work.
Sildur's Vibrant Shaders is a long-running shader pack for Minecraft, built around reworked lighting, water reflections, and weather effects. It ships in several presets from Lite to Extreme, so it scales from older laptops and Intel graphics up to dedicated GPUs. One current download covers the supported Minecraft versions, and it runs on both Iris and OptiFine.
Complementary Shaders is a shader pack for Minecraft: Java Edition by EminGT, known for detailed lighting, water, and sky effects along with custom visuals for nearly every block in the game. It comes in two styles (Reimagined for a polished vanilla look and Unbound for something more realistic), which differ only in their default settings and can be freely customized either way. Quality profiles running from Potato to Ultra let you match it to your hardware.
MakeUp - Ultra Fast Shaders is a Minecraft: Java Edition shaderpack by XavierFST built around optional effects: almost everything it renders can be switched off, so how fast it runs depends on the configuration you build rather than on a preset someone chose for you. One download covers every supported Minecraft version on both Iris and OptiFine, and it supports Distant Horizons and Voxy under Iris.