Веб-карта мира для сервера Minecraft — BlueMap
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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов