VoxySync

Minecraft 1.20.1 · Fabric · 双端（服务端必装 / 客户端可选）· GPL-3.0-only

What is this?（用途）

This mod makes far-distance rendering work instantly on servers with pre-generated worlds: the server streams its raw region files (r.x.z.mca) to clients, and the client imports them through the official Voxy pipeline (WorldImporter) to build LoD data — so players see distant terrain without having to explore it themselves.

本模组让预生成世界的服务器玩家立刻获得超远渲染：服务器把原生区域文件发给客户端，客户端经 Voxy 官方导入管线转换为 LoD。

Features（功能）

• all mode (default per server config): send every region of the player's current dimension (full-map)
• radius mode (safe option): only send regions within N blocks around the player, nearest first
• Rate-limited chunked transfer (default 1 MB/s per player), incremental sync via client-side file cache (resume support)
• Progress shown in the action bar; graceful fallback when Voxy is not installed
• Server commands (OP): /voxysync status, enable, disable, mode radius|all, radius <blocks>, sync, devtest

⚠️ Important warnings（重要说明）

• full-map mode (syncMode: "all") exposes world data: MCA files contain chest contents, ores, hidden structures and entities. Only enable it on trusted servers. Radius mode is the safe default in code; full-map requires an explicit config/voxysync.json setting.
• Requires an unofficial Voxy 1.20.1 port on the client (not included here): the official Voxy on Modrinth supports 1.20.4+. The 1.20.1 build used by this server is a community port (voxy-0.2.7-alpha, based on commit 9edc41be). This mod does not include or modify Voxy — it only calls its import API via reflection.
• First full-map sync is large: ~20 GB at 1 MB/s ≈ 5.5 hours (configurable via speedLimitKBps); resumable.

Dependencies（依赖）

• Required: Fabric API
• Client only: Voxy 1.20.1 port (see section above; not on Modrinth)

License & Source

GPL-3.0-only. Adapted from MapSyncer-rebuild (GPL-3.0, by Jiemoy). Source: https://github.com/ljh220300-eng/voxysync