How to install shaders in Minecraft

What shaders are

Shaders are special graphics programs that change how Minecraft renders the image. Vanilla Minecraft uses simple, flat lighting. Shaders replace it with an advanced graphics engine that adds shadows, reflections, atmospheric effects and dynamic lighting.

The effects shaders give you:

• Soft shadows - buildings and trees cast realistic, blurred shadows
• Water reflections - the water surface reflects the sky and the blocks around it
• Volumetric clouds - dense, three-dimensional clouds instead of flat strips
• Bloom and lens flare - flare effects when you look at the sun
• Wind sway - grass and leaves move in the wind
• Depth of field - things in the distance blur slightly
• Dynamic lighting - a torch held in your hand lights up your surroundings

Technically, a shader pack is a bundle of files (in .zip format) containing GLSL programs that Minecraft runs directly on your graphics card. To run them you need a special mod: either Iris Shaders or OptiFine.

Method 1: Iris + Fabric (recommended)

Iris Shaders is a modern shader mod for Fabric. Paired with Sodium, it gives clearly better performance than OptiFine: more FPS with the same shaders. It's the recommended method for new players and for anyone who uses other Fabric mods.

Step 1: install Fabric

Fabric is the mod loader you need to run Iris. If you already have Fabric installed, skip to step 2.

1. Go to fabricmc.net and download the Fabric installer
2. Run the downloaded fabric-installer.jar file (you need Java)
3. Choose the Minecraft version you want to use
4. Click Install. The installer adds a new profile to the Minecraft Launcher

For a detailed walkthrough, see how to install Fabric.

Step 2: download Iris and Sodium

It's best to download Iris together with Sodium, an optimization mod that drastically improves FPS.

1. Go to irisshaders.dev or to Modrinth (modrinth.com/mod/iris)
2. Download the Iris version that matches your Minecraft version and Fabric
3. Optional (but recommended): also download Sodium from modrinth.com/mod/sodium

Step 3: put the files in the mods folder

1. Open the Minecraft Launcher and click Installations
2. On the Fabric profile, click the folder icon (or More Options and copy the path from Game Directory)
3. In the game folder, open the mods folder (create it if it doesn't exist)
4. Drop the downloaded .jar files (Iris, Sodium) into the mods folder

Step 4: launch the game with the Fabric profile

In the launcher, pick the fabric-loader-[version] profile and start the game. If Iris loaded correctly, you'll find a Shader Packs button in Options > Video Settings.

Method 2: OptiFine

OptiFine is an older but still very popular mod that adds shader support and many graphics options. It works without Fabric, as a standalone profile in the launcher. If you don't use other mods or you play an older Minecraft version, OptiFine can be the simpler choice.

Step 1: download OptiFine

1. Go to optifine.net, the only official OptiFine site
2. Click Downloads and pick the version that matches your Minecraft
3. Click the download link (note: the site has ads, so click only the Download button, not the banners)
4. Save the OptiFine_[version].jar file to disk

Step 2: install OptiFine

1. Run the downloaded OptiFine_[version].jar file. The installer opens
2. Make sure the install path points to the right Minecraft folder
3. Click Install
4. OptiFine adds a new profile to the Minecraft Launcher

Step 3: launch the game with OptiFine

In the launcher, pick the OptiFine [version] profile and start the game. A Shaders button now appears in the video options.

Where to download shaders safely

Download shaders only from trusted sources. Shader files are programs that run on your graphics card, so a malicious file can do serious damage.

Safe sources

• Modrinth (modrinth.com) - a modern mod platform with author verification, recommended
• CurseForge (curseforge.com) - an older platform that is still reliable
• The shader authors' official sites

What to avoid

• Links from YouTube comments - a common way viruses spread
• Sites with names like "minecraft-shaders-download.com" - unofficial repacks
• .exe files - shaders are never executable files, always a .zip
• Sites that ask for your email address or make you register

The shaderpacks folder: where to put the file

After you download a shader file (in .zip format), you have to put it in the right folder. Don't unzip it. Drop it in as a .zip.

Folder location on each system

• Windows: %AppData%\.minecraft\shaderpacks - paste this path into the File Explorer address bar
• macOS: ~/Library/Application Support/minecraft/shaderpacks
• Linux: ~/.minecraft/shaderpacks

If the shaderpacks folder doesn't exist, create it by hand inside the .minecraft folder.

A faster way: through the game menu

You can also open the shaderpacks folder straight from the game:

1. Launch Minecraft with Iris or OptiFine
2. Go to Options > Video Settings > Shader Packs (Shaders in OptiFine)
3. Click the Open Shader Pack Folder button (called Shaders Folder in OptiFine)
4. Drop the shader's .zip file into the folder that opens

Turning shaders on in game

Once the shader file is in the shaderpacks folder, it's time to switch it on in the game.

Turning shaders on in Iris (Fabric)

1. Launch Minecraft with the Fabric profile
2. In the main menu, click Options
3. Click Video Settings > Shader Packs
4. Your shaders are listed on the left. Click the name of the pack
5. Click Apply. The game reloads the shaders (this can take a few seconds)

Alternatively, once you're in a world, press O (the default Iris keybind) to open the shader menu quickly.

Turning shaders on in OptiFine

1. Launch Minecraft with the OptiFine profile
2. In the main menu, click Options > Video Settings > Shaders
3. Pick the name of the shader you downloaded from the list
4. Click Done. The shaders load automatically

Popular shaders: overview

If you're not sure which shader to pick, here are the most popular packs with a short description of each.

Complementary Shaders / Complementary Reimagined

Complementary is one of the most popular shaders on Modrinth. It offers beautiful graphics while keeping good performance. The Reimagined version goes even further and adds volumetric clouds, neon and night effects. Compatible with Iris and OptiFine. An ideal choice for most players.

BSL Shaders

BSL is a classic shader known for its warm, sunny color palette and nice water effects. Efficient and stable, it runs well even on weaker graphics cards in the GTX 1050 class. Available on CurseForge and Modrinth.

SEUS (Sonic Ether's Unbelievable Shaders)

SEUS is a legend among Minecraft shaders and one of the oldest and best-known projects. The SEUS Renewed version is free and offers photorealistic effects: true water reflections, soft shadows and advanced lighting. The SEUS PTGI version adds ray tracing and needs a very powerful graphics card (RTX or similar).

Sildur's Vibrant Shaders

Sildur's is an excellent shader for players with weaker hardware. The Lite version runs even on integrated Intel graphics. The Enhanced Default version is a light upgrade to vanilla that adds shadows without a big FPS drop. It comes in several quality levels, from Lite to Extreme.

Shader comparison at a glance

Hardware requirements

Shaders put far more load on your graphics card than regular Minecraft. Below are approximate requirements for different shader tiers.

Besides the graphics card, these also matter:

• RAM: at least 8 GB of system RAM, 16 GB recommended
• RAM for Java: allocate at least 4 GB of memory to Minecraft (in the launcher settings)
• CPU: shaders are mainly a GPU job, but a weak CPU can cause FPS swings
• GPU drivers: always keep your graphics drivers up to date

Optimizing performance

Shaders put a heavy load on the game. Here are a few ways to squeeze more FPS out of them without giving up the visual effects.

Use Iris + Sodium

The Iris + Sodium combination is the single most important optimization. Sodium rewrites Minecraft's rendering engine and can triple your FPS compared with OptiFine. You can also add Lithium (game logic optimization) alongside Sodium.

Lower the render resolution

In the shader settings (in both Iris and OptiFine) you'll find a Render Quality or Shadow Quality option. Lowering it from 1.0 to 0.75 or 0.5 cuts GPU load drastically for only a small loss in quality.

Reduce render distance

Shaders render shadows and atmospheric effects for every visible chunk. Lowering Render Distance from 16 to 8-10 chunks can double your FPS without much visual loss.

Turn off effects you don't need

Most shaders have extensive settings menus. You'll find toggles for individual effects there: volumetric clouds, depth of field, bloom, water animation. Turn off the ones that bother you most or that you don't notice while playing.

Cap FPS at 60

If your monitor has a 60 Hz refresh rate, there's no point rendering 120 FPS, it only wastes GPU resources. Set Max Framerate to 60, or turn on VSync, in the video settings.

Common problems

Black screen after turning on a shader

The most common cause is a mismatch between the shader's version and your Minecraft or mod version. Make sure you downloaded a shader that is compatible with your Minecraft version. If you use Iris, also check that Iris is up to date. Try turning off other mods, since they can cause a conflict.

The game crashes while loading a shader

Check the game logs (.minecraft/logs/latest.log). Look for lines with ERROR, which often name the shader file causing the problem. A required mod may also be missing (for example, Iris needs Sodium in some configurations).

Very low FPS (below 20)

Your graphics card may be too weak for the shader you picked. Try a lighter pack (for example Sildur's Lite instead of SEUS). Also lower Render Distance to 6-8 and switch Graphics from Fancy to Fast in the video settings.

Water is black or opaque

In OptiFine, go to Video Settings > Details and set Water to Fancy. Shaders need the water effect set to Fancy to render reflections and transparency correctly.

The shader doesn't show up in the list

Check that the shader file is a .zip (not .zip.zip, since double extensions sometimes happen with downloads). Also check that the file is in the shaderpacks folder itself and not in a subfolder inside it. Restart the game after dropping the file in.

Shadows flicker or look wrong

This is a common problem on older GPU drivers. Update your graphics drivers to the latest available version. You can also try changing the Shadow Resolution setting in the shader's configuration.

Related pages

• Minecraft shaders: list of the best packs
• Iris Shaders: the shader mod for Fabric
• Sodium: the best FPS optimization for Fabric
• Complementary Shaders: overview and installation
• OptiFine: download and installation
• How to install Fabric: step-by-step guide