Quick guide

How to Install Shaders in Minecraft

Turn your Minecraft world into a beautiful landscape with realistic lighting, water, and shadows. Works on Forge, NeoForge, and Fabric loaders.

⚠️ Fair warning: Shaders hit your GPU hard. Even a decent graphics card might drop from 100+ FPS to 30-60 FPS depending on the shader pack.

What Are Shaders?

Shaders are small programs that run on your GPU to dramatically improve how light, water, and shadows render in Minecraft. Instead of the flat, basic lighting the game normally has, shaders make everything look more realistic and atmospheric.

The tradeoff? Your GPU does way more work. That's why shader packs can tank your FPS even on high-end systems.

Minecraft doesn't support shaders natively, so you need special mods to load them. The good news is there are different solutions depending on which mod loader you use.

Forge: Embeddium/Rubidium + Oculus

On Forge, you need two mods working together: Embeddium (or its older counterpart Rubidium) for performance, and Oculus to actually load shaders.

Why Embeddium instead of Rubidium?

Embeddium is the newer, better-maintained version of Rubidium. It fixes a lot of compatibility issues with other mods and works on newer Forge versions. Rubidium is outdated but still works if Embeddium isn't available for your version. Pick one or the other – they're incompatible and will crash if installed together.

Installation Steps

  1. Download Embeddium (or Rubidium if you need it for an older version) from CurseForge
  2. Download Oculus from CurseForge. Make sure it matches your Minecraft version
  3. Drop both .jar files into your mods folder
  4. Launch Minecraft and wait for it to load – Oculus will initialize the shader system
  5. In video settings, you'll now see a new "Shaders" button. Click it to browse and load shader packs
Pro tip: If you're using CurseForge or ATLauncher to manage mods, they'll usually install Embeddium automatically when you add Oculus. One less thing to worry about.

Common Issues on Forge

Game crashes on startup: You probably have both Embeddium and Rubidium installed. Delete one.

Shaders menu is blank or frozen: Update your GPU drivers. Oculus is picky about driver versions.

Missing textures or weird rendering: Make sure you're on the latest version of both Embeddium and Oculus. Older versions had compatibility issues.

NeoForge: Iris + Sodium (The Better Way)

NeoForge is newer and the official Iris and Sodium mods now have proper support for it. This is actually cleaner than the Forge setup because you're using the official mods instead of unofficial forks.

Why This Works Better

Iris and Sodium were originally made for Fabric. NeoForge support is relatively recent (started around version 1.21) but it's the real deal – the official developers maintain it. No unofficial forks needed.

Installation Steps

  1. Make sure you're on Minecraft 1.21.1 or newer (Iris/Sodium NeoForge support started there)
  2. Download the Sodium mod for NeoForge from CurseForge or Modrinth
  3. Download the Iris mod for NeoForge from the same source
  4. Drop both into your mods folder
  5. Launch the game. You'll see shader options in video settings
💡 Helpful: Iris automatically pairs with Sodium, so they work together seamlessly. No weird compatibility issues like with Forge.

What About Embeddium on NeoForge?

Embeddium also works on NeoForge 1.20.1 and newer, but it's redundant since you have the official Sodium. There's no real reason to use it unless you specifically need something Embeddium has that Sodium doesn't (which is rare).

Fabric: Iris + Sodium

Iris and Sodium were originally made for Fabric, so this is the "native" setup. If you're on Fabric, you get the cleanest, most compatible experience. No forks, no workarounds – just the real deal.

Why Fabric?

Fabric is lightweight and developer-friendly, which is why Iris and Sodium originated here. NeoForge support is newer, and Forge uses forks. If you have the choice and want shaders, Fabric is honestly the path of least resistance.

Installation Steps

  1. Make sure you have a Fabric loader installed for your Minecraft version (1.16.5+)
  2. Download Sodium from CurseForge or Modrinth for Fabric
  3. Download Iris from CurseForge or Modrinth for Fabric
  4. Drop both .jar files into your mods folder
  5. Launch Minecraft. You'll see shader options in video settings immediately
