INSTALLATION GUIDES

How to Install Complementary Shaders with Iris

Illustration for: How to Install Complementary Shaders with Iris

Iris is the loader most Complementary Shaders players use today: it is actively developed, it pairs with the Sodium performance mod, and it is the loader the official Complementary installer sets up for you. This guide covers installing Complementary Shaders with Iris specifically, the setup, the folder, enabling the pack, and the Iris-side options that affect how the shaders behave.

Why Iris for Complementary Shaders

  • It is the recommended route. The pack's official installation instructions begin with installing Iris, and the official installer automates exactly this combination.
  • Performance pairing. Iris is usually installed alongside Sodium, which improves the game's own rendering performance, useful headroom when a shader pack adds work of its own.
  • Current development. Iris tracks new Minecraft versions closely, which matters when you update the game, see fixing shaders after a Minecraft update.
  • Mod-loader friendly. Iris runs within Fabric (and Quilt) setups, so it fits into modded play instead of replacing it, more in Complementary Shaders with Fabric and Quilt.

What you need

  • Minecraft Java Edition, launched at least once.
  • The Complementary Shaders ZIP for your chosen style, still zipped, see the download guide and the ZIP checks.
  • The Iris installer matching your Minecraft version, from the Iris project's official distribution.

Step 1: Install Iris

  1. Run the Iris installer and select your exact Minecraft version. The installer offers to include Sodium, accept it unless you manage mods yourself and already have it.
  2. Choose install. The installer creates a new profile in the Minecraft launcher (named for Iris and your game version).
  3. Open the launcher, select the Iris profile, and launch the game once. Check the title screen: an Iris/Sodium note in the corner confirms the loader is active.

Version discipline: Iris builds are per-Minecraft-version. If you play several game versions, you need the matching Iris for each. The shader pack itself is far more flexible, the current Complementary release supports Minecraft 1.7.10 through 1.21.11 and 26.1–26.3.

The alternative: the official Complementary installer

The developers' installer downloads and installs the pack together with Iris in one flow: run it, choose Unbound or Reimagined, click install. It needs a standalone Java runtime on the machine (Minecraft's bundled Java does not run the installer). If you use it, skip to Step 3, but understanding the manual route below is still worthwhile, because it teaches you where everything lives when you later want to add the second style or update the pack.

Step 2: Add the pack to Iris

  1. In game: Options → Video Settings → Shader Packs.
  2. Click Open Shader Pack Folder. The folder that opens is Iris's shaderpacks directory inside your Minecraft folder.
  3. Copy the Complementary ZIP into it, unextracted.
  4. Back in the game, the pack appears in the list. If it does not, click away and reopen the screen, or restart the game once. Persistent absence is a known pattern with its own fixes: not showing in the shader list.

Manual folder paths for every operating system are in where to put the ZIP file.

Step 3: Enable and configure

  1. Click the pack's name in the list to apply it. Iris loads it immediately; the menu background re-renders with the new lighting.
  2. Open Shader Pack Settings (the button appears once a pack is selected). This is the pack's own options screen, profiles (Potato to Ultra), lighting, water, sky and more.
  3. Choose a profile one step below your optimism, apply, and test in a world before fine-tuning. The best settings guide walks the menus in a sensible order.

Iris-side options that matter

  • Max shadow render distance (in Iris's own settings within the shader screen): caps how far shadows are drawn, in chunks. Lowering it is one of the cleanest FPS wins that does not change the pack's look up close, see how to increase FPS.
  • The pack settings button vs Iris settings: keep the distinction clear. The pack's options change Complementary itself; Iris's options change how the loader presents packs. Most visual tuning belongs in the pack's screen.
  • Keeping both styles: drop both ZIPs in the folder; the list shows both, and each remembers its own settings. Switching between styles explains the details.

Updating later

When a new release appears, replace the ZIP in the shaderpacks folder with the new file, and read updating without losing your settings first, because your saved options are tied to the pack's filename.

Iris standalone, or Iris inside Fabric and Quilt

Iris reaches your game in two different ways, and it helps to know which one you have before you troubleshoot anything. In a standalone installation, the Iris installer creates its own launcher profile and Iris runs as the profile itself, this is the simplest setup, and the right choice if shaders are the only modification you want. In a mod-loader installation, Iris sits as one mod among others inside a Fabric or Quilt instance, alongside Sodium and whatever else your modpack uses. The shader steps are identical in both cases, same shaderpacks folder, same list, same pack settings screen, but the maintenance differs: a standalone profile is updated through the Iris installer, while a modded instance is updated file by file or through your launcher, and a broken modded instance can have causes (another mod, a loader mismatch) that a standalone profile never faces. If you are helping someone else, or following a guide written for the other arrangement, translate the steps by folder and menu rather than by installer screens.

Keeping Iris, Sodium and the pack updated, separately

An Iris setup has three moving parts, and most update confusion comes from treating them as one. Minecraft sets the target: everything else must match it. Iris (and Sodium with it) must be the build for that exact Minecraft version, when the game updates, the loader update is the step that makes shaders possible again, and until a matching Iris exists, the practical options are to wait or to keep playing the previous game version. The Complementary pack, by contrast, is version-tolerant across a wide span, the current release supports Minecraft 1.7.10 through 1.21.11 and 26.1–26.3, so a game update rarely forces a pack update, and a pack update never forces a game update. Update each part when its own reason appears: the pack when you want its newest release, the loader when your game version requires it. When you do replace the pack ZIP, remember that your settings live in the .txt file named after the ZIP, and read the update guide before swapping files so a new filename does not leave your tuning behind. Changing one component at a time, and launching once between changes, means that if something breaks you already know which change caused it.

Frequently asked questions

Do I need Fabric for Iris?

Not necessarily. Iris can be installed as a standalone profile through its installer. It also works as a mod inside Fabric and Quilt setups. Either way, the shader steps are the same.

Iris or OptiFine, which is better for Complementary?

Both run the pack; the official guidance leads with Iris, and Iris + Sodium generally gives better performance headroom. OptiFine remains a valid choice if your setup already depends on it, see Complementary Shaders with OptiFine.

The Shader Packs menu is missing. Why?

The game launched on a non-Iris profile. Check the launcher profile you selected and the title-screen corner note; without Iris running, there is no shader menu at all.