Unofficial NeoForge port of the Voxy mod
All credit for Voxy goes to MCRcortex, the original author and creator of this incredible LOD rendering mod.
- Original Repository: MCRcortex/voxy
- Original Author: MCRcortex
This repository is a community port to NeoForge 1.21.1, created because the original author has indicated they will not be backporting to this version. We are deeply grateful for MCRcortex's work on Voxy.
The original Voxy mod is licensed under All Rights Reserved by MCRcortex. This port is provided for personal use. Please respect the original author's licensing terms.
Voxy is a Level-of-Detail (LOD) rendering mod for Minecraft that extends your view distance far beyond vanilla limits by rendering distant terrain at lower detail levels.
You might wonder: "Why not just use the Fabric version with Sinytra Connector?"
| Aspect | Native NeoForge Port (this repo) | Sinytra Connector |
|---|---|---|
| Performance | No translation overhead | Runtime translation layer |
| Mod Integration | Native NeoForge API calls | Fabric API emulation via FFAPI |
| Maintenance | Must track upstream Voxy changes | Just drop in Fabric jar |
| Stability | Tested against NeoForge directly | May have edge cases from translation |
| Dependencies | Forgified Fabric API | Connector + Forgified Fabric API |
Bottom line: For a performance-critical LOD mod like Voxy, eliminating the translation layer overhead is worthwhile. If you prioritize simplicity and don't mind potential overhead, Sinytra Connector is a valid alternative.
Alpha - Functional with known limitations.
- LOD terrain rendering beyond vanilla render distance
- Smooth transitions between LOD and vanilla chunks
- Fog integration (disabled at LOD boundaries)
- Block model baking for all render types (solid, cutout, cutout_mipped, translucent)
- Delayed chunk unloading to prevent pop-out effects
- Requires Sodium 0.6.13+ (NeoForge version)
- Some optional integrations not yet ported (Iris, Nvidium, Vivecraft)
- Debug screen integration disabled (MC 1.21.1 API changes)
| Dependency | Version | Link |
|---|---|---|
| Minecraft | 1.21.1 | - |
| NeoForge | 21.1.x | NeoForge |
| Sodium | mc1.21.1-0.6.13-neoforge | Modrinth |
| Forgified Fabric API | 0.116.7+2.2.0+1.21.1 | Modrinth |
| Dependency | Purpose | Link |
|---|---|---|
| Reese's Sodium Options | Better settings UI for Sodium + Voxy config access | Modrinth |
| Lithium | General performance improvements | Modrinth |
Note: Due to Voxy's ARR (All Rights Reserved) license, compiled JARs are not distributed. You must build from source.
- Install NeoForge for Minecraft 1.21.1
- Install required dependencies (see above)
- Build Voxy from source (see below)
- Place the built JAR in your
modsfolder
git clone https://github.com/j-shelfwood/voxy-neoforge.git
cd voxy-neoforge
./gradlew buildThe built JAR will be in build/libs/.
For development guidelines, see CLAUDE.md.
The scripts/ directory contains build validation tools used in CI.
- Original Voxy: github.com/MCRcortex/voxy
- This Port: github.com/j-shelfwood/voxy-neoforge
- Sinytra Connector (alternative): github.com/Sinytra/Connector