How to Install Minecraft Shaders
Two paths get you glowing sunlight and reflective water in Java Edition: the modern Iris + Sodium route, or classic OptiFine. Here is the full setup for both, plus how to pair shaders with a texture pack.
To install Minecraft shaders, install Fabric and add the Iris Shaders
mod (it includes Sodium) to your .minecraft/mods folder, or run the
OptiFine installer instead. Then drop the shaderpack .zip
into the .minecraft/shaderpacks folder, launch the modded profile, and
enable the pack under Video Settings → Shader Packs.
Iris + Sodium install (recommended)
Iris is the modern shader loader for Java Edition. It runs on the Fabric mod loader and ships with Sodium, a rendering engine that usually makes the game run smoother than vanilla even before a shader is added. For most players in 2026 this is the route to pick: it is free, open-source, and updates to new Minecraft versions quickly.
Step 1 — Install Fabric
Download the Fabric installer from the official Fabric site and run it. Choose your
exact Minecraft version (for example 1.21.x), click install, then open
the Minecraft launcher — a new fabric-loader profile will appear in the
version dropdown. Launch that profile once so Fabric finishes setting up, then quit.
Step 2 — Add Iris (Sodium is included)
Download Iris for your Minecraft version. The Iris download bundles a matching build
of Sodium, so you do not need to install Sodium separately. Move the downloaded
.jar into your mods folder:
- Windows: press
Win + R, type%appdata%\.minecraft, and open themodsfolder (create it if it is missing). - macOS: in Finder choose Go → Go to Folder and enter
~/Library/Application Support/minecraft/mods. - Linux: open
~/.minecraft/mods.
Start the Fabric profile again. If Iris loaded correctly you will see a Shader Packs button inside Options → Video Settings.
Step 3 — Allocate enough memory (optional)
Shaders are demanding. In the launcher under Installations → your Fabric profile → More Options, you can raise the JVM memory if you have RAM to spare. This is optional and only helps if the game is short on memory; it will not magically boost a GPU-bound setup.
OptiFine install
OptiFine is the long-standing all-in-one option. It adds shader support plus dozens of video tweaks, connected textures, and dynamic lighting. It is a closed-source download and tends to update a little later than Iris after a new Minecraft release, but it remains a solid choice — especially if you also want its extra rendering features in one install.
Step 1 — Run the OptiFine installer
Download the OptiFine version that matches your Minecraft version from the official
OptiFine site. It comes as a .jar file — double-click it and click
Install. (OptiFine needs Java installed on your system to run the installer.)
When it finishes, an OptiFine profile appears in the launcher.
Step 2 — Launch the OptiFine profile
Select the new profile and start the game. OptiFine can run on its own or be added as a mod on Forge if you use other Forge mods — but for a plain shader setup, the standalone OptiFine profile is all you need. Its shader menu lives under Options → Video Settings → Shaders.
Not sure which loader to commit to? Our Iris vs OptiFine comparison breaks down performance, features, and update speed side by side.
Adding a shaderpack
Iris and OptiFine only load shaders — you still need to add an actual shaderpack (the file that defines the lighting, shadows, water, and sky). Popular packs include Complementary, BSL, Sildur's, and Photon. The steps are the same for both loaders:
- Download a shaderpack. It will be a
.zipfile — do not unzip it. - Open the
shaderpacksfolder inside.minecraft(the easiest way: click Open Shader Pack Folder from the in-game shader menu, which creates the folder for you). - Drop the
.zipstraight into that folder. - Back in Video Settings → Shader Packs (or Options → Shaders on OptiFine), click the pack to select it, then apply.
Give it a few seconds — shaders compile the first time they load, so the screen may freeze briefly before the new lighting appears. If the pack never shows up in the list, see the FAQ below; the cause is almost always a misplaced file or the wrong profile.
Pairing shaders with a texture pack
Shaders and texture packs do different jobs, and they look their best together. A shader controls light — sun, shadows, reflections, fog, and water. A texture pack controls surfaces — the colour and detail of every block. Stack them and you get realistic lighting falling across realistic materials.
To get true depth and shine, the texture pack needs to be PBR (physically based rendering). PBR packs ship extra maps — normal maps for bumps and specular maps for how shiny or metallic a surface is — that shader packs read to render bumpy stone, wet cobblestone, and reflective metal. A plain colour-only pack will look fine but flat under shaders. Our PBR explainer covers how that works.
Optimum Realism is built for exactly this. It is a photorealistic PBR pack designed to be paired with shaders on Java, and it also supports Bedrock RTX. The 64x base resolution is free; higher resolutions are available through Patreon. Install it like any resource pack, then enable a shader on top — the shaders landing page shows recommended pairings, and the install guide walks through adding the pack itself.
Performance tips
Shaders are the single most demanding thing you can add to Minecraft, so a few settings make a real difference between smooth and slideshow:
- Lower the render distance. Shadow rendering scales with how far you can see; dropping from 16 to 8–12 chunks often helps the most.
- Pick a lighter shaderpack or its low preset. Many packs (Complementary, BSL, Sildur's) ship Low/Medium/High profiles — start low and climb.
- Prefer Iris + Sodium for raw frame rate. Sodium's rendering engine is the performance backbone; if FPS is your priority, this combo is usually the strongest.
- Turn down shadow resolution and reflections. Inside the shader's own settings, shadow quality and screen-space reflections are common frame-rate costs you can dial back.
- Match the texture resolution to your hardware. A 512x pack plus heavy shaders is a lot to ask of a laptop GPU — step down a resolution if you stutter.
For a deeper walkthrough of squeezing out frames, read how to boost FPS with shaders & texture packs. You can browse every guide on the info hub.
FAQ
Do I need OptiFine if I use Iris?
No. Iris is a standalone alternative to OptiFine. It runs on Fabric and bundles Sodium for performance, so you install Iris or OptiFine — not both. The two are not compatible in the same profile. See Iris vs OptiFine to choose.
Where is the Minecraft shaderpacks folder?
It lives inside your .minecraft folder. On Windows that is
%appdata%\.minecraft\shaderpacks. Iris and OptiFine both create the
folder the first time you open the shader menu, so the easiest route is to click
Open Shader Pack Folder in-game.
Why do my shaders not show up in the list?
Usually the .zip is in the wrong place, was unzipped into a folder, or
you launched a vanilla profile without Iris or OptiFine loaded. Confirm the
.zip sits directly in shaderpacks and that you started the
modded profile. More fixes:
Minecraft shaders not working.
Do shaders work with texture packs?
Yes, and they are meant to be paired. The shader handles lighting and water while the texture pack supplies the surfaces. PBR packs like Optimum Realism add normal and specular maps so the shader can render real depth and reflections.
Do shaders work on Minecraft Bedrock?
Not the Java way — Bedrock has no Iris or OptiFine. It uses built-in RTX ray tracing with a compatible RTX pack and an RTX-capable GPU instead.
Get the realistic look
Optimum Realism is a photorealistic PBR pack for Java and Bedrock RTX — free at 64x.
Download Optimum Realism New here? Read the install guide.