Oculus Community Port
Minecraft players who love stunning shaders but prefer the Forge mod loader have often felt left out. The popular Iris shader mod is built for Fabric, and the original Oculus project filled that gap for a while. Now, a dedicated team of community developers has stepped up with a fresh, independently maintained continuation. The Oculus Community Port is an unofficial, client-side Forge port that brings the Iris/Oculus shader-pack architecture back to life for modern Minecraft versions. This public beta is a significant leap forward in usability, stability, and security compared to earlier alpha builds.
What Is the Oculus Community Port?
The Oculus Community Port is a Forge mod that allows you to load and run OptiFine-style shader packs directly within your Minecraft client. It is not an official release from Mojang, Microsoft, Forge, Iris, Sodium, Embeddium, or any shader-pack developer. Instead, it is a community-driven project that re-implements the core architecture needed to translate and execute complex GLSL shaders on the Forge framework.
This add-on is strictly client-side. You install it only in your client's
mods folder, and it adds no blocks, items, entities, or server-side mechanics. Your dedicated server does not need the mod, and it will not affect vanilla gameplay for other players.
Supported Minecraft Versions and Loaders
The current beta supports two specific Minecraft and Forge combinations, and it is crucial to download the correct file for your instance. The two versions use separate JARs, so you must match the file to your exact Minecraft version.
- Minecraft 1.21.11 with Forge 61.2.0 and Java 21
- Minecraft 26.2 with Forge 65.1.0 and Java 25
The mod is designed exclusively for the Forge loader. It does not support Fabric or Quilt. Additionally, you must remove OptiFine from your mods folder, as the two are incompatible. The mod also requires an OpenGL-compatible graphics backend. Vulkan is detected safely, but shader-pack rendering is disabled when using Vulkan in this beta.
Key Features of the Public Beta
Version 0.3.0-beta.1 is the first public beta, and it brings substantial improvements over the initial alpha. The development team focused heavily on shader-pack loading, compatibility, and failure recovery.
Improved Shader-Pack Loading
The mod now discovers shader-pack directories and ZIP archives without extracting them. It supports packs whose active programs are located under
shaders/world0, while retaining support for the older root shaders full-screen layout. The GLSL preprocessor handles conditional compilation, common legacy declarations, and comma-separated uniforms more accurately.
Enhanced Rendering and Stability
The renderer uses Forge's modern frame graph and Minecraft's active GPU device. It executes compatible deferred, composite, and final full-screen stages in a deterministic order. A conservative compatible
world0/final path handles modern complex shader packs. The mod also uses transactional shader-pack replacement, meaning a failed pack swap no longer destroys your working shader state. It retains the last-known-good shader and can safely restore vanilla rendering if the active pass fails.
Security Protections
Shader packs are treated as untrusted local input. The loader includes protections against path traversal, symbolic links, malformed ZIP archives, duplicate entries, oversized files, excessive compression ratios, invalid UTF-8 source, include cycles, and excessive include depth.
Performance Design
The renderer avoids unnecessary work. Shader-pack disk access, preprocessing, and compilation do not occur every frame. Stable render-target descriptions are cached by size, and uniform data uses mapped ring buffers. Multi-stage rendering ping-pongs between two color targets, and one command encoder is reused for the complete ordered stage sequence. When shaders are disabled, no shader-pack program is compiled or executed.
The team has not completed a controlled average-FPS or 1%-low benchmark comparison, so this beta does not claim a measured FPS increase. However, the efficiency improvements should reduce overhead compared to naive implementations.
Tested Shader Packs
The beta was validated with two popular shader packs: BSL v10.1.1 and Complementary Reimagined r5.7.1. Both successfully activated and executed their compatible
world0/final passes during testing on an AMD Radeon integrated-GPU system. This confirms compatible final-pass activation, but it does not guarantee complete visual parity with Iris or the original Oculus.
Important Beta Limitations
This is not yet a complete Iris/Oculus world renderer. Major systems still missing include terrain and chunk gbuffer routing, entity and particle shader routing, hand and held-item shaders, pack-controlled sky and weather rendering, real shadow-map world rendering, the complete colortex and depthtex target systems, previous-frame history targets, and the full OptiFine/Iris properties system. Consequently, some shader packs may still fail, and successfully activated packs may look closer to vanilla than they do under full Iris or Oculus.
How to Install Oculus Community Port for Minecraft
The installation process is straightforward, but you must follow the version requirements carefully.
- Install one of the supported Minecraft and Forge combinations listed above.
- Ensure you are using the correct Java version (Java 21 for 1.21.11, Java 25 for 26.2).
- Download Oculus Community Port matching your exact Minecraft version. The 0.3.0-beta.1 production JAR is the one you need.
- Place the production JAR inside your client's
mods folder. Do not place the -sources.jar in mods.
- Start Minecraft once to generate the necessary config folders.
- Place shader-pack ZIPs or directories inside the instance's
shaderpacks folder.
- Open Mods, select Oculus Community Port, go to Config, choose a shader pack, enable shaders, and save.
If you are looking for a more streamlined setup, the foxygame.net launcher offers a curated add-on catalog where you can find and install Oculus Community Port with a single click, and it automatically handles version compatibility checks for your Forge instance. The launcher also keeps your mods updated, so you will always have the latest beta builds without manual file management.
Compatibility Notes
OptiFine is incompatible and must be removed. OpenGL is the supported shader backend. Vulkan is detected but disabled for shader rendering. Do not install the mod on a dedicated server. Other Forge mods and resource packs are best-effort compatibility while broader testing continues. The mod does not fabricate or bundle a dependency on Rubidium, Embeddium, or Sodium.
Reporting Problems
If you encounter issues, report them to the community port developers, not to the original Oculus or Iris teams. When filing a report, include your logs, Minecraft version, Forge version, Java version, mod version, GPU model and driver, active graphics backend, shader-pack name and version, installed mod list, and exact reproduction steps.
Conclusion
The Oculus Community Port is a promising and much-needed project for Forge users who want to enjoy modern shader packs. While it is still in beta and lacks some advanced rendering features, it offers a stable, secure, and performant foundation. If you have been waiting to run BSL or Complementary Reimagined on a recent Forge version, this is the mod to watch. Download Oculus Community Port today and give your Minecraft world a fresh visual upgrade.