VoxyServer: Stream LODs to Clients in Minecraft

VoxyServer

If you run a Fabric-based Minecraft server, you know the pain of clients struggling to load massive worlds. Traditional chunk loading forces every player to scan and render the terrain themselves, which can lead to lag, stuttering, and long loading screens. VoxyServer changes that entirely. This server-side mod voxelizes chunks into Level of Detail (LOD) data and streams it directly to connected clients, making exploration feel effortless. In this guide, we will break down what VoxyServer does, how it works, and exactly how to install it on your server.

What Is VoxyServer and Why Use It?

VoxyServer is a Fabric server-side mod that transforms standard Minecraft chunks into a specialized LOD format using the Voxy library. Instead of requiring each client to generate and store its own LOD data, the server does the heavy lifting. When a player with the compatible Voxy client mod connects, the server streams LOD sections in a spiral pattern around their position. As the player moves, new sections are automatically sent, and block changes like building or explosions are detected, revoxelized, and pushed to clients in real time.

The biggest advantage is that players without Voxy are completely unaffected. They will see the world as they normally would, while Voxy users enjoy a smooth, pre-generated view of distant terrain. This makes VoxyServer an excellent choice for large survival servers, creative builds, or any world where exploring far distances is common. For the latest versions, VoxyServer supports Minecraft 26.1.x on the Fabric loader, ensuring you can use it with modern modpacks.

How Does the Streaming Process Work?

When chunks load on the server, they are immediately voxelized into Voxy's LOD format and stored in a per-world database. This database lives in the <world>/voxyserver/ folder. The server then streams these sections to players in a spiral outward from their current location. If a player breaks a block or triggers an explosion, the affected LOD sections are marked as dirty, revoxelized, and sent to all connected Voxy clients automatically. This ensures that what you see on screen always matches the actual server state.

One of the most powerful features is the ability to backfill existing worlds. Using an admin command, you can import already generated chunks from region files without requiring players to revisit each area. This is a huge time-saver for established servers that want to adopt VoxyServer without forcing everyone to explore new terrain.

How to Install VoxyServer on Your Server

Installing VoxyServer is straightforward, but you need to ensure both the server and the clients have the right files. The installation process is simple: drop the VoxyServer, Voxy, and Sodium jars into the server's mods folder. No other server-side dependencies are needed. Clients also need VoxyServer, along with Voxy and Sodium, to receive the LOD data. For a smooth experience, you can use a launcher that supports mod management. For example, the foxygame.net launcher offers a one-click install for VoxyServer and its dependencies, making it easy to get your server running without manually tracking down each jar file. This launcher also handles version compatibility, so you can be sure your setup matches your server's Minecraft version.

To understand how to install VoxyServer correctly, follow these steps:

• Download the VoxyServer, Voxy, and Sodium mod jars for your exact Minecraft version (e.g., 26.1.x).
• Place all three files into your server's mods folder.
• Restart your server to generate the default configuration file.
• Ask each player to install the same three mods on their client.

Once installed, the server will automatically stream LODs to any player with Voxy active. There is no need for client-side world scanning or chunk loading, which dramatically reduces memory usage and improves frame rates.

Configuring VoxyServer for Optimal Performance

After the first run, a config file is generated at config/voxyserver.json. Here are the key settings you can tweak:

• lodStreamRadius: Radius in chunks to stream LODs around each player.
• maxSectionsPerTickPerPlayer: Maximum LOD sections sent per player per tick cycle.
• sectionsPerPacket: Max LOD sections bundled into a single network packet.
• tickInterval: Server ticks between each streaming cycle.
• workerThreads: Amount of worker threads for Voxy to use.
• generateOnChunkLoad: Voxelize chunks as they load on the server.
• dirtyTrackingEnabled: Revoxelize and push LODs when blocks change.
• dirtyTrackingInterval: Ticks between dirty chunk flushes.
• debugTrackingEnabled: Output internal server stats to the console periodically.
• debugTrackingInterval: Ticks between dumping tracking stats.

Players can also adjust their personal streaming preferences if they have ModMenu and Cloth Config installed. From the mods list, they can open the VoxyServer config screen to toggle LOD streaming, set their personal LOD stream radius, or adjust the max sections per tick. These values are capped at the server's configured maximums and sent to the server automatically when saved.

Admin Commands for World Imports

Server admins can import existing generated chunks into Voxy storage using the following commands:

• /voxyserver import existing all – Imports all loaded dimensions that have a region folder.
• /voxyserver import existing current – Imports the current dimension of the executing player.
• /voxyserver import existing dimension <dimension> – Imports a specific loaded dimension, for example minecraft:overworld.
• /voxyserver import existing status – Shows the current import status.
• /voxyserver import existing cancel – Cancels the active import job.

These imports run sequentially and read existing region files directly, which is much faster than waiting for chunks to be loaded normally. Imported dimensions are refreshed for connected Voxy clients automatically once the import completes.

Final Thoughts on VoxyServer for Minecraft

VoxyServer is a game-changer for Fabric servers that want to offer a premium exploration experience without sacrificing server performance. By streaming pre-voxelized LOD data, you eliminate the need for clients to scan chunks, which is especially beneficial for large worlds or servers with many players. The configuration options give you fine control over bandwidth and CPU usage, while the import commands make it easy to adopt VoxyServer on an existing world. If you are looking for a way to reduce client lag and improve visual distance, download VoxyServer and give it a try. With its GPLv3 license, it is free to use and modify, making it a solid addition to any modded Minecraft setup. Whether you are running a small community server or a large network, VoxyServer for Minecraft is a reliable choice that delivers tangible performance benefits.