Voxy NeoForge 1.21.1

Unofficial NeoForge port of the Voxy mod

Special Thanks

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.

License Notice

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.

About

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.

Why This Port?

You might wonder: "Why not just use the Fabric version with Sinytra Connector?"

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.

Status

Alpha - Functional with known limitations.

Working Features

• 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

Current Limitations

• 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)

Requirements

Required Dependencies

Recommended Dependencies

Installation

Note: Due to Voxy's ARR (All Rights Reserved) license, compiled JARs are not distributed. You must build from source.

1. Install NeoForge for Minecraft 1.21.1
2. Install required dependencies (see above)
3. Build Voxy from source (see below)
4. Place the built JAR in your mods folder

Building from Source

git clone https://github.com/j-shelfwood/voxy-neoforge.git
cd voxy-neoforge
./gradlew build

The built JAR will be in build/libs/.

Contributing

For development guidelines, see CLAUDE.md.

Validation Scripts

The scripts/ directory contains build validation tools used in CI.

Links

• Original Voxy: github.com/MCRcortex/voxy
• This Port: github.com/j-shelfwood/voxy-neoforge
• Sinytra Connector (alternative): github.com/Sinytra/Connector