explaingit

irisshaders/iris

Analysis updated 2026-07-03

3,727JavaAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

An open-source Minecraft mod that adds shader pack support for realistic visual effects like water reflections and dynamic lighting, designed to work alongside the Sodium performance mod as a free alternative to OptiFine.

Mindmap

mindmap
  root((iris))
    What it does
      Loads shader packs
      Visual effects
      OptiFine replacement
    Compatibility
      Works with Sodium
      Modded Minecraft
      OptiFine-era packs
    Tech stack
      Java
      GLSL
      Fabric modloader
    Audience
      Minecraft players
      Shader developers
      Mod contributors
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run popular Minecraft shader packs like BSL or Complementary without giving up the frame-rate improvements from the Sodium mod.

USE CASE 2

Develop new shader packs using Iris-specific APIs that go beyond what OptiFine's older shader standard supports.

USE CASE 3

Contribute bug fixes or performance improvements to an actively maintained, well-organized open-source Minecraft rendering project.

What is it built with?

JavaGLSLFabric

How does it compare?

irisshaders/irisroboguice/roboguicestfalcon-studio/chatkit
Stars3,7273,7273,725
LanguageJavaJavaJava
Setup difficultymoderatehardeasy
Complexity3/52/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Fabric mod loader and a matching Minecraft version, Sodium should also be installed separately for full benefit.

Released under LGPLv3, you can use, share, and modify the code, but changes to the library itself must remain open source. One dependency uses AGPLv3, which may affect redistribution.

In plain English

Iris is an open-source mod for Minecraft that adds support for shader packs, which are collections of visual effects that change how the game looks. Shader packs can produce effects like realistic water reflections, dynamic lighting, and atmospheric sky rendering. Iris was built to give players a free and open alternative to OptiFine, the dominant tool for loading these packs, which carries a restrictive license that limits tinkering and causes conflicts with other popular mods. One of the key reasons the project exists is compatibility with Sodium, a mod that significantly improves Minecraft's rendering performance. OptiFine and Sodium cannot run together, which forced players to choose between better visuals and better performance. Iris is designed to work alongside Sodium, so players can run their preferred shader packs without giving up the performance gains Sodium provides. The project has a set of stated goals it is still working toward: full use of the graphics card when paired with optimization mods, minimal bugs in the implementation, broad compatibility with both modded environments and existing OptiFine-era shader packs, and eventually new features for developers who create shader packs. The codebase is intended to stay well-organized so contributors can work with it comfortably. Iris has public releases for recent Minecraft versions and works with most popular shader packs. It is not considered finished software. Some OptiFine features are not yet fully replicated, and performance improvements continue to be made. Developers who make shader packs are also gaining new tools as the project matures. All code in the repository is released under the GNU LGPLv3 license, which allows anyone to read, share, and modify it within those terms. One dependency, glsl-transformer, carries an Affero GPL license that may affect redistribution. The project is supported by a community team handling support and moderation, along with open contributions from developers through pull requests.

Copy-paste prompts

Prompt 1
Set up the Iris shader mod for Minecraft alongside Sodium so I can use shader packs at high performance, list the required mods and install order.
Prompt 2
Explain how Iris loads and applies GLSL shader packs inside Minecraft and what makes its approach different from OptiFine.
Prompt 3
I want to write a custom shader pack compatible with Iris, show me the entry-point files I need and what uniforms are available.
Prompt 4
Help me troubleshoot an OptiFine shader pack that looks wrong in Iris, what features are not yet fully supported?
Prompt 5
What does the LGPLv3 license on Iris mean if I want to bundle it in a public modpack?

Frequently asked questions

What is iris?

An open-source Minecraft mod that adds shader pack support for realistic visual effects like water reflections and dynamic lighting, designed to work alongside the Sodium performance mod as a free alternative to OptiFine.

What language is iris written in?

Mainly Java. The stack also includes Java, GLSL, Fabric.

What license does iris use?

Released under LGPLv3, you can use, share, and modify the code, but changes to the library itself must remain open source. One dependency uses AGPLv3, which may affect redistribution.

How hard is iris to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is iris for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub irisshaders on gitmyhub

Verify against the repo before relying on details.