?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
LOD Server Support

LOD Server Support

Voxy multiplayer support (unofficial). Supports Fabric/Paper/Purpur/Folia servers and Fabric clients.

11.6Kdownloads
32followers
11.6Kdownloads
32followers

Compatibility

Minecraft: Java Edition

26.2
26.1.x
1.21.11
1.21.8
1.20.1

Platforms

Supported environments

Client-side
Server-side
Client and server

Links

Report issues View source

Tags

Creators

Details

Licensed MIT
Published 4 months ago
Updated 2 days ago

LOD Server Support

Enables 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 lod-server-support.modrinth.gg with Voxy and this mod installed. Supports MC 26.2, 26.1.x, and 1.21.11.

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.

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 512 Max LOD distance in chunks
mbPerSecondLimitPerPlayer 25.0 Per-player bandwidth cap in MiB/s (decimals like 12.5 work), counted before compression
mbPerSecondLimitGlobal 75.0 Total bandwidth cap across all players in MiB/s, counted before compression
enableChunkGeneration true Generate missing chunks on demand, so players see terrain nobody has visited
generationConcurrencyLimitGlobal 40 Max chunks generating server-wide at once
generationConcurrencyLimitPerPlayer 40 Max concurrently generating chunks per player
lodStore "on" (new installs) 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. The cost: it roughly doubles your world folder. Generated as "on" for brand-new servers; on an upgraded server whose config file doesn't have the key, it stays "off" until you enable it. 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. 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
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
enableV18Compat true Serve v0.7.x–v0.8.x clients natively — a full session, minus only the features their client predates. false drops them to the enableV16Compat fallback
enableV19Compat true Serve v0.9.x clients natively. false drops them to the enableV16Compat fallback
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

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.

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.