LOD Server Support

# LOD Server Support

Enables players with (https://modrinth.com/mod/voxy) to see fully rendered terrain out to hundreds of chunks on multiplayer servers without needing to explore the world first. Also includes far player rendering so you can also see other players far beyond the vanilla render distance.

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.

## Compatibility

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 | Fabric | Paper / Purpur | Folia | NeoForge | |---|---|---|---|---| | 26. 2 | ✅ | ✅ | ✅ | ✅ | | 26. 1 | ✅ | ✅ | ✅ | ✅ | | 1. 21. 11 | ✅ | ✅ | ✅ | - | | 1. 21. 10 | ✅ | ✅ | - | - | | 1. 21. 1 | ✅ | ✅ | - | ✅ |

Compatible with (https://modrinth.com/mod/anti-xray), (https://modrinth.com/mod/moonrise-opt), (https://modrinth.com/mod/c2me-fabric), (https://modrinth.com/plugin/viaversion)/(https://modrinth.com/plugin/viabackwards), and most other mods including Create. Can be run alongside Distant Horizons on the same server to support DH clients and Voxy clients simultaneously.

Can populate (https://modrinth.com/mod/xaeros-world-map) based on the LOD data, enable in client settings.

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.

On NeoForge (26. 2 and 26. 1) the tested client path is our (https://github.com/VoX/Foxy) (get it from the (https://github.com/VoX/Foxy/releases), it carries the Windows natives fix that stock Foxy lacks), which loads the regular Fabric Voxy jar on NeoForge. Tested with Sodium 0. 9. 1 + Voxy 0. 2. 18-beta on 26. 2 and Sodium 0. 8. 12 + Voxy 0. 2. 16-beta on 26. 1. 2, exact pairings in the Foxy README.

On NeoForge (1. 21. 1) there are two tested client paths, depending on your Sodium version:

• Sodium 0. 6. 13: the community (https://github.com/j-shelfwood/voxy-neoforge) with (https://modrinth.com/mod/forgified-fabric-api) in place of Fabric API. Tested working with Forgified Fabric API 0. 116. 15 and Voxy NeoForge port 0. 2. 9-alpha.
• Sodium 0. 8. 12 (required by current Create Aeronautics / Sable packs): the Fabric (https://github.com/m3t4f1v3/voxy/tree/mc_1211-sodium0. 8. 12) (0. 2. 15-beta, built from source) loaded through (https://modrinth.com/mod/connector) with Forgified Fabric API. Tested working inside a large Create pack with Connector 2. 0. 0-beta. 14, Forgified Fabric API 0. 116. 15, and Sodium 0. 8. 12-beta. 1.

(https://modrinth.com/plugin/voxy-server-side) is the same mod. Voxy Server Side clients are compatible with LOD Server Support servers and vice versa.

## Installation

Install LOD Server Support on both the server (LOD Server Support Fabric mod, Paper plugin, or NeoForge mod) and every client (LOD Server Support Fabric or NeoForge mod + Voxy). Without LOD Server Support on both the connecting client and on the server it will not function.

## Commands

### Server (Fabric, NeoForge, and Paper)

• `/lsslod stats` - Show per-player transfer statistics
• `/lsslod diag` - Show detailed diagnostics (config, bandwidth, queue depths)
• `/lsslod set ` - Change common settings live, no restart needed
• `/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

### Client (Fabric and NeoForge)

• `/lss clearcache` - Clear the local column cache, forcing all chunks to be re-requested from the server
• `/lss reset` - Wipe this worlds's LODs (local cache and Voxy's stored data) and re-stream them fresh
• `/lss diag` - Show client-side diagnostics (connection, throughput, scan progress, request budget)

## Configuration

Config files are generated during first run at `config/lss-server-config.json` on Fabric and NeoForge or `plugins/LodServerSupport/lss-server-config.json` on Paper.

| 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 | | `