StereoCraft: Stereoscopic 3D

Side-by-side (SBS) stereoscopic 3D rendering for vanilla Minecraft.

What's new in v0.1.1

• Convergence distance — new per-eye projection shear so objects at a configured depth sit at the screen plane (zero parallax); closer pops out, farther recedes. Slider in the Sodium options page: 0–16 blocks, default 4. Set to 0 for classic parallel-axis stereo (no shear). Math is unit-tested in the new StereoMath helper.
• IPD slider narrowed to 55–75 mm — the previous 0–500 mm range was unwieldy; 55–75 mm covers ~99% of adults at ~1 mm per slider tick. Legacy configs with out-of-range values get a one-time warn log and are clamped on load.
• Iris pipeline auto-rebuild on first stereo-active frame — fixes the launch-with-stereo-on-and-shaderpack-loaded case where Iris's pipeline cache was stale on the first frame, previously requiring a manual shader toggle each session.

Requirements

• Minecraft 1.21.11
• Fabric Loader 0.19.2+
• Java 21
• Sodium 0.8.11+

Optional

• Iris 1.10.7+1.21.11-fabric for shader compatibility (tested only against this exact version)

Install

Drop stereoscopic-0.1.1.jar into your mods/ folder alongside Fabric API and Sodium.

Known limitations

• Async cursor in split-screen GUIs is Windows-only — Linux and macOS get vanilla one-eye cursor behavior while a screen is open.
• Iris compatibility tested only against 1.10.7+1.21.11-fabric; other Iris versions may load but may silently degrade per-eye rendering.