| Decision | What is supported | Planning use |
|---|---|---|
| Edition | BSL is a Java Edition shaderpack; Bedrock is not supported | Java players can use it. Bedrock players cannot. |
| Loader | Iris and OptiFine are the listed platforms; Iris is recommended on modern Java, OptiFine suits the classic install path | Choose Iris for a current setup. Choose OptiFine only if you prefer the classic route. |
| Version | Current release is 10.1.8; downloads cover Java 26.3 down to 1.7.10 | Confirm your game version sits inside that range before you download. |
| Performance | Mid-weight shader; lower shadow resolution and disable expensive volumetric options if framerate dips | Tune shadows first, before touching anything else. |
| Hardware | Lower presets on integrated GPUs; higher shadows and volumetric settings on dedicated cards | Pick the starting preset by GPU type, not by guesswork. |
Figures come from the BSL listing on Modrinth and the CraftMC BSL page.
Minecraft BSL shaders are a Java Edition shaderpack that adds realistic lighting, shadows, water and bloom through Iris or OptiFine. They are mid-weight, so expect to tune shadows on weaker GPUs.
If you are new to add-ons in general, the hub explains how to install game mods before you add a shader loader. The sections below cover what BSL changes, which loader to pick, how to install it and how to set it up for your PC.
What BSL changes on screen
BSL rewrites how the game handles light, so the biggest change is to every scene rather than to a single block. A BSL description on TLauncher says the pack completely changes the format of lighting and shadows to create the impression of a realistic picture. Its Modrinth page describes the look as bright, colorful and distinct, and tags it for bloom, colored lighting, reflections and shadows.
Those effects matter in different ways depending on how you play:
- Lighting and shadows. Torches, lanterns and the sun all behave differently once the pack is active. Builders who care about interiors and night scenes see the largest gain here, and shadows are also the main cost to your framerate.
- Water, clouds and reflections. These effects are adjustable rather than fixed. If you build on coasts or lakes, you can keep the water effect and trim other features. If you rarely look at water, it is the first place to economise.
- Post effects. Motion blur, anti-aliasing and bloom are all configurable. Bloom gives BSL its cinematic glow, so leave it on if that look is why you chose the pack.
- Colour character. According to CraftMC, BSL suits players who want punchy colors and cinematic bloom without jumping straight to ultra path-traced packs.
That last point is the practical reason to choose BSL over a heavier pack: it gives a strong visual upgrade at mid-weight cost. It also has a long track record, with a distinct style that other packs have built on, which the comparison section below covers.
Choosing Iris, OptiFine or Sodium
BSL lists Iris and OptiFine as its platforms, and neither is built into the game, so you need one of them before the pack appears in any menu. CraftMC recommends Iris on modern Java and describes OptiFine as the classic install path. On that basis, new installs are better off with Iris, while OptiFine fits players who already run it and do not want to change their setup.
- Iris with Sodium on Fabric. CraftMC notes that Iris plus Sodium is usually better on modern Fabric or Quilt. Sodium is the companion mod in that pairing, and Fabric is the loader that hosts both. This is the route to take if you are building a modern, mod-friendly profile.
- OptiFine. Choose it if it is already installed and working. It gives you the same BSL pack through the classic path, so you do not need to change anything about the shader file itself.
If you have not set up Fabric yet, a walkthrough on how to install minecraft mods covers the loader before you add Iris and Sodium.
Installing BSL step by step
The pack file is the same on both platforms, so only the loader setup differs. Download BSL from its official Modrinth or CurseForge listing, and pick the file that matches your Minecraft Java Edition version.
Iris with Fabric and Sodium
- Install Fabric for your Minecraft version and launch the game once to create the profile.
- Add Iris and Sodium to the Fabric mods folder, using builds for the same Minecraft version.
- Place the BSL .zip in the shaderpacks folder. Do not unzip it.
- Open the shader selection screen, choose BSL and click Done.
OptiFine
Install OptiFine first, then follow the same last two steps as above: the .zip goes into shaderpacks as it is, you select BSL, and you click Done. The CraftMC instructions treat both loaders this way, which is why a single download works on either one.

For a different example of finding, installing and managing community content, see The Best Sims 4 Traits CC: How To Find, Install, And Use Custom Traits In 2026 – Lunacheats.

Version checks before you download
BSL covers a very wide range of game versions, so check the listing rather than assuming. The Modrinth versions page lists Java Edition from 26.3, 26.2 and 26.1.x through the 1.21.x line, all the way down to 1.7.10. CraftMC gives the current release as 10.1.8 and says the official Modrinth and CurseForge downloads span 26.3 to 1.7.10.
The practical result is that most players will find a matching file. Download from the official listings and match the file to your exact game version instead of taking the newest file by default.
Settings by PC tier
BSL is described as a mid-weight shader, so the right starting point depends mostly on your GPU. The supported guidance is simple: use lower quality presets on integrated GPUs, and raise shadow and volumetric settings on dedicated cards. Treat the tiers below as starting points and adjust from there.
- Low-end and integrated graphics. Start from a lower preset. If framerate dips, lower the shadow resolution and disable the expensive volumetric options. Those two changes are the supported first moves and are usually enough to make BSL playable.
- Mid-range systems. Begin on a standard preset and leave shadows and volumetric effects alone until you see a framerate dip. When you do, apply the same two cuts, shadow resolution first. Keep bloom and water effects, since they carry much of the look.
- High-end dedicated cards. Raise shadows and volumetric settings, since a dedicated card has the headroom. This is where reflections, clouds and bloom can all stay switched on together.
Higher shadow and volumetric values are a ceiling for strong hardware, not a target for everyone. If a setting costs you smooth play, the better choice is to step it down and keep the features you notice most.
When BSL does not load
If the pack never appears or the game stops working after you add it, the cause is usually one of a few setup mistakes. Check them in this order:
- Zip state. The file must stay zipped inside shaderpacks. An unzipped folder is the most common reason the pack does not show.
- Platform. BSL needs Iris or OptiFine as its platform. Without one installed and active, the shader list has nothing to load it with.
- Version range. Your game version must be inside the listed range. After a Minecraft update, return to the listing and download the file that matches the new version.
- Edition. A Bedrock install will never accept the pack, however the file is placed.
Once BSL loads but runs slowly, the problem is no longer installation. Go back to the tier settings above and cut shadows first.
BSL compared with other packs
BSL has a long lineage in the shader scene. CraftMC notes that Complementary started as a BSL edit, while BSL itself remains a top pick for the classic vibrant look. If you like the BSL style but want a different balance, a derived pack is the natural next step. If you prefer a vibrant, bloom-heavy look at a moderate cost, BSL is the better fit than jumping straight to a path-traced pack.
Frequently asked questions
Do BSL shaders work on Bedrock?
No. BSL is a Java Edition shaderpack, and CraftMC states it plainly: Bedrock is not supported.
How popular is BSL?
The Modrinth listing shows 31.9M downloads and 6.3K followers, which makes it one of the most widely used shader projects there.
Should I download an older BSL file such as 7.2?
Only if your game matches it. The 7.2 file on Modrinth is tagged for Minecraft Java Edition 1.16.5 and lists Iris and OptiFine as platforms. For other versions, use the file matching your game from the current listing.

Leave a Reply