Voxy Server

Voxy server is a fabric server side mod that voxelizes chunks into LODs using voxy and streams them to connected clients.

Загрузки: 27K
Подписчики: 67
Обновлён: 15 июня 2026 г.
Лицензия: LGPL-3.0-only

Опубликован 10 марта 2026 г.

Скачать 1.2.1(1.6 МБ)Исходный код

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

Центр версий

10 версий

Стабильная1.2.126.1.2 · 1.6 МБ

Версия Minecraft

Загрузчик

Релиз15 июня 2026 г.3K загрузок1.6 МБ
Релиз11 июня 2026 г.1K загрузок1.6 МБ
Релиз11 мая 2026 г.5K загрузок1.6 МБ
Релиз11 апреля 2026 г.8K загрузок1.2 МБ
Релиз11 апреля 2026 г.4K загрузок1.6 МБ
Релиз30 марта 2026 г.3K загрузок1.2 МБ
Релиз26 марта 2026 г.1K загрузок1.0 МБ
Релиз25 марта 2026 г.337 загрузок1.0 МБ
Релиз24 марта 2026 г.214 загрузок1.0 МБ
Релиз10 марта 2026 г.76 загрузок1.0 МБ

Ченджлог

1.2.1Релиз26.1, 26.1.1, 26.1.2 · 15 июня 2026 г.

fixing these two issues:

"Server & client only sync on login, and they only sync within a radius - if the player were to move to a different location that they already have voxy LODs for then the issue still persists (server does not request a new manifest based on the player moving around).

If you use a mod like Chunky to generate chunks outside of player render distance, then the hashes can get corrupted for the client - causing holes in the world that persist beyond reconnecting, requiring them to delete their clients .voxy folder to re-pull everything."

thanks @travismlee on github.

1.2.0Релиз26.1, 26.1.1, 26.1.2 · 11 июня 2026 г.

fixed resending on dimension change
fixed resending what client already has on server leave/join (content hashing)
config reloads without server restart
added in game commands to set/get/list config options
in game debug stats via cmd
handshake for client & server for protocol version & detect if client is outdated.

YOU MUST UPDATE BOTH CLIENT & SERVER!!! IF YOU WANT TO USE THIS VERSION.

1.1.6Релиз26.1, 26.1.1, 26.1.2 · 11 мая 2026 г.

Fix fps stutter on client ingest

1.1.5Релиз1.21.11 · 11 апреля 2026 г.

this version will perfom alot better on your server

Here are the changelogs:

huge performance boost: replaced sectionref/chunkref record keys with dimension ordinal encoded longs, cached biome id remapping per mapper, and moved lod packet pre serialization to the stream thread.
optimized lod payloads by palette bit packing index arrays.
increased default maxsectionspertickperplayer from 10 to 100.
added per server client side config overrides via modmenu & cloth config api. preferences save to config/voxyserver-client.json (keyed by host:port). it defaults to a global profile if no override exists, and you can only edit a server's settings while connected to it. (you can't go above the set server settings, only below.)
added a config option to change voxy worker threads.
fixed a crash involving c2me and voxyserver (kept failsafe in the code even though it was fixed upstream, thanks cortex).

1.1.5Релиз26.1, 26.1.1, 26.1.2 · 11 апреля 2026 г.

this version will perfom alot better on your server

Here are the changelogs:

huge performance boost: replaced sectionref/chunkref record keys with dimension ordinal encoded longs, cached biome id remapping per mapper, and moved lod packet pre serialization to the stream thread.
optimized lod payloads by palette bit packing index arrays.
increased default maxsectionspertickperplayer from 10 to 100.
added per server client side config overrides via modmenu & cloth config api. preferences save to config/voxyserver-client.json (keyed by host:port). it defaults to a global profile if no override exists, and you can only edit a server's settings while connected to it. (you can't go above the set server settings, only below.)
added a config option to change voxy worker threads.
fixed a crash involving c2me and voxyserver (kept failsafe in the code even though it was fixed upstream, thanks cortex).

1.1.4Релиз1.21.11 · 30 марта 2026 г.

clients can now configure the following options: 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
dirty tracking should actually work properly now with higher max sections per tick
a bit of backend was rewritten: callback driven dirty tracking, versioned sent state, cursor based scanning, coalesced snapshot batching with bounded dirty draining, initial load settle gate with chunk footprint checks, chunk load ingest retries, flush ready bypass for pending sections.
voxyserver is disabled in singleplayer now to stop issues.
the import command actually now works for dimensions instead of just all
during import it shows an eta (it's meh sorta accurate, it's an issue with voxy, ill make a pr and if it gets changed ill update and itll be accurate)
lwjgl for ARM64 linux is now bundled into the mod, so anyone running that can now run voxyserver.
packets are now batched so you can run very high maxSectionsPerTickPerPlayer without being kicked for packet too large error. (if you ever get kicked for too large a packet, lower sectionsPerPacket in config.)

performance should also be better

1.1.3Релиз1.21.11 · 26 марта 2026 г.

fix lag spikes by switching dirty tracking from 2d chunks to 3d sections, lodstreamingservice now only serializes and pushes the specific changed section instead of the entire vertical column

1.1.2Релиз1.21.11 · 25 марта 2026 г.

prevent block updates from leaking to other dimensions. added dimension verification in LodStreamingService sooo lod updates are only broadcast to players currently in that dimension