LOD Server Support

Players with Voxy can see fully rendered terrain out to hundreds of chunks on multiplayer servers without needing to explore the world first.

Supports Fabric clients and Fabric, Paper, Purpur, Folia servers.

See https://github.com/VoX/lod-server-support for the most up to date documentation.

Demo Video: https://github.com/user-attachments/assets/721fb344-890e-4e03-ab36-539444427f7b

Try it live: join our Minecraft 26.2 test server at lod-server-support.modrinth.gg with Voxy and this mod installed to watch the LOD terrain stream in.

Minecraft 26.1 community server with LSS: https://vanillaeuropa.com

Installation

Install LOD Server Support (LSS) on both the server (Fabric mod or Paper plugin) and every client (LSS Fabric mod + Voxy). Without LSS on both the connecting client and on the server it will not function. Clients additionally need Voxy installed.

Redistribution

This mod is MIT-licensed — redistribution with attribution is welcome, and modpacks can reference the official Modrinth project directly. Per Modrinth's reupload policy: XANTHA via Voxy Server Side has the copyright holder's explicit permission to distribute this mod, and derivatives of it, on Modrinth.

Commands

Server (Fabric and Paper)

• /lsslod stats - Show per-player transfer statistics
• /lsslod diag - Show detailed diagnostics (config, bandwidth, queue depths)

Client (Fabric only)

• /lss clearcache - Clear the local column cache, forcing all chunks to be re-requested from the server
• /lss diag - Show client-side diagnostics (connection, throughput, scan progress, request budget)

Configuration

Config is generated on first run at the paths in the install table above. The generated file documents every setting; the ones most worth knowing are:

Setting	Default	Description
enabled	true	Enable LOD distribution
lodDistanceChunks	256	Max LOD distance in chunks
bytesPerSecondLimitPerPlayer	26214400	Per-player bandwidth cap (25 MiB/s), counted before compression
bytesPerSecondLimitGlobal	268435456	Total bandwidth cap across all players (256 MiB/s), counted before compression
enableChunkGeneration	true	Generate missing chunks on demand, so players see terrain nobody has visited
generationConcurrencyLimitGlobal	32	Max chunks generating server-wide at once
generationConcurrencyLimitPerPlayer	16	Max concurrently generating chunks per player
lodStore	"off"	Recommended: set to "full". Keeps a compressed copy of every served LOD column in <world>/lss-lod/ and serves repeat requests from it — far less CPU and disk work per chunk. Off by default only because it roughly doubles your world folder, which you should agree to rather than discover. See Tuning
lodStoreBackfill	true	Pre-warms the store with a low-priority background walk of your existing world, so the first player to arrive already gets fast serves. Inert unless lodStore is on, so enabling the store gets this too. Yields to players, pauses under load, resumes across restarts. Fabric only
lodStoreMaxMB	0	Size cap for the store. 0 = uncapped; set a value to bound it, and the oldest columns are evicted first
useCompressedColumns	true	Send LOD columns pre-compressed, which cuts CPU on both server and client. Clients that do not support it are served the old format automatically; false disables it entirely as a rollback
useBackgroundReadPriority	true	LOD disk reads yield to normal chunk loading, so streaming distant terrain doesn't delay the chunks players are actively walking into
enableV16Compat	true	Serve legacy v0.4.x–v0.6.x clients through a built-in translation layer. false requires every client to match the server's protocol
xrayObfuscation	"auto"	Anti-xray masking for LOD data. "auto" mirrors your anti-xray engine's own hidden-block list and height cutoff whenever one is detected (Paper's built-in, per world; the DrexHD AntiXray mod on Fabric). "on" forces masking, "off" disables it — LOD data then carries real ore locations even on anti-xray servers
xrayHiddenBlocks / xrayMaxBlockHeight	ore list / 64	Fallback list and Y cutoff, used only when no engine settings can be adopted

Masking applies to columns served after it activates — columns already cached by clients are not recalled, as with any anti-xray retrofit. Cave shapes and lighting are not hidden, matching packet-level anti-xray.

Tuning

Turn the LOD store on if you can spare the disk. "lodStore": "full" It is the single biggest CPU performance win available. But it's off by default since it will roughly double the size of your world folder.

To limit CPU, use the bandwidth and generation limiters. LSS's cost is essentially how many columns per second it serves plus how many chunks it generates, and those two families cap exactly that:

• bytesPerSecondLimitPerPlayer / bytesPerSecondLimitGlobal bound the serve rate. They count uncompressed bytes on purpose, so compression doesn't quietly raise the real ceiling.
• generationConcurrencyLimitGlobal / generationConcurrencyLimitPerPlayer bound generation — by far the most expensive thing LSS can trigger, since it is worldgen. On a server exploring fresh terrain this dominates, and lowering it is the single biggest saving. enableChunkGeneration: false removes it entirely.