How to Fix BSL Shaders Not Working [Causes & Fixes]

Common causes:

• No shader loader: Vanilla Minecraft does not include a shader menu.
• Sodium only: Sodium improves performance but does not add a shader menu on its own.
• Missing shaderpacks folder: Minecraft may not have created the shaderpacks folder yet. Launch the game once with a compatible shader loader to create it.
• Wrong file placement: The shader pack is in the resourcepacks folder, inside a nested folder, or was extracted from the ZIP file.

How to fix it?

Install Iris (its installer also installs Sodium) or OptiFine first. Follow our BSL Shaders guide for the complete setup process, then follow these steps to install and enable the shader pack safely:

1. Launch Minecraft once: Select the Iris or OptiFine profile in Minecraft or your preferred launcher. Wait for the main menu to load, then close the game to generate the necessary folders, such as shaderpacks, in the Minecraft directory.
   Click to zoom
2. Open the shaderpacks folder: Relaunch Minecraft and go to Options > Video Settings > Shader Packs > Open Shader Pack Folder. OptiFine labels this screen Shaders.
   Click to zoom
3. Add BSL Shaders: Drag the downloaded BSL Shaders .zip file into the shaderpacks folder. Do not extract the ZIP file.
   Click to zoom
4. Fix Automatically Extracted Files: If you see a shaders folder instead of a BSL Shaders .zip file, disable your browser’s auto-unzipping setting and download BSL Shaders again. Alternatively, zip the extracted BSL Shaders folder yourself.
5. Check the Folder Structure: If BSL Shaders still doesn’t appear, open the shaderpacks folder. If you see a shaders folder directly inside it, create a folder named BSL Shaders and move the shaders folder into it. The final path should be shaderpacks/BSL Shaders/shaders. If you already have the BSL Shaders .zip file, place it directly inside shaderpacks instead. Do not extract the ZIP file.
6. Enable and Check: Return to the game, select BSL Shaders, and click Apply.

If BSL Shaders still does not appear, try the following steps to check for conflicting mods or other compatibility issues.

Causes:

• Demanding shader settings: High-quality shadows and lighting effects may exceed your GPU's capabilities.
• Outdated graphics drivers: Old NVIDIA, AMD, or Intel graphics drivers can cause shader rendering errors.
• Incompatible shader files: Your BSL Shaders download may not be compatible with your Minecraft or shader loader version.
• Conflicting mods: Visual or performance mods, such as Distant Horizons, may cause compatibility issues with a shader pack.
• Hardware limitations: Older graphics cards and some integrated GPUs may struggle with demanding BSL Shaders effects, as BSL Shaders is not designed specifically for low-end hardware.

How to fix it?

If BSL Shaders loads but crashes later, your graphics card may be the limiting factor. In that case, switching to a lighter shader pack may be the best solution, as troubleshooting alone may not resolve performance issues on a low-spec PC.

1. Lower BSL Shaders' Quality Settings: If your GPU is struggling to run the shader pack, reduce the graphics workload.
   • Open Options > Video Settings > Shader Packs.
   • Select BSL Shaders and open Shader Pack Settings.
   • Choose a lower Profile, such as Low or Medium.
   • Apply the changes and load a world again.
     Click to zoom
2. Test Another Shader Pack: Download a shader pack that lists your Minecraft version on CurseForge. If the other pack works, try a BSL Shaders release compatible with your setup. If multiple shader packs fail, investigate your shader loader, graphics drivers, and rendering mods.
3. Update Your Graphics Drivers: Update your graphics drivers using the NVIDIA app, AMD Software: Adrenalin Edition, or the appropriate Intel graphics driver, then restart your PC.
4. Test Your Mods: Back up your mods folder, disable mods that affect rendering or lighting, and launch Minecraft with only Iris and BSL Shaders. Then re-enable the mods one at a time to find any conflicts.
5. Reinstall as a Last Resort: If BSL Shaders still fails in a clean instance, reinstall the compatible shader loader and download BSL Shaders again from its official website.

To fix BSL Shaders not working in Minecraft, start by checking your shader loader installation, shader ZIP file, and shaderpacks folder location. If BSL Shaders appears in the menu but will not load, verify version compatibility, try a lower quality profile, update your graphics drivers, and check for conflicting mods. For visual glitches, adjust the relevant BSL Shaders setting according to your preference. Change one thing at a time, and once BSL Shaders runs smoothly, you can fine-tune its appearance at your own pace and enjoy the visuals without constant restarts.