StereoCraft: Stereoscopic 3D

Side-by-side (SBS) stereoscopic 3D rendering for 3D TVs, 3D monitors, VR headsets, and any SBS-compatible display. StereoCraft splits the Minecraft window into left- and right-eye views with a configurable interpupillary distance (IPD) and convergence, producing a true stereoscopic image you can feed into any SBS display or HMD virtual-monitor passthrough.

StereoCraft ships for four Minecraft platforms from a single codebase — Fabric (26.1.2 and 1.21.11), NeoForge (1.21.1), and Angelica/GTNH (1.7.10) — with the same core feature set on each.

Supported versions

Platform Minecraft Loader / API Java Required renderer Fabric 26.1.2 Fabric Loader 0.19.3+ 25 Sodium mc26.1.2-0.8.12 Fabric 1.21.11 Fabric Loader 0.19.2+ 21 Sodium mc1.21.11-0.8.11 NeoForge 1.21.1 NeoForge 21.1.228+ 21 Sodium 0.6.13 (NeoForge) Angelica / GTNH 1.7.10 Forge 10.13.4.1614 GTNH runtime (Java 17–25 via lwjgl3ify) Angelica 2.1.x + GTNHLib

Grab the jar matching your Minecraft version and loader from the Releases page.

Features

• SBS-Half stereoscopic mode — splits the framebuffer left/right at half horizontal resolution per eye.
• Adjustable stereo strength (IPD) — 55–100 mm. 64 mm matches average human IPD; higher values give exaggerated "hyperstereo" depth.
• Convergence distance — sets the zero-parallax plane (what sits at the screen); nearer objects pop out, farther ones recede.
• Swap eyes — for SBS displays / passthrough setups with reversed eye assignment.
• Shader support via Iris (optional) — per-eye-correct deferred pipeline, shadows, reflections, and DH terrain.

Requirements

Every platform requires the Sodium-family renderer listed above as a hard dependency — on 1.7.10 this is provided by Angelica. Install the version matching your Minecraft/loader.

Optional

• Iris — shader-pack support. Each build is tested against one specific Iris version:
  • Fabric 26.1.2 → 1.10.9+26.1-fabric
  • Fabric 1.21.11 → 1.10.7+1.21.11-fabric
  • NeoForge 1.21.1 → 1.8.12
  • 1.7.10 → provided by Angelica
• Voxy (Fabric only) — per-eye LOD rendering (0.2.16-beta on 26.1.2, 0.2.15-beta on 1.21.11). Not available on NeoForge or 1.7.10.

Installation

1. Install the loader for your Minecraft version (Fabric / NeoForge / Forge+Angelica per the table).
2. Install the required renderer (Sodium — or Angelica on 1.7.10) into mods/.
3. (Optional) Install the matching Iris version for shaders, and/or Voxy on Fabric.
4. Download the StereoCraft jar for your platform from Releases and drop it into mods/.
5. Launch the game.

Configuration

Open Video Settings → Stereoscopic (added to Sodium's options page).

• Toggle the stereo Mode on/off here. Changing the mode triggers a renderer reload, so the screen may flash briefly (Sodium shows a small reload icon beside the option to indicate this).
• IPD, convergence, and swap eyes live on the same page.

Config file location:

• Fabric & NeoForge: config/stereoscopic-options.json
• 1.7.10 (Angelica): config/stereoscopic.cfg

Manual edits round-trip cleanly, but values changed in the in-game options page overwrite the file on save.

Known limitations

• Cursor in split-screen GUIs: the async-cursor feature that mirrors the OS cursor into both eyes is Windows-only. On Linux/macOS the cursor appears in only one eye while a screen (inventory, chat, menu) is open.
• Iris compatibility: each build is tested against one specific Iris version (above). Other versions may load but can silently degrade per-eye rendering — if you hit issues, file a report with your exact Iris version.
• Voxy: per-eye LOD is Fabric-only; the NeoForge Voxy port ships without its Iris integration, so it is disabled there.

Screenshot

License

StereoCraft is licensed under LGPL-3.0-only.