Oculus Forge 0.3.0-beta.1

This is the first public beta and includes all user-facing changes since 0.2.0-alpha.1.

Available as separate builds for:

• Minecraft 1.21.11 / Forge 61.2.0 / Java 21
• Minecraft 26.2 / Forge 65.1.0 / Java 25

Shader-pack compatibility

• Added shader-program discovery under shaders/world0.
• Retained support for compatible programs in the root shaders directory.
• Added proper conditional GLSL preprocessing and bounded include expansion.
• Fixed unsupported-uniform errors caused by inactive preprocessor branches.
• Added support for comma-separated and defaulted uniform declarations.
• Added compatible color, depth, shadow-color, and noise texture aliases.
• Added additional camera, rain, night-vision, and Nether-biome uniforms.
• Fixed legacy texcoord and texCoord compatibility.
• BSL v10.1.1 and Complementary Reimagined r5.7.1 can now prepare, activate, and execute their compatible world0/final passes on both supported Minecraft versions.

Stability and recovery

• Fixed a Forge 61 rendering failure caused by accessing uniform buffers after a render pass started.
• Added transactional shader-pack replacement.
• Failed pack changes no longer immediately destroy the working shader state.
• The last-known-good shader source is retained and recompiled after resource reloads when necessary.
• Added clearer degraded-state and failure messages.
• Runtime rendering failures safely fall back to vanilla rendering.
• Improved pipeline and uniform-buffer cleanup.
• Verified clean world and game shutdown.

Rendering efficiency

• Multi-stage full-screen programs now use ping-pong color targets.
• Reduced unnecessary full-screen texture copies.
• Reuses one command encoder for the ordered shader-stage sequence.
• Shader-pack reading, preprocessing, and compilation remain outside the per-frame rendering path.

Shader-pack security

• Added limits for directory-pack file count, total size, individual file size, and symbolic links.
• Added a cumulative decompressed-data budget for ZIP shader packs.
• Retained protections against path traversal, malformed archives, duplicate entries, ZIP bombs, invalid UTF-8, include cycles, and excessively expanded shader sources.

Build improvements

• Updated to Gradle 9.6 and ForgeGradle 7.0.31.
• Removed the Gradle deprecation and future-version warnings found in the alpha builds.
• Uses Java 21 for Minecraft 1.21.11 and Java 25 for Minecraft 26.2.
• Updated to Forge's current frame-pass extraction API.
• Added the required Java 25 native-access configuration.
• Production and sources jars are reproducible and include SHA-256 checksums.
• Bundled JCPP is relocated and includes its Apache-2.0 license.

Validation

• 16 automated compatibility and security tests passed on each Minecraft target.
• Both builds passed with Gradle --warning-mode all.
• Tested with BSL v10.1.1 and Complementary Reimagined r5.7.1.
• Live-tested on Ryzen 5 5625U integrated AMD Radeon graphics with OpenGL 4.6 and 16 GB RAM.
• Tested window resizing, fullscreen transitions, rendering soaks, failed shader replacement, recovery, and clean shutdown.
• Microsoft Defender reported zero detections.

Known beta limitations

This remains a conservative full-screen compatibility renderer rather than a complete Iris/Oculus world renderer.

Terrain and entity gbuffers, real shadow maps, the complete render-attachment set, custom/normal/specular textures, full OptiFine/Iris shader semantics, and Vulkan shader rendering are not implemented yet.

Some complex packs may look closer to vanilla or reject unsupported features. This release does not claim universal shader-pack compatibility or measured FPS improvements.