Skip to main content

​
Installation

This guide walks you through installing Voxy World Gen V2 and all required dependencies.

​
Prerequisites

Before installing, ensure your system meets these requirements:

Minecraft

Version: 1.21.6 - 1.21.11Versions below 1.21.6 are not supported. The mod is tested on 1.21.11.

Java

Version: Java 21Java 21 is required. The mod will not work with older Java versions.

Fabric Loader

Version: >= 0.16.0Install Fabric Loader from fabricmc.net

Operating System

Platforms: Windows, macOS, LinuxThe mod is server-side compatible and works on dedicated servers.

​
Required Dependencies

These mods must be installed for Voxy World Gen V2 to function:
1

Fabric API

Download the latest version of Fabric API for your Minecraft version.Place the downloaded .jar file in your mods folder.
2

Cloth Config

Download Cloth Config version 15.0.127 or newer.This provides the configuration system used by the mod.Place the downloaded .jar file in your mods folder.

​
Optional Dependencies

These mods enhance Voxy World Gen V2 but are not required:
Voxy is the primary reason to use this mod. Without Voxy, chunks will still generate but won’t provide distant LOD rendering.
Download Voxy and place it in your mods folder. What Voxy provides:
  • Distant terrain rendering (LOD) up to 1024+ chunks
  • Automatic chunk ingestion from generation
  • Significant render distance improvements

​
Tellus (Optional)

Tellus provides Earth 1:1 scale terrain. Voxy World Gen V2 includes optimized generation for Tellus worlds.
Download Tellus if you want to explore real-world terrain. Tellus integration features:
  • Fast generation bypassing vanilla chunk generator
  • Direct Voxy ingestion of terrain data
  • Biome-aware surface rules for realistic terrain
  • Procedural tree and vegetation placement
ModMenu provides an in-game configuration GUI. Without it, you’ll need to edit the config file manually.
Download ModMenu to access the configuration screen from the game’s mod menu.

​
Installing the Mod

1

Download Voxy World Gen V2

Download the latest release from the mod’s download page.Make sure to download the version matching your Minecraft version (1.21.6-1.21.11).
2

Place in Mods Folder

Locate your Minecraft installation directory:
  • Windows: %appdata%\.minecraft\mods
  • macOS: ~/Library/Application Support/minecraft/mods
  • Linux: ~/.minecraft/mods
Place the downloaded voxyworldgenv2-<version>.jar file in the mods folder.
3

Verify Installation

Launch Minecraft with the Fabric profile.Check the game log for this message:
[INFO] voxy world gen v2 initializing
If Voxy is installed, you should also see:
[INFO] voxy integration initialized (enabled: true, raw: true)

​
Building from Source

If you want to build the mod yourself or contribute to development:
1

Clone the Repository

git clone https://github.com/iSeeEthan/voxy_worldgen_v2.git
cd voxy_worldgen_v2
2

Build with Gradle

Ensure Java 21 is installed and set as your JAVA_HOME.
./gradlew build
On Windows:
gradlew.bat build
3

Locate Built Artifact

After a successful build, find the compiled mod in:
build/libs/voxyworldgenv2-<version>.jar
Copy this file to your mods folder.
Building from source requires a complete development environment. Most users should download pre-built releases instead.

​
Troubleshooting Installation

​
Mod Not Loading

Ensure you’re running Java 21. In the Minecraft launcher, check your Java version:
  1. Open Minecraft Launcher
  2. Go to Installations → Your Fabric profile → Edit
  3. Check “Java Executable” path
  4. Verify it points to Java 21
Open the Minecraft Launcher and check your Fabric profile shows version 0.16.0 or newer.If not, reinstall Fabric Loader from fabricmc.net.
Some chunk generation mods may conflict. Try removing other world generation or pre-generation mods temporarily.
Check the latest log file at:.minecraft/logs/latest.logLook for error messages mentioning voxyworldgenv2.

​
Voxy Integration Not Working

Check that voxy-<version>.jar is present in your mods folder.Look for this log message:
[INFO] voxy integration initialized (enabled: true)
If you see voxy not present, integration disabled, Voxy isn’t being detected.
Ensure your Voxy version is compatible with Minecraft 1.21.6-1.21.11.The mod uses reflection to detect Voxy methods and should work across multiple Voxy versions.

​
Next Steps

Quick Start Guide

Learn how to configure and use the mod

Configuration Reference

Explore all available configuration options

Build docs developers (and LLMs) love

Get started for freeTalk to us