World Importer

World Importer

Мод для Minecraft, предназначенный для загрузки и вставки локальных MCA-файлов регионов мира на сервер.

Клиент парсит MCA-файлы, извлекает NBT-данные чанк за чанком и загружает их на сервер. Сервер заменяет чанки (блоки, биомы, блочные сущности) в реальном времени без необходимости перезапуска. После завершения импорта он автоматически пересчитывает освещение и синхронизирует чанки со всеми игроками.

Поддерживает Fabric / Forge / NeoForge, совместим с Minecraft 1.19 ~ 1.20.6.

! ВНИМАНИЕ: Этот мод напрямую перезапишет все чанки из MCA-файла на сервере! Не вставляйте в областях с существующими постройками! Настоятельно рекомендуется сделать резервную копию перед вставкой!

Версии

Использование

1. Установите мод и на клиент, и на сервер.
2. Зайдите на сервер, встаньте в нужное место и выполните /wi setpos, чтобы задать точку вставки.
3. Выполните `/wi select , чтобы выбрать локальную папку regionмира (или нажмитеK`, чтобы открыть GUI настроек и вписать путь).
4. Выполните /wi start, чтобы начать загрузку (или нажмите «Start Upload» в GUI настроек).
5. Дождитесь завершения импорта (HUD будет показывать полосу прогресса и TPS).
6. После завершения импорта освещение обновится автоматически, а чанки синхронизируются.

Команды

Все команды требуют прав оператора (уровень 2).

Настройки

Нажмите клавишу K, чтобы открыть GUI настроек (также доступен через Mod Menu на Fabric). Можно настроить:

Когда авто-троттлинг включён:

• TPS ≥ 18: используется настроенный интервал загрузки.
• TPS ≤ 15: автоматически снижается до максимального интервала (40 тиков).
• Для промежуточных значений используется линейная интерполяция.

Файл конфигурации сохраняется в .minecraft/config/world_importer.json.

HUD

Во время импорта в верхней части экрана отображается:

• Importing — зелёная полоса прогресса + Completed / Total.
• Lighting Update — голубая полоса прогресса.
• Syncing Chunks — фиолетовая полоса прогресса.
• Справа от полосы прогресса отображается TPS сервера (зелёный/жёлтый/красный).

Сборка

# Собрать все версии и все загрузчики
./gradlew build

# Собрать только все версии Fabric
./gradlew build -Ploader=fabric

# Собрать только все версии Forge/NeoForge
./gradlew build -Ploader=forge

# Собрать только конкретную версию MC
./gradlew build -Pver=1201

# Комбинация: собрать только 1.20.4 для Fabric
./gradlew build -Pver=4 -Ploader=fabric

# Запустить клиент (по умолчанию 1.20.1 Fabric)
./gradlew runClient

# Запустить клиент: указать версию и загрузчик
./gradlew runClient -Pver=4 -Ploader=forge

# Запустить сервер
./gradlew runServer -Pver=1 -Ploader=fabric

# Собрать все jar-файлы в release/
./gradlew collectJars

# Очистить всё
./gradlew cleanAll

Поддерживаемые значения -Ploader: fabric, forge

Технические детали

• Клиент парсит бинарный формат MCA (заголовок 4096 байт → смещения секторов → извлекает сжатый NBT чанк за чанком).
• Сервер распаковывает NBT → парсит PalettedContainer (состояния блоков + биомы) в sections → заменяет всю секцию → пересчитывает heightmaps → загружает блочные сущности.
• Обновления освещения используют метод перезаписи NBT чанка → очищает исходные данные освещения и пересчитывает их.
• Контроль трафика: сервер уведомляет клиент о необходимости отправить следующий чанк только после завершения предыдущего, в сочетании с автотроттлингом по TPS.
• В конце удаляется исходный кэш отрисовки чанков клиента и обновлённые чанки отправляются клиенту.

Зависимости

• Architectury API
• Mod Menu (опционально для Fabric)

Лицензия

MIT License © rolling_cat

————————

# 构建全部版本、全部加载器
./gradlew build

# 只构建 Fabric 全版本
./gradlew build -Ploader=fabric

# 只构建 Forge/NeoForge 全版本
./gradlew build -Ploader=forge

# 只构建某个 MC 版本
./gradlew build -Pver=1201

# 组合：只构建 1.20.4 的 Fabric
./gradlew build -Pver=4 -Ploader=fabric

# 启动客户端（默认 1.20.1 fabric）
./gradlew runClient

# 启动客户端：指定版本和加载器
./gradlew runClient -Pver=4 -Ploader=forge

# 启动服务端
./gradlew runServer -Pver=1 -Ploader=fabric

# 收集所有 jar 到 release/
./gradlew collectJars

# 清理全部
./gradlew cleanAll