Гайд по BlueMap: 3D-веб-карта для вашего сервера Minecraft

Что такое BlueMap

BlueMap читает файлы вашего мира, рендерит их в 3D-тайлы карты и отдаёт через небольшой встроенный веб-сервер. Вблизи вы видите блоки в полном 3D, издалека — плоский обзор. Живые маркеры показывают, где находятся игроки, а карта обновляется по мере изменения мира.

Он рендерит только миры Java Edition. Текущий выпуск, BlueMap 5.29, есть в версиях для:

Для более старой версии Minecraft скачайте более старый выпуск BlueMap, в котором она указана. Каждый выпуск на Modrinth и Hangar показывает поддерживаемые версии.

Установка BlueMap

1. Скачайте файл для вашего сервера с Modrinth, Hangar или из релизов BlueMap на GitHub: jar -paper для Paper, -fabric для Fabric и так далее.
2. Положите его в папку plugins (Paper, Spigot) или mods (Fabric, Forge, NeoForge) и перезапустите сервер. Загрузка плагинов описана в гайде как установить плагины Minecraft.
3. BlueMap создаёт конфигурацию в plugins/BlueMap/ или в config/bluemap/ на модовых серверах, причём для каждого вашего мира карта уже настроена.

На этом этапе консоль сообщает, что BlueMap ждёт. Он ничего не будет рендерить, пока вы не примете загрузку, — это следующий шаг.

Примите загрузку в core.conf

Чтобы рисовать блоки, BlueMap нужны текстуры и модели из клиента Minecraft, которые он скачивает у Mojang. Откройте core.conf и измените:

accept-download: true

Устанавливая этот параметр, вы принимаете EULA Mojang и подтверждаете, что владеете Minecraft Java Edition. Сохраните файл и выполните /bluemap reload или перезапустите сервер. BlueMap скачает ресурсы и начнёт рендер.

Отдельный порт для веб-карты

Веб-сервер BlueMap по умолчанию слушает порт 8100. На своём компьютере откройте этот порт и зайдите на http://your-ip:8100. На хостинге обычно нельзя выбрать порт произвольно, поэтому используется порт, выделенный вашему серверу:

1. Получите второй порт для сервера. В HytHost откройте в панели вкладку Network и добавьте выделение: панель подберёт свободный порт и откроет его за вас.
2. Откройте webserver.conf и задайте этот номер в port:

   port: 25570

3. Выполните /bluemap reload и откройте в браузере http://your-server-ip:25570.

Не используйте игровой порт — он занят Minecraft. Чтобы показывать карту на своём домене без номера порта, поставьте перед ней обратный прокси, например nginx; в документации BlueMap есть готовые примеры.

Команды BlueMap

У каждой команды есть право вида bluemap.<command>, например bluemap.reload. Чаще всего ни одна из них не нужна: BlueMap сам замечает изменения в мире и рендерит их.

Как облегчить рендер

BlueMap рендерит в фоновых потоках, а не в главном потоке сервера, но рендер всё равно нагружает CPU. Тяжелее всего первый рендер большого мира; после него перерисовываются только изменённые чанки.

• Потоки рендера: задайте render-thread-count в core.conf. Документация BlueMap советует 1 на машинах с четырьмя ядрами или меньше.
• Рендерите, когда тихо: выполняйте /bluemap stop в часы пик и /bluemap start ночью, пока идёт первый рендер.
• Пауза при игроках онлайн: player-render-limit в plugin.conf останавливает рендер, когда онлайн набирается указанное число игроков.
• Установите границу мира. Она не даёт карте, а вместе с ней и работе рендера, бесконечно расти, пока игроки исследуют мир.
• Заморозьте карты, которым не нужно обновляться вживую, например Энд после того, как его исследовали.

Хранилище: файлы или база данных

По умолчанию BlueMap хранит карту в виде сжатых файлов в bluemap/web/maps, на диске вашего сервера. Карта растёт вместе с исследованной областью, так что на большом мире следите за местом на диске.

Карту можно перенести в базу данных. В storages/sql.conf настройте подключение к MySQL, MariaDB, PostgreSQL или SQLite, затем укажите storage: "sql" в конфиге карты и выполните перезагрузку:

connection-url: "jdbc:mysql://DB_HOST:3306/DB_NAME"
connection-properties: {
    user: "DB_USER",
    password: "DB_PASSWORD"
}

В Paper уже есть драйвер MySQL; для Spigot, Fabric и Forge нужно добавить драйвер JDBC. Каждый тариф Minecraft от HytHost включает базы данных MySQL, которые создаются во вкладке Databases панели.