VoxySync

Quick rating

Community listing page, reviews may not be monitored by the author.

VoxySync

No reviews yet

Sync server-pregenerated world MCA regions into Voxy LoD (full-map / radius modes). Requires Voxy 1.20.1 port on the client. GPL-3.0.

Mod Loaders
Minecraft

About

Description

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