Веб-карта мира для сервера Minecraft — BlueMap

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 13:54, 17 ноября 2026; Maintenance script (обсуждение | вклад) (Новая статья: Веб-карта мира для сервера Minecraft — BlueMap (проверено на Ubuntu 24.04, со снимками экрана))
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к навигации Перейти к поиску

BlueMap рисует карту мира Minecraft и показывает её в браузере: объёмную, с рельефом, постройками и игроками, которые сейчас на сервере. Игрокам ничего ставить не нужно — достаточно ссылки. Карта помогает договориться, где строиться, найти друг друга и просто показать сервер тем, кто на него ещё не заходил. В статье — установка BlueMap на сервер Paper, первая отрисовка, настройки, команды и публикация карты для игроков. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4: Paper 26.3, BlueMap 5.29; снимки экрана сняты с настоящего сервера.

Сервер установлен по статье Установка и настройка Spigot-Paper сервера. Команды в примерах отправляются в консоль сервера скриптом mcc — он описан в статье Права и группы на сервере Minecraft — плагин LuckPerms; те же команды можно вводить в игре с косой чертой.

Что понадобится

  • Память и процессор. Отрисовка карты — тяжёлая работа: большой мир BlueMap рисует часами и занимает при этом ядро процессора. Если серверу уже тесно, сначала посмотрите Оптимизация производительности Minecraft сервера или возьмите тариф VDS на ступень выше.
  • Диск. Готовая карта хранится в файлах. Для небольшого мира это сотни мегабайт, для давно обжитого — гигабайты; следите за местом командой df -h.
  • Открытый порт 8100/tcp — на нём BlueMap отдаёт карту.

1. Установка

sudo systemctl stop minecraft
sudo -u minecraft bash -c 'cd /opt/minecraft/server/plugins && curl -sLO "$(curl -s "https://api.modrinth.com/v2/project/bluemap/version?loaders=%5B%22paper%22%5D" | jq -r ".[0].files[0].url")"'
sudo systemctl start minecraft
sudo ls /opt/minecraft/server/plugins | grep -i bluemap; sudo ls /opt/minecraft/server/plugins/BlueMap /opt/minecraft/server/plugins/BlueMap/maps
grep -E "BlueMap\] Enabling|Done \(" /opt/minecraft/server/logs/latest.log | cut -c34-110
sudo grep -n "^accept-download" /opt/minecraft/server/plugins/BlueMap/core.conf

После первого запуска плагин создал свои настройки — общие и по файлу на каждый мир — и остановился: в core.conf стоит accept-download: false.

2. Разрешение на загрузку и первая отрисовка

Чтобы нарисовать блоки, BlueMap нужны текстуры из самой игры. Он скачает их с серверов Mojang, но только с вашего согласия: меняя настройку на true, вы подтверждаете, что принимаете лицензионное соглашение Minecraft.

sudo -u minecraft sed -i 's/^accept-download: false/accept-download: true/' /opt/minecraft/server/plugins/BlueMap/core.conf
mcc "bluemap reload" | tail -n 3
mcc "bluemap" | tail -n 9
sudo ss -lntp | grep 8100 | awk '{print $1, $4}'
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:8100/

После перезагрузки плагин скачал файлы игры и начал отрисовку. Команда bluemap без параметров показывает состояние: пока идёт работа — сколько осталось, по окончании — «maps are updated». Веб-сервер карты слушает порт 8100 и отвечает кодом 200.

Откройте порт и карту:

sudo ufw allow 8100/tcp

В браузере — http://203.0.113.10:8100, подставив адрес своего VDS:

Карту можно вращать и приближать мышью. Кнопки вверху: список миров и список игроков слева; справа — день и ночь, три вида (объёмный, плоский, «от первого лица») и поле с координатами. На карте видны только те места, где кто-то уже был: Minecraft создаёт мир по мере того, как его исследуют. На снимке — участок вокруг точки появления на только что созданном сервере.

