VoxyServer

## 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](https://modrinth.com/mod/modmenu) and [Cloth Config](https://modrinth.com/mod/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 ` 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 ` shows the current value of a specific configuration setting * `/voxyserver config set ` 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 `/voxyserver/`. This can be safely deleted to regenerate all LOD data. ### License: GNU GPLv3