Voxy Server

VoxyServer

VoxyServer is a Fabric server side mod that voxelizes chunks into LODs using Voxy and streams them to connected clients. Players with Voxy and VoxyServer installed will receive LOD data from the server automatically, no client side world scanning or chunk loading needed. Players without Voxy are unaffected.

Latest: Minecraft 26.1.x | Fabric

How It Works

When chunks load on the server, they get voxelized into Voxy's LOD format and stored in a per world database on the server. When a player with Voxy & VoxyServer installed connects, the server streams LOD sections to them in a spiral outward from their position. As the player moves, new sections are sent automatically.

Block changes like building and explosions are detected, and the affected LOD sections are revoxelized and pushed to clients automatically.

Existing worlds can also be backfilled from their region files with an admin command, so already explored terrain can be voxelized without needing players to revisit it chunk by chunk.

Installation

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.

Configuration

A config file is generated at config/voxyserver.json on the first run.

• lodStreamRadius: Radius in chunks to stream LODs around each player.
• maxSectionsPerTickPerPlayer: Max 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.

Client Config

If the client has ModMenu and Cloth Config installed, players can open the VoxyServer config screen from the mods list to adjust their personal streaming preferences:

option	description
Enable LOD Streaming	toggle whether the server sends LOD data to you
LOD Stream Radius	personal LOD radius in blocks, 0 = use server default
Max Sections Per Tick	personal rate limit for sections sent per tick, 0 = use server default

these values are capped at the server's configured maximums and sent to the server automatically when saved.

Commands

Server admins can import existing generated chunks into Voxy storage. 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.

• /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.
• • /voxyserver config list
    lists all current configuration keys and values
• /voxyserver config get <key>
  shows the current value of a specific configuration setting
• /voxyserver config set <key> <value>
  updates a configuration setting live and saves it to the config file
• /voxyserver stats
  shows a snapshot of the engine's performance, counters, and player data
• /voxyserver stats continuous
  continuously sends stats updates to your chat every second
• /voxyserver stats stop
  stops the continuous stats updates

Storage

LOD data is stored per world at <world>/voxyserver/. This can be safely deleted to regenerate all LOD data.

License:

GNU GPLv3