3. Настройки

sudo grep -E "^(render-thread-count|scan-for-mod-resources|metrics):" /opt/minecraft/server/plugins/BlueMap/core.conf
sudo grep -E "^(enabled|port|webroot):" /opt/minecraft/server/plugins/BlueMap/webserver.conf
sudo grep -E "^(world|dimension|name|sorting|min-inhabited-time|render-edges|enable-hires|save-hires-layer|storage):" /opt/minecraft/server/plugins/BlueMap/maps/world.conf
sudo du -sh /opt/minecraft/server/bluemap/web/maps/*

Файл Настройка Что задаёт
core.conf render-thread-count Сколько ядер отдать отрисовке. 1 — карта рисуется медленнее, зато игра не «проседает». Больше ставьте, только если ядра свободны
webserver.conf port Порт веб-сервера карты
webserver.conf enabled false — не запускать встроенный веб-сервер: файлы карты отдаёт другой сервер, например Nginx
maps/world.conf name Название карты в списке
maps/world.conf min-inhabited-time Не рисовать участки, где игроки провели меньше заданного времени. Убирает с карты «следы» случайных полётов и экономит место
maps/world.conf enable-hires Подробный объёмный слой. false — только плоская карта: намного меньше места на диске

На каждый мир — свой файл в каталоге maps: обычный мир, Нижний мир и Край. Чтобы не показывать мир на карте, удалите его файл и выполните bluemap reload. Сама карта лежит в /opt/minecraft/server/bluemap/web/maps; последняя команда на снимке показывает, сколько она занимает.

4. Команды

mcc "bluemap maps" | tail -n 8
mcc "bluemap freeze world_the_end" | tail -n 2
mcc "bluemap unfreeze world_the_end" | tail -n 2
mcc "bluemap update world" | tail -n 3

Команда Что делает
bluemap Состояние: что рисуется и сколько осталось
bluemap maps Список карт
bluemap update имя_карты Дорисовать изменившиеся участки
bluemap purge имя_карты Стереть карту и нарисовать заново
bluemap freeze имя_карты, bluemap unfreeze имя_карты Остановить и возобновить обновление карты
bluemap stop, bluemap start Приостановить и продолжить всю отрисовку — например, на время наплыва игроков
bluemap reload Перечитать настройки

Обновляется карта сама: BlueMap замечает изменённые участки и дорисовывает их в фоне.

5. Карта по доменному имени

Адрес с номером порта неудобно давать игрокам. Чтобы карта открывалась как https://map.example.com, поставьте перед ней обратный прокси с сертификатом: Установка Nginx Proxy Manager на Ubuntu 24.04 — целевой порт 8100 — или Настройка Nginx веб-сервера. После этого порт 8100 наружу можно закрыть.

Что не проверено

Проверены: установка, согласие на загрузку и первая отрисовка, веб-сервер, карта в браузере, настройки, команды. Не проверены: значки игроков на карте (на сервере не было игроков), отрисовка большого обжитого мира и её длительность, работа за обратным прокси.

Если что-то пошло не так

Что видите Причина и решение
Карта не рисуется, в журнале просьба принять загрузку В core.conf осталось accept-download: false — шаг 2
Страница карты не открывается Закрыт порт 8100, либо он занят другой программой — поменяйте port в webserver.conf
Карта открывается, но чёрная Отрисовка ещё не закончена (bluemap покажет ход) либо мир пока не исследован
Сервер «лагает» во время отрисовки Уменьшите render-thread-count до 1 или приостанавливайте отрисовку командой bluemap stop на время наплыва игроков
Кончается место на диске Карта занимает много. Поставьте enable-hires: false у второстепенных миров и выполните bluemap purge для них
После обновления сервера блоки на карте без текстур Вышла новая версия игры: обновите BlueMap и выполните bluemap reload

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: