Oculus is a shader mod for Minecraft Forge and NeoForge that brings Iris shader pack compatibility to modded environments, allowing players to use popular shader packs like BSL, Complementary, and Sildur's without switching to Fabric.
Forge players have long faced a frustrating choice: use OptiFine for shaders but deal with constant mod conflicts, or skip shaders entirely. Iris solved this on Fabric, but Forge users were left out — until Oculus arrived. Created by Asek3 as an unofficial fork of Iris rebuilt for Forge Mod Loader (FML), Oculus has quietly become one of the most essential shader mods in the Forge ecosystem. With over 23 million downloads since its 2022 release, it is clear that the modded Minecraft community was hungry for exactly this kind of solution. Oculus bridges the gap between visual quality and mod compatibility, letting Forge players enjoy the same stunning shader packs that Fabric users have had access to for years.
Key Features of Oculus Mod
- GPU-Accelerated Shader Rendering — Oculus is designed to fully utilize your graphics card when paired with optimization mods like Rubidium. This means shader rendering gets offloaded from your CPU to your GPU where it belongs, resulting in noticeably better frame rates compared to OptiFine in heavily modded packs. Players with mid-range GPUs should see a real improvement in shader performance.
- Forge & NeoForge Mod Compatibility — Unlike OptiFine, which frequently breaks other mods through core modifications, Oculus makes a best effort to coexist with modded environments. This is critical if you run large modpacks with 100+ mods — you no longer have to choose between shaders and your favorite content mods. The mod is built from the ground up to respect Forge's loading system.
- Full Shader Pack Backwards Compatibility — Every existing ShadersMod and OptiFine shader pack should work with Oculus without any modifications. That means BSL Shaders, Complementary Reimagined, Sildur's Vibrant Shaders, and hundreds of other packs work out of the box. You do not need to hunt for special Forge-compatible shader versions.
- Clean, Well-Organized Codebase — Oculus inherits Iris's commitment to maintainable code, which translates directly into faster bug fixes and more reliable updates. For players, this means fewer crashes and quicker patches when new Minecraft versions drop. For modpack developers, it means fewer mysterious conflicts to debug.
- Lightweight Footprint — Oculus appears to be lightweight in its base resource usage, adding shader support without the bloat of a full rendering overhaul. When shaders are disabled, the mod has minimal overhead, so you can keep it installed in your modpack even when you want maximum performance during resource-heavy activities like chunk loading.
- Wide Version Support — With builds available from Minecraft 1.16.5 all the way through 1.20.1, Oculus covers a broad range of popular modded Minecraft versions. Whether you are playing an older 1.16.5 kitchen-sink pack or the latest 1.20.1 modpack, shader support is available without switching your entire mod loader.
How to Install Oculus Mod
- Install Minecraft Forge or NeoForge for your target Minecraft version (1.20.1 recommended for the widest mod support).
- Download and install Rubidium — this is the Forge port of Sodium and serves as the rendering backend that Oculus relies on for optimal performance.
- Download the correct Oculus .jar file for your Minecraft version from the download section below.
- Place the Oculus .jar file into your
.minecraft/modsfolder (or your modpack instance's mods folder if using a launcher like CurseForge or Prism Launcher). - Launch Minecraft, open Options → Video Settings → Shader Packs, and select your preferred shader pack. If you do not have any shader packs yet, download one from the Iris shaders website or Modrinth.
Requirements & Compatibility
| Requirement | Details |
|---|---|
| Mod Loader | Minecraft Forge or NeoForge |
| Minecraft Versions | 1.16.5, 1.18.2, 1.19–1.19.4, 1.20–1.20.1 |
| Required Dependency | Rubidium (recommended for best performance) |
| Shader Packs | All OptiFine / ShadersMod / Iris-compatible packs |
| License | LGPL-3.0-only (open source) |
| NeoForge Support | Available for Minecraft 1.20.1 |
What's New
- Fixed rendering issues with the MekaSuit from the Mekanism mod, resolving visual glitches when shaders were active.
- Continued compatibility improvements for modded armor and equipment rendering under shader packs.
- Ongoing stability fixes for Forge and NeoForge environments running complex modpacks.
Pros and Cons
Pros
- Brings full Iris shader support to Forge and NeoForge players
- Compatible with all existing OptiFine and ShadersMod shader packs
- Over 23 million downloads — widely tested and community-trusted
- Open source under LGPL-3.0 with an active GitHub repository
- Covers a wide range of Minecraft versions from 1.16.5 to 1.20.1
Cons
- Unofficial fork — bugs should not be reported to the Iris team
- Requires Rubidium as a dependency for best results, adding an extra install step
- NeoForge support is currently limited to 1.20.1 only
- No support for Minecraft versions newer than 1.20.1 at this time
Alternatives to Oculus Mod
- Iris Shaders — The original Fabric-based shader mod that Oculus is forked from; choose Iris if you play on Fabric or Quilt instead of Forge.
- OptiFine — The classic all-in-one optimization and shader mod for Minecraft, though it may cause compatibility issues in heavily modded Forge packs.
- Rubidium — A Forge port of Sodium that serves as a performance optimization companion to Oculus, handling rendering improvements while Oculus handles shaders.
Download Oculus Mod
| Minecraft Version | Forge | NeoForge |
|---|---|---|
| For Minecraft 1.20.1 | Download | Download |
| For Minecraft 1.20 | Download | — |
| For Minecraft 1.19.4 | Download | — |
| For Minecraft 1.19.2 | Download | — |
| For Minecraft 1.19.1 | Download | — |
| For Minecraft 1.19 | Download | — |
| For Minecraft 1.18.2 | Download | — |
| For Minecraft 1.16.5 | Download | — |
Always download mods from official sources to stay safe.
Frequently Asked Questions
Is Oculus the same as Iris?
No — Oculus is an unofficial fork of Iris, specifically rebuilt to work with Forge Mod Loader (FML) and NeoForge. While it shares the same core shader rendering technology, Oculus is maintained separately by Asek3. Any bugs found in Oculus should be reported to the Oculus GitHub repository, not to the official Iris team.
Does Oculus work with OptiFine shader packs?
Yes — all existing OptiFine and ShadersMod shader packs are compatible with Oculus without any modifications. You can use popular packs like BSL Shaders, Complementary Reimagined, and Sildur's Vibrant Shaders exactly as you would with OptiFine. Simply place your shader pack .zip file in the shaderpacks folder and select it from the video settings menu.
Do I need Rubidium to use Oculus?
Rubidium is strongly recommended but may not be strictly required for basic functionality. Oculus is designed to fully utilize your GPU when paired with Rubidium, which is the Forge port of Sodium. Without Rubidium, you may experience lower frame rates and miss out on the rendering optimizations that make shaders run smoothly in modded environments.
Can I use Oculus with NeoForge?
Yes — Oculus supports NeoForge for Minecraft 1.20.1. For older Minecraft versions (1.16.5 through 1.20), only standard Forge builds are available. If you are using NeoForge on a version other than 1.20.1, you will need to check for an updated build or use the Forge version instead.
Why are my shaders causing crashes with Oculus?
Shader crashes are most commonly caused by outdated shader packs or missing dependencies. First, make sure you have the correct version of Rubidium installed for your Minecraft version. Then verify your shader pack is up to date — older shader packs designed for very early OptiFine versions may have compatibility issues. If crashes persist, try a different shader pack to isolate whether the issue is pack-specific or a broader mod conflict in your modpack.