Bonus stuff on Fabric: You can also install mods like Continuity (connected textures) and Entity Culling (performance boost) that work seamlessly with Iris. On Forge, these sometimes conflict.

Extra Mods That Work Great With Iris on Fabric

  • Continuity: Makes textures connect seamlessly (like grass sides matching grass tops)
  • Entity Culling: Stops rendering entities you can't see. FPS boost with shaders
  • LambdaBetterGrass: Better grass and snow rendering
  • Distant Horizons: Draw terrain way further than normal render distance (works with shaders)

None of these are required, but they layer nicely on top of Iris and Sodium without conflicts.

How to Load Shader Packs

Once you have your shaders mod installed (whether Oculus or Iris), loading shader packs is simple:

  1. Open Minecraft and go to Video Settings
  2. Find the Shaders button (it'll be obvious once you have the mods)
  3. You'll see a folder icon or a "Shader Packs" button. Click it to open the shader pack directory
  4. Download a shader pack as a .zip file (don't extract it)
  5. Drag the .zip file into that folder
  6. Back in the menu, you'll see your new shader pack listed. Click it to enable it
Where to find shader packs: Curseforge and Modrinth have hundreds. Popular ones include Complementary, Sildur's Vibrant Shaders, and BSL Shaders.

Recommended Shader Packs

All of these are compatible with OptiFine shader packs and work on Iris and Oculus:

Best for Looks

  • Complementary Reimagined: Balanced, beautiful, and runs reasonably well
  • Sildur's Vibrant Shaders: Vivid colors and realistic lighting. The classic choice
  • BSL Shaders: Excellent water, atmospheric lighting. Very popular

Best for Low-End PCs

  • Complementary Low: Lightweight version of Complementary. Still looks great
  • Sildur's Basic Shaders: Minimal overhead but noticeably better than vanilla

Shader Settings and Performance Tips

Adjusting Shader Settings

Most shader packs let you tweak quality settings. In the shader menu, you'll see a "Settings" button that opens a bunch of sliders:

  • Shadow Distance: How far shadows render. Shorter = faster
  • Shadow Quality: How detailed shadows are. Lower = faster
  • Water Reflections: Whether water reflects the sky. Disable for speed
  • Ray Tracing: Advanced lighting simulation. Very expensive, disable unless your GPU is beast-tier

Balancing FPS and Visuals

Start with the shader's "Low" or "Medium" quality settings. Then:

  1. Check your FPS in a normal area of your world
  2. If you're below 60 FPS, lower shadow quality and shadow distance first
  3. Disable fancy reflections and ray tracing if needed
  4. Reduce render distance in Minecraft settings (shaders make this matter even more)
Reality check: If you have a mid-range GPU and want 60+ FPS with shaders, you'll need to make compromises. Pick a lightweight shader and lower settings. That's just how it is.

Troubleshooting

Shader pack won't load

Make sure you're using the right mod combo for your loader. Oculus shaders won't work on Fabric, and Iris shaders won't work on old Forge versions. Also, some shaders require specific minimum versions of Oculus/Iris.

Game is extremely laggy with shaders

Your GPU might be bottlenecking. Try a lighter shader pack or lower the quality settings significantly. Alternatively, lower your render distance and disable fancy graphics.

Shaders look weird or broken

Update your GPU drivers. Seriously. Shaders are sensitive to driver versions. Also check that you're using a compatible shader pack for your Iris/Oculus version.

Iris works but Sodium looks broken

Make sure you have the exact right version of Sodium that matches your Iris version. They need to be on the same release cycle or weird things happen.

Quick Comparison

Setup Loader Mods Needed Best For
Oculus + Embeddium Forge 1.20.1 or older 2 mods (forks) Older Forge versions only
Iris + Sodium Fabric 1.16.5+ 2 mods (official) Best compatibility & stability
Iris + Sodium NeoForge 1.21+ 2 mods (official) Newest NeoForge packs