Enables players with Voxy to see fully rendered terrain out to hundreds of chunks on multiplayer servers without needing to explore the world first. Also includes Far Players: players far beyond normal render distance appear in the LOD terrain with name tags, equipment, and mounts.
Try it live: join lod-server-support.modrinth.gg with Voxy and this mod installed. Supports Minecraft 26.2, 26.1, 1.21.11, 1.21.10, and 1.21.1.
Lss-Demo-Paper.mp4
Clients use the Fabric mod on every version; on 26.2, 26.1, and 1.21.1 a NeoForge client works as well. Supported servers:
| Minecraft line | Fabric / Paper | Folia | NeoForge shipping | Neo far renderer |
|---|---|---|---|---|
| 1.21.1 | maintained | unsupported | shipped; best-effort | available |
| 1.21.10 | maintained | unsupported | maintained build only | unsupported |
| 1.21.11 | maintained | experimental | maintained build only | unsupported |
| 26.1 | maintained | experimental | shipped; best-effort | unsupported |
| 26.2 | maintained | experimental | shipped; best-effort | unsupported |
NeoForge 1.21.1 has distinct native and Connector dependency routes. The recorded 2026-09-08 native Voxy 0.2.9-alpha trial was rejected; older successful reports do not establish current compatibility or its failure's upstream cause. Xaero-only legacy Sodium and the modern Connector Voxy route are separate profiles. Use the dated profile inventory and exact dependency locks; do not combine their jars by filename.
The in-game settings page (Sodium's Video Settings → the LSS entry or tabs; on Fabric also ModMenu's Configure button) renders on both Sodium generations from v0.13.0: on Sodium 0.8+ it appears under LSS's own entry in the settings screen; on Sodium 0.6/0.7 (MC ≤1.21.10 and the 1.21.1 Voxy-fork pairing) it appears as LSS tabs beside Sodium's own. On NeoForge the page renders on both generations too — the 0.6/0.7 tabs on the Voxy-fork pairing, and LSS's own entry on native NeoForge Sodium 0.8+ builds (what the Connector stack pairs with) — including far-player options where the renderer is available (NeoForge 1.21.1). Other NeoForge lines retain intentional renderer stubs.
Compatible with AntiXray, Moonrise, C2ME, ViaVersion/ViaBackwards, and most other mods. Can be run alongside Distant Horizons on the same server to support DH clients and Voxy clients simultaneously.
With Xaero's World Map 1.42.0 or newer installed on the client, downloaded LOD terrain is also written into the world map, so the map fills in far beyond vanilla render distance (multiplayer only — for single-player worldgen use Xaero WorldGen instead). This works even without Voxy: Xaero's Map plus this mod alone will download and map the server's terrain. The bridge is OFF by default (map writes are saved map data — chunks near you stay Xaero's own and Xaero redraws its tiles whenever you revisit an area, but distant LOD-drawn tiles, slightly simplified and matching any anti-x-ray masking the server applies, persist until you do): turn it on with the "Write LODs to Xaero's Map" toggle on the LSS Sodium options page, or integrations.xaero.enabled in lss-client-config.yaml, then run /lss reload and reconnect. Tiles go to the map's surface layer; while the map is showing a cave layer (underground with auto cave mode, and the Nether by default) terrain that arrives is not written to the map and is not retried — revisiting the area (or /lss clearcache) backfills it — and the bridge follows Xaero's own "Load New Chunks" / "Update Chunks" switches. While the map is catching up on a big download, LOD delivery is paced to what the map can draw (enableXaeroMapBackpressure, default on), so the map fills in completely as it goes at a slightly slower rate — including brief full pauses of the LOD download (a few seconds) while the map itself is busy writing the terrain around you. On a server you had already explored before installing, run /lss clearcache once while connected to re-stream the terrain and backfill the map (a full re-download).
LOD Server Support is backwards and forwards compatible from v0.4.0 through the current version. Server operators can freely update to take advantage of improvements without breaking clients on older versions, and clients can update without breaking compatibility with older servers.
Far players. Players beyond your normal render distance are drawn as player models in the LOD terrain (Fabric client), lit as if under open sky (or at full brightness, mounts included, with the "Full Bright Far Players" option / far_players.full_bright in lss-client-config.yaml), with their name tags (also drawn over players still in normal range once they are past the game's own name-tag distance) and, within about 80 blocks, their skin overlay layers (farther out the depth buffer cannot separate that thin shell from the body). Two limits worth knowing: players past the game's far plane (your render distance × 64 blocks; Iris shaders extend it) are not drawn at all, whatever the far-player render limit says; and with Iris shaders, packs whose Voxy integration keeps LOD depth out of the vanilla depth buffer (Complementary, for one) draw far players on top of LOD terrain instead of behind it.
Voxy Server Side is the same mod. Voxy Server Side clients are compatible with LOD Server Support servers and vice versa.
Install LOD Server Support on both the server (Fabric, Paper, or NeoForge on a line that ships it) and every participating client (the matching Fabric or NeoForge LSS mod, with Voxy or the enabled Xaero map bridge). The server and client both need LSS for its terrain download service.
NeoForge ships on MC 1.21.1, 26.1 and 26.2; the 1.21.10/1.21.11 modules remain maintained builds. NeoForge far-player rendering is live on 1.21.1 and remains an intentional stub on the other lines. See the loader/artifact matrix and validation profiles for the separate packaging, consumer and live-test boundaries.
/lsslod stats- Show per-player transfer statistics/lsslod diag- Show detailed diagnostics (config, bandwidth, queue depths)/lsslod reload- Validate server YAML and apply supported changes; report restart requirements/lsslod store status- Show LOD store status (state, hit/miss counters, size)/lsslod store backfill start|stop|status- Control the background pre-warm walk (not on Paper)/lsslod help- List all commands
-
/lss reload- Read saved client YAML and apply supported changes; report reconnect requirements -
/lss clearcache- Clear the local column cache, forcing all chunks to be re-requested from the server -
/lss reset- Wipe this server's LODs (local cache and Voxy's stored data) and re-stream them fresh -
/lss reset voxy-force- Same, but for the case where another mod has redirected Voxy's storage (a replay mod, or any other storage override) and the ordinary reset therefore left Voxy's disk data alone. Shows both storage paths first and deletes nothing until you run/lss reset voxy-force confirmwithin 60 seconds on the same connection -
/lss diag- Show client-side diagnostics (connection, throughput, scan progress, request budget)
Settings use annotated YAML: config/lss-server-config.yaml and
config/lss-client-config.yaml on Fabric/NeoForge, or
plugins/LodServerSupport/lss-server-config.yaml on Paper. VSS uses the corresponding
vss- names, adopting an existing file across brands. Startup migrates an old JSON
file once and retains both the original and an exact-byte backup. Existing distance
choices are preserved; fresh servers use 512 chunks in the Overworld and End,
64 in the Nether.
Migration accepts comments and the old loader's loose JSON syntax. It is one-way:
v0.15.x reads the retained JSON and ignores YAML edits, so copy any desired changes
back into JSON before downgrading. /lsslod set was removed; edit YAML and run
/lsslod reload instead.
Edit the file and run /lsslod reload on the server or /lss reload on the client.
Sodium Apply saves and reloads automatically. Direct YAML edits still need the
reload command. The menus support English, Simplified Chinese and Traditional Chinese.
Invalid files leave active settings unchanged. Reload reports values that require a
restart or reconnect; it does not rewrite comments or normalized values.
| Setting group | Purpose |
|---|---|
lod.distance |
Server distance defaults and dimension overrides; Paper adds exact world-name overrides. |
generation |
Enable generation, bound concurrent work, and set ticket timeouts in ticks. Disabling stops new admissions while existing work drains. |
network |
Bandwidth limits in MiB/s before compression, queues, pacing and yielding to vanilla traffic. |
storage.disk |
Read concurrency and reader-pool configuration. Concurrency reloads; changing the pool requires a restart. |
storage.lod_store |
Cache processed columns to save repeated parsing/serialization CPU, using additional disk space that can be comparable to the world itself. Cap, resweep and backfill controls reload; enabling the store requires a restart. |
privacy.xray |
Anti-xray policy and fallback masking. Changes require a restart. |
far_players |
Distant player display/sharing policies and distances in blocks. Players control local rendering manually. |
The client cache uses cache.use_world_sub_buckets to separate remote worlds and
cache.address_aliases to group equivalent addresses. With Voxy, aliases also need
matching LoD Mirror/storage corroboration; otherwise LSS retains separate address
caches. Changes take effect on the next physical connection. /lss diag shows the
active identity. See the complete settings reference
for exact keys, units, limits, defaults, zero meanings and activation timing.
See current performance diagnosis and tuning for workload-based checks, setting semantics and the measurement requirements for tuning. The settings reference records exact domains and apply timing.
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.
Current platform, shipping and renderer facts: compatibility matrix. Dependency locks describe candidates; dated feature evidence establishes tested combinations.
Thanks to SeeU for the inspiration for distant player rendering.