irisshaders.dev

Iris Shaders supports Minecraft: Java Edition 1.16.5 and higher. On the mod loader side, it supports Fabric on 1.16.5 and higher, and NeoForge on 1.21.1 and higher. Forge is not supported. If your setup falls outside those combinations, Iris is not the right shader mod for you.

Version and loader support at a glance

Two details worth knowing:

• Fabric covers the full range. Any version from 1.16.5 upward can run Iris on Fabric.
• NeoForge starts at 1.21.1. Older NeoForge versions are not supported.

Why some versions are missing from the installer

If a Minecraft version you play doesn't appear in the Iris installer, it was likely removed on purpose. According to Iris, versions are dropped when the next release is compatible with servers running that version — so you can still join those servers with a newer Iris build instead of needing a separate download.

What Iris includes and where to get it

Iris ships with Sodium for optimized rendering out of the box, so you don't need to install Sodium separately. You can grab both through the Iris installer, or from Modrinth and CurseForge.

Common compatibility questions

Does Iris work with OptiFine shader packs?

Yes. Iris is compatible with OptiFine shader packs as well as Iris-enhanced packs.

Do other rendering mods work with Iris?

Most mods work, but some that change rendering need attention:

• Nvidium — disables itself when shaders are enabled, but can stay installed alongside Iris.
• Voxy and Distant Horizons — compatible only with some shader packs; the pack must explicitly support them.
• OptiFine, Canvas, or Vulkan mods — incompatible and will crash the game.
• Indium — fine below 1.21.1; do not use it on 1.21.1 or higher.
• Hacked clients (Meteor, Wurst) — not supported.
• Non-hacked clients like Lunar Client — may be supported by their own team, but you must contact them for client-specific issues.

Do texture packs work?

Most texture packs just work. Resource packs that use "core shaders" (shaders that don't require mods) will not work while a shader pack is enabled.

Does Iris run on Bedrock Edition?

No. Bedrock Edition cannot be modded this way due to restrictions on mobile devices. Any mobile Bedrock "shader mod" that doesn't use the game's built-in features is a scam. On Windows, BetterRTX is a legitimate alternative worth checking out.

Quick decision guide

• On Fabric, 1.16.5 or newer? Iris will work.
• On NeoForge, 1.21.1 or newer? Iris will work.
• On Forge, any version? Iris will not work — you'd need to switch loaders.
• On Bedrock Edition? Iris is not available.

Iris is an open-source shader mod for Minecraft: Java Edition that runs OptiFine shader packs and Iris-enhanced packs, and it ships with Sodium for optimized rendering. If a shader pack isn't loading or applying, the cause is usually one of three things: the pack doesn't support your device, a rendering mod in your setup conflicts with Iris, or the pack itself has a bug. Iris states that some shaders may not support some devices, so a pack failing on your hardware isn't automatically an Iris problem.

Check for incompatible rendering mods first

This is the most common and most fixable cause. Iris lists specific mods that change rendering and how they behave:

If you have OptiFine, Canvas, or a Vulkan mod installed alongside Iris, remove it. If you're on 1.21.1 or newer, remove Indium. If you use Voxy or Distant Horizons, confirm the shader pack you chose actually supports them.

Rule out a device or pack limitation

Iris aims for broad compatibility, but it explicitly notes that some shaders may not support some devices. Before assuming Iris is broken:

• Try a different shader pack. If a second pack loads correctly, the problem is the first pack, not Iris.
• Check the pack's own documentation for hardware requirements or known issues.
• Confirm the pack is meant for your Minecraft version — Iris supports all versions 1.16.5 and higher, but a pack built for a different version may not load.

Decide who to contact

Iris gives a clear split for where to report a problem:

• If you believe the shader not loading is due to an issue in Iris, join the Iris Discord and report it there.
• If the shader itself is the problem, contact the shader developer instead.

The practical test: if other packs work and only one fails, it's the pack developer's issue. If no pack loads at all on a supported version and loader, it's more likely an Iris or setup issue.

Verify your base setup is supported

A shader can't work if Iris itself isn't running correctly. Confirm:

• Version: Minecraft 1.16.5 or higher. Versions missing from the installer were likely removed because the next release is compatible with servers on that version.
• Mod loader: Fabric on 1.16.5 and higher, or NeoForge on 1.21.1 and higher. Forge is not supported.
• Installation: Iris ships with Sodium, and both are available through the Iris installer or from Modrinth and CurseForge.

If you're on Forge, or on a version below 1.16.5, Iris will not run and no shader pack will load.

A note on resource packs and Bedrock

• Resource packs that use "core shaders" (shaders that don't require mods) will not work while a shader pack is enabled. Most ordinary texture packs work fine.
• Iris does not run on Bedrock Edition. Iris states that any shader mod for Bedrock on mobile that doesn't use the game's built-in features is a scam. On Windows, BetterRTX is suggested as an alternative.

Quick checklist

1. Remove OptiFine, Canvas, or Vulkan mods; remove Indium on 1.21.1+.
2. Confirm you're on Fabric 1.16.5+ or NeoForge 1.21.1+.
3. Test a second shader pack to isolate whether the problem is the pack or Iris.
4. If one pack fails and others work, contact that pack's developer.
5. If nothing loads on a supported setup, report it in the Iris Discord.

Most mods work with Iris, but a handful of rendering-related mods and clients are either incompatible or only partially compatible. According to Iris's own FAQ, OptiFine, Canvas, and Vulkan mods will crash the game, Nvidium disables itself when shaders are on, Voxy and Distant Horizons need shader packs that explicitly support them, and Indium should not be used on 1.21.1 or higher. Hacked clients are not supported at all.

Compatibility at a glance

Rendering mods that need attention

Nvidium

Nvidium can be installed alongside Iris, but it will disable itself whenever shaders are enabled. If your main reason for using Nvidium is its rendering path, enabling a shader pack effectively turns it off.

Voxy and Distant Horizons

These are compatible with some shader packs only. The shader pack itself must explicitly support them — installing Iris alone is not enough. If a pack doesn't list support, expect visual issues or missing functionality rather than a guaranteed crash.

Indium

Indium works below 1.21.1, but should not be used on 1.21.1 and higher. If you're on a newer version and still have Indium installed, remove it.

Mods that will crash the game

OptiFine, Canvas, and Vulkan mods are incompatible with Iris and will crash Minecraft. This matters most for OptiFine, since many players install it out of habit for shader support — with Iris, it needs to be removed entirely, not just disabled alongside it.

Clients

• Hacked clients such as Meteor and Wurst are not supported.
• Non-hacked clients such as Lunar Client may work, but any support for issues specific to that client must come from its own team. Iris does not handle client-exclusive problems.

Texture and resource packs

Most texture packs work normally. The exception is resource packs that use "core shaders" (shaders that don't require mods) — these will not work while a shader pack is enabled.

If a shader still doesn't load

Iris aims for broad compatibility, but some shaders may not support some devices. If you believe the failure is caused by Iris itself, the FAQ directs you to the project's Discord. Otherwise, contact the shader developer — the issue is likely on the pack's side.

Bedrock Edition

Iris does not run on Bedrock Edition, and Bedrock cannot be modded the same way due to restrictions on mobile devices. Any mobile "shader mod" for Bedrock that doesn't use the game's built-in features is a scam. On Windows, BetterRTX is the alternative Iris points to.

Getting Iris and Sodium

Iris ships with Sodium for optimized rendering out of the box. Both are available through the Iris installer, or from Modrinth and CurseForge.

Iris Shaders is an open-source shader mod for Minecraft: Java Edition, distributed at irisshaders.dev. It lets you run shader packs — including OptiFine-compatible packs and Iris-enhanced packs — and it ships with Sodium for optimized rendering out of the box. If you play Java Edition on Fabric or NeoForge and want shaders without switching to OptiFine, Iris is the tool this site provides.

What Iris actually does

Iris is a rendering mod, not a shader pack itself. You install Iris, then load a separate shader pack through it. The site describes two compatible categories:

• OptiFine shader packs — packs written for OptiFine's shader format
• Iris-enhanced packs — packs that take advantage of Iris-specific features

Because Sodium is bundled, you get the performance benefits of Sodium's rendering optimizations alongside shader support, rather than running a shader mod on top of unoptimized rendering.

Version and mod loader support

Versions missing from the installer were likely removed because the next release is compatible with servers on that version, according to the site's FAQ.

How to get it

Iris is available through three routes:

1. The official installer — the site's primary download method
2. Modrinth
3. CurseForge

The installer is the simplest path since it handles Iris and Sodium together. If you manage mods manually or through a launcher, Modrinth and CurseForge both host the files.

Compatibility notes worth knowing before you install

Most mods work with Iris, but rendering-related mods are the common exceptions:

• Nvidium — disables itself when shaders are enabled, but can stay installed
• Voxy and Distant Horizons — compatible only with some shader packs; the pack must explicitly support them
• OptiFine, Canvas, or Vulkan mods — incompatible and will crash the game
• Indium — fine below 1.21.1, but should not be used on 1.21.1 or higher
• Hacked clients (Meteor, Wurst) — not supported
• Other clients (e.g. Lunar Client) — may have support from their own team, but you must contact them for client-specific issues

For texture packs: most just work. Resource packs that use "core shaders" (shaders that don't require mods) will not work while a shader pack is enabled.

If a shader doesn't load

Iris aims for broad compatibility, but some shaders may not support some devices. If you believe the failure is an Iris bug, the site directs you to their Discord. Otherwise, contact the shader pack's developer — the issue is likely on the pack side.

Bedrock Edition

Iris does not run on Bedrock Edition. The site notes that Bedrock cannot be modded this way due to restrictions on mobile devices, and that any mobile Bedrock "shader mod" not using built-in features is a scam. Windows users are pointed toward BetterRTX instead.

No. Iris is an open-source shader mod for Minecraft: Java Edition only, so it cannot be installed on Bedrock Edition, including the mobile (Android/iOS) and console versions. If you are on Bedrock and especially on mobile, any "shader mod" that claims to add Iris-style shaders without using Bedrock's built-in features should be treated as a scam.

Why Iris Can't Run on Bedrock or Mobile

Iris is distributed as a mod for Java Edition, which means it depends on the Java modding ecosystem (Fabric or NeoForge) and the Java game client. Bedrock Edition is a separate codebase with a different add-on system and no support for Java mods like Iris.

On mobile specifically, the platform restrictions prevent the kind of modding Iris relies on. That is why the Iris project states plainly that any mobile Bedrock "shader mod" not using the game's built-in features is a scam — there is no legitimate way to load Iris there.

What Iris Actually Supports

If you want to use Iris, you need Java Edition plus a supported mod loader:

Iris is compatible with OptiFine shader packs as well as Iris-enhanced packs, and it ships with Sodium for optimized rendering. You can get it through the Iris installer, Modrinth, or CurseForge.

If You're on Bedrock (Including Windows)

Bedrock Edition cannot be modded the way Java can, so Iris is not an option. On Windows, the Iris project points to BetterRTX as a Bedrock-side alternative worth checking out. On mobile, there is no equivalent — rely only on features built into the game itself, and be skeptical of anything promising otherwise.

Quick Decision Guide

• You play Java Edition (1.16.5+) → Use Iris with Fabric or NeoForge; grab it via the installer, Modrinth, or CurseForge.
• You play Bedrock on Windows → Iris won't work; look into BetterRTX.
• You play Bedrock on mobile or console → Iris is not available, and third-party "shader mods" claiming otherwise are not legitimate.

One more note: Iris is a rendering mod, so it does not run alongside incompatible rendering mods like OptiFine, Canvas, or Vulkan mods — those will crash the game. That constraint applies to Java Edition setups, but it's worth knowing before you try to combine tools.