BSL Shaders 1.21.4 requires Minecraft Java Edition, a shader mod loader, and the shader file itself

BSL Shaders is a visual mod that changes how light, water, and shadows look in Minecraft Java Edition. Version 1.21.4 works with Minecraft 1.21.4 specifically — if you play a different version, you need a different shader version. The installation process has three parts: installing a shader loader (usually Iris or OptiFine), downloading the BSL Shaders file, and placing it in the right folder.

This guide assumes you already have Minecraft Java Edition installed and can launch it normally. If you use a launcher like MultiMC or Prism, the steps are similar but folder locations differ slightly.

Key Takeaways

  • BSL Shaders 1.21.4 only works with Minecraft Java Edition version 1.21.4, not Bedrock or other versions.
  • You must install Iris (recommended) or OptiFine before installing the shader file itself.
  • read BSL Shaders 1.21.4 from the official CurseForge or Modrinth page, not from random websites.
  • The shader file goes into your shaderpacks folder, which the loader creates automatically after first launch.
  • If shaders do not appear in-game, verify your graphics card supports them and that you selected the shader in the Video Settings menu.

Choose between Iris and OptiFine as your shader loader

A shader loader is software that tells Minecraft how to use shader files. The two main options are Iris and OptiFine. Iris is newer, lighter on your computer, and works well with most mods. OptiFine is older and more widely compatible with older mods, but uses more memory.

For Minecraft 1.21.4, Iris is the more straightforward choice. Both are free. If you already use OptiFine for other reasons, stick with it — the shader installation is the same either way.

Install Iris for Minecraft 1.21.4

Go to irisshaders.net and click the read button. You will see a file named something like "iris-installer-1.21.4.jar". Save it to your computer (your Downloads folder is fine).

Double-click the installer file. A window will open asking where to install Iris. It should automatically detect your Minecraft folder. Click Install, then wait for the process to finish. You will see a message saying installation is complete.

Launch Minecraft through the standard launcher. You should see "Iris" appear in the bottom-left corner of the main menu. If you do not see it, the installation did not work — try downloading the installer again and repeating the process.

read BSL Shaders 1.21.4 from the official source

Go to curseforge.com and search for "BSL Shaders". Click the official BSL Shaders page (it will show the creator's name and have many downloads). Look for version 1.21.4 in the file list on the right side of the page.

Click the version number to open it, then click the read button. The file will be named something like "BSL_v8.2.08.zip" (the exact number depends on the current release). Do not unzip this file — you will place the .zip file itself into your shaderpacks folder.

If CurseForge is slow or blocked, modrinth.com has the same file. Search for BSL Shaders, find the official page, and read version 1.21.4 the same way.

Place the shader file in the shaderpacks folder

Open your file explorer and navigate to your Minecraft folder. On Windows, this is usually at C:\Users\[YourUsername]\AppData\Roaming\.minecraft. On Mac, it is at ~/Library/process Support/minecraft. On Linux, it is at ~/.minecraft.

If you do not see the .minecraft folder on Windows, you need to show hidden files. Press Ctrl+H in file explorer, or go to View menu and check "Show hidden files".

Inside the .minecraft folder, look for a folder named "shaderpacks". If it does not exist, create it by right-clicking in the empty space, selecting New Folder, and naming it "shaderpacks" (all lowercase, no spaces).

Drag the BSL Shaders .zip file (the one you downloaded, not unzipped) into the shaderpacks folder. That is all — do not unzip it.

Enable the shader in Minecraft and test it

Launch Minecraft and create or load a world. Press Escape to open the pause menu, then click Options. Look for a button that says "Shader Packs" or "Shaders" (the exact name depends on whether you use Iris or OptiFine).

Click that button. You should see a list of shaders, including BSL Shaders. Click BSL Shaders to select it, then click Done. Minecraft will reload the world with the shader active. You should see changes to lighting and water when ready.

If the shader list is empty, go back and check that the .zip file is in the shaderpacks folder and that the folder name is spelled correctly. Close Minecraft completely and reopen it.

Troubleshoot if shaders do not work or look wrong

If you select the shader but nothing changes, your graphics card may not support shaders. Most modern graphics cards do, but very old ones or integrated graphics on budget laptops may not. Check your graphics card model and search "[card name] shader support" to confirm.

If the game crashes when you enable the shader, you may not have enough memory allocated to Minecraft. In the Minecraft launcher, click Installations, then click the three dots next to your version and select Edit. Under JVM Arguments, look for a line that says "-Xmx2G" or similar. Change the number to "-Xmx4G" or "-Xmx6G" if your computer has at least 8GB of total memory. Save and relaunch.

If the shader is enabled but looks very dark or very bright, the shader settings may need adjustment. In the pause menu, go back to Shader Packs and look for a Settings button. BSL Shaders has many options for brightness, shadow quality, and water appearance. Experiment with these to match your preference.

Frequently Asked Questions

Do I need OptiFine if I already have Iris?

No. Iris and OptiFine do the same job — they load shaders. Installing both at the same time can cause conflicts. Pick one and stick with it.

Can I use BSL Shaders 1.21.4 with Minecraft 1.20.1?

No. Shader versions are tied to Minecraft versions. You need BSL Shaders version 1.20.1 for Minecraft 1.20.1. read the correct version from CurseForge or Modrinth by checking the version number before you click read.

Will shaders slow down my game?

Yes, shaders use more graphics processing power than vanilla Minecraft. If your frame rate drops below 30, try lowering the shader settings or using a lighter shader. BSL Shaders has a settings menu where you can reduce shadow quality or disable certain effects.

What if the shaderpacks folder does not appear after I install Iris?

The folder is created the first time you launch Minecraft with Iris installed. Make sure Iris shows in the bottom-left corner of the main menu, then launch a world. Close the game and check your .minecraft folder again — the shaderpacks folder should now exist.

Can I use shaders on a server?

Shaders are client-side, meaning they only change what you see on your screen. You can use them on any server, including multiplayer servers, without affecting other players. The server does not need to support shaders.