Menu

Guidefor players3 min read

Setting up Sodium and Iris for shaders

OptiFine is no longer the default answer. Sodium plus Iris is faster, actively maintained, and runs most shader packs. What to install and in what order.

What each piece does

Four names, and it is worth knowing which does what before installing anything:

  • Sodium replaces Minecraft's rendering engine. Large frame rate improvement, no visual change. Useful on its own.
  • Iris adds shader support and loads OptiFine-format shader packs. It requires Sodium.
  • A shader pack is the actual look: the lighting, water, shadows. Iris loads it.
  • Fabric API, which almost everything on Fabric needs.

Sodium alone makes the game faster. Sodium plus Iris plus a shader pack makes it prettier and slower, with Sodium buying back part of the cost. That is the trade, and it is why the two are usually installed together.

Installing

  1. Install a loader. Fabric is the usual choice here and reaches new Minecraft versions soonest. Sodium and Iris both have NeoForge builds now; Fabric remains where they are most at home. See which loader should you use.

  2. Install Fabric API into mods/. Skipping this is the most common reason a fresh setup loads nothing at all.

  3. Install Sodium. Start the game once and confirm the frame rate improved. Do this before adding anything else, so you know it works on its own.

  4. Install Iris. It needs a Sodium version built for the same Minecraft version. The shader pack catalogue and each mod's page list exact versions.

  5. Put shader packs in shaderpacks/, not mods/. Then in the game: Options, Video Settings, Shader Packs.

Match every version exactly: the Minecraft version, the loader, Sodium, Iris and Fabric API all have to agree. Filtering the catalogue by your exact version gives a list where they do.

Picking a shader pack

Shader packs vary enormously in cost. Roughly:

  • Light packs add better water and slightly softer shadows. Often playable on integrated graphics.
  • Mid-range packs add volumetric light, proper shadows and reflections. Want a real graphics card.
  • Heavy and path-traced packs simulate light properly. Want a very good graphics card and will still halve your frame rate.

Nearly every pack ships quality presets. Start on the lowest, confirm it runs, and work upwards. Installing the most impressive pack at maximum settings on the first attempt is how people conclude shaders do not work on their machine.

The shader pack catalogue filters by Minecraft version and by shader loader, so you can see what actually targets Iris rather than OptiFine.

Mods worth adding alongside

If you are already here for performance:

  • Lithium — server-side game logic optimisation. Client and server both benefit.
  • FerriteCore — reduces memory use, which helps most on machines short of RAM.
  • Entity Culling — skips rendering entities you cannot see. Large gains in mob-heavy areas.
  • ImmediatelyFast — speeds up the immediate-mode rendering the interface uses.

All are client-safe, all work on vanilla servers, and none change how the game plays. Browse performance mods for the current set at your version.

When it does not work

The game starts with no mods loaded. Fabric API is missing. This is the answer more often than anything else.

Iris is installed but there is no Shader Packs button. Iris and Sodium are on mismatched versions. Both must be built for the same Minecraft version.

Shaders load but everything is black, or the world is invisible. The pack does not support your Minecraft version, or your graphics driver is out of date. Update the driver first; it is free and it is frequently the cause.

Enormous frame rate drop with a light pack. The game is probably running on integrated graphics rather than your dedicated card. This is a driver and operating system setting, not a Minecraft one.

About OptiFine

OptiFine is not dead and it is not the default any more. Its rendering is slower than Sodium's, it reaches new Minecraft versions later, and it conflicts with many Fabric mods.

It still has features nothing else fully replicates, particularly custom entity models and some resource pack extensions. If a resource pack you care about needs OptiFine, use OptiFine. Otherwise the Sodium and Iris pair is faster and keeps up with the game better.

Frequently asked

Do I still need OptiFine?

Usually not. Sodium is faster for rendering, Iris handles shaders, and between them they cover what most people used OptiFine for. OptiFine still has features nothing else replicates, such as custom entity models, and it is slower to reach new Minecraft versions.

Can I use OptiFine shader packs with Iris?

Most of them, yes. Iris was built to be compatible with the OptiFine shader format. A few packs use OptiFine-specific features and behave differently or not at all.

Are these server-side?

No. Sodium and Iris are client-only. You can use them joining any server, including vanilla ones, and the server neither knows nor cares.

Will shaders lower my frame rate?

Yes, considerably. Shaders rewrite how the game draws light and shadow, which is expensive. Sodium buys back some of the cost, which is why the pair is worth running together.

Referenced on this site

Last reviewed 2026-07-27. Version data on this site updates automatically; this guide is reviewed by hand when the ecosystem changes.