ForgeOculus
ForgeOculus is a high-performance rendering bridge that brings the power of Iris/Oculus shaders to the Minecraft Forge 1.21+ ecosystem.
About this Mod
What is ForgeOculus?
This mod is a specialized port designed to provide a stable, modern shader pipeline for Forge users. Whether you are looking for realistic lighting, dynamic shadows, or performance enhancements, ForgeOculus serves as the core rendering engine to make it happen.
Features
Shader Compatibility: Native support for the standard Iris and OptiFine-style shader pack format.
Modern Performance: Architected for 1.21.1 to ensure your graphics card is utilized efficiently.
Mod Compatibility: Designed to play nicely with complex Forge modpacks without conflicting with core game mechanics.
Installation Requirements
ForgeOculus requires the Beddium library to function.
Download Beddium: You can find the necessary library here: Beddium (GitHub Release)
Note: The developer of Beddium is currently in the process of republishing official versions to CurseForge. The link above provides a verified, compatible version for 1.21.1.
Install ForgeOculus: Place the ForgeOculus .jar file into your mods folder alongside Beddium.
Enjoy: Launch your game and select your favorite shader packs in the video settings menu.
Please, don't report ForgeOculus' issues to the official Iris/Oculus Github.
Available Versions
How to Install ForgeOculus on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "ForgeOculus". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
ForgeOculus server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is ForgeOculus compatible with forge?
ForgeOculus officially supports forge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with ForgeOculus – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if ForgeOculus consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install ForgeOculus with just one click on your server.