VoxySync

VoxySync

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

What is this?（用途）

Этот мод заставляет дальнюю прорисовку мгновенно работать на серверах с предгенерированными мирами: сервер стримит свои сырые файлы регионов (r.x.z.mca) клиентам, а клиент импортирует их через официальный пайплайн Voxy (WorldImporter) для построения LoD-данных — так игроки видят дальний ландшафт, не исследуя его самостоятельно.

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

Features（功能）

• режим all (по умолчанию в конфиге сервера): отправляет все регионы текущего измерения игрока (вся карта)
• режим radius (безопасный вариант): отправляет только регионы в радиусе N блоков вокруг игрока, начиная с ближайших
• Передача чанками с ограничением скорости (по умолчанию 1 МБ/с на игрока), инкрементальная синхронизация через клиентский кэш файлов (с поддержкой докачки)
• Прогресс отображается в action bar; корректный откат, если Voxy не установлен
• Серверные команды (OP): /voxysync status, enable, disable, mode radius|all, `radius , sync, devtest`

⚠️ Important warnings（重要说明）

• Режим всей карты (syncMode: "all") раскрывает данные мира: файлы MCA содержат содержимое сундуков, руды, скрытые структуры и сущности. Включайте только на доверенных серверах. Режим radius — безопасный по умолчанию в коде; для всей карты требуется явная настройка config/voxysync.json.
• Требует неофициальный порт Voxy 1.20.1 на клиенте (здесь не включён): официальный Voxy на Modrinth поддерживает 1.20.4+. Сборка 1.20.1, используемая этим сервером, — это порт от сообщества (voxy-0.2.7-alpha, на основе коммита 9edc41be). Этот мод не включает и не изменяет Voxy — он лишь вызывает его API импорта через рефлексию.
• Первая синхронизация всей карты объёмная: ~20 ГБ при 1 МБ/с ≈ 5,5 часов (настраивается через speedLimitKBps); с докачкой.

Dependencies（依赖）

• Обязательно: Fabric API
• Только клиент: порт Voxy 1.20.1 (см. раздел выше; нет на Modrinth)

License & Source

GPL-3.0-only. Адаптировано из MapSyncer-rebuild (GPL-3.0, автор Jiemoy). Исходники: https://github.com/ljh220300-eng/voxysync