BlueMap и Dynmap: веб-карта сервера Minecraft

Карта сервера в браузере работает как витрина: игрок может посмотреть, где построить дом, найти чужой город или проверить, как далеко ушёл мир. Два популярных решения — BlueMap и Dynmap. Они рисуют мир и отдают его через встроенный веб-сервер на отдельном порту. Здесь важны две вещи: правильный порт и разрешение на чтение мира.

Коротко

BlueMap рисует мир на сервере Paper и отдаёт карту через свой веб-сервер. Порт карты задаётся полем port в webserver.conf, а рендер включается, когда в core.conf стоит accept-download: true. Порт карты — TCP, он выдаётся в разделе «Сеть» панели EGN, и там же есть кнопка «Открыть карту». Dynmap работает похоже, но у него свои конфиги и своя поддержка версий Paper.

Что выбрать: BlueMap или Dynmap

Оба плагина рисуют карту и отдают её по HTTP. Разница в поддержке, интерфейсе и том, как они обновляются.

Выбирайте тот плагин, который поддерживает вашу версию Paper. Перед установкой проверьте список версий на странице плагина: карта, которая не запускается на нужной версии, бесполезна.

Дальше разбираем BlueMap: конфиг проще и он, как правило, быстрее получает поддержку новых версий (проверьте на странице плагина). Карта голоса и Bedrock живёт на тех же принципах, см. голосовой чат. Dynmap настраивается по тому же принципу: порт в конфиге и порт в «Сети».

Шаги

1. Поставьте плагин. В «Моды и плагины» найдите BlueMap или Dynmap, установите под свою версию Paper и перезапустите сервер.

2. Найдите конфиги. BlueMap создаёт папку plugins/BlueMap с файлами core.conf и webserver.conf.

3. Включите рендер. Откройте core.conf и убедитесь, что в нём есть accept-download: true. Без этого параметра карта не будет скачивать и рисовать мир, и вы увидите пустую страницу.

4. Включите веб-сервер. В webserver.conf включите сервер (параметр enabled) и укажите порт в поле port. Порт должен быть свободным и выданным серверу.

5. Выдайте порт в «Сети». Откройте раздел «Сеть» и найдите строку «Веб-карта». Если порта нет, статус будет «Нет своего порта» — нажмите «Выдать порт».

6. Перезапустите сервер. Карта начнёт рисоваться, когда мир загружен и есть игроки или фоновый рендер.

7. Откройте карту. В «Сети» нажмите «Открыть карту». Откроется адрес карты в браузере. Его же можно дать игрокам.

Пример конфига BlueMap:

webserver {
  enabled: true
  port: 30541
}

Значение port: 30541 — пример из тестового стенда. Порт выдаётся панелью, его и указывайте.

Как сделать в панели EGN

Карта — один из сервисов, которые панель знает. В разделе «Сеть» строка «Веб-карта» показывает адрес, тип TCP и статус. Если порт выдан, появляется кнопка «Открыть карту». Если порт не выдан, статус будет «Нет своего порта», и кнопка «Выдать порт» поможет выдать его с ноды.

Пример: BlueMap установлен, но порт карты не выдан. В «Сети» видно, что плагин слушает порт по умолчанию, который серверу не выдан, и предложена выдача порта. После выдачи и перезапуска карта открывается по адресу из «Сети».

Если тариф исчерпан, панель сообщит о лимите и предложит докупить порт. Обычно карта — последний сервис в очереди: сначала голос и Bedrock, потом карта.

Dynmap: чем он отличается

Dynmap — старый и широко известный плагин веб-карты. Он работает на Spigot и Paper, умеет показывать игроков на карте в реальном времени и поддерживает несколько миров. Настройки лежат в plugins/dynmap/configuration.txt, а порт веб-сервера задаётся там же параметром webserver-port (по умолчанию 8123).

Главное правило то же, что и для BlueMap: порт карты должен быть выдан серверу в разделе «Сеть», а сама карта должна рисовать мир после установки. Перед тем как выбрать Dynmap, проверьте в его вики, какая версия Paper поддерживается сейчас. Если версия вашего сервера новее, чем указано в документации плагина, карта может не запуститься, даже если установка прошла без ошибок. В этом случае честнее выбрать BlueMap или остаться без карты, чем держать её в неработающем состоянии.

Как обновить карту после изменений мира

Карта — это снимок мира, а не живая картинка. Если вы поменяли ландшафт, добавили город или сбросили регион, карта останется старой, пока рендер не пройдёт заново. Порядок такой:

1. Сохраните мир командой сохранения или дождитесь автосохранения.
2. Запустите обновление рендера для нужного мира или региона. У BlueMap это команды /bluemap render и /bluemap update (параметры — в вики BlueMap), у Dynmap — /dynmap fullrender <мир> или /dynmap radiusrender.
3. Проверьте карту в браузере на изменённом месте.

Если рендер нужен каждый день, поставьте его на расписание в спокойное время, а не на каждую минуту. Так вы не будете получать нагрузку на процессор в пиковый онлайн.

Симптомы и решения

Пример: карта и голос на одном сервере

На сервере обычно есть и карта, и голосовой чат, и Bedrock. Каждый сервис получает свой порт. Карта — TCP, голос — UDP, Bedrock — UDP и TCP. Поэтому даже если все три сервиса работают на одном сервере, их порты не пересекаются. Проверяйте список портов в «Сети» после установки каждого плагина, а не предполагайте, что порты «сами разойдутся».

Если порт карты совпал с портом другого сервиса, плагин не запустится и в консоли появится ошибка о занятом порте. Такой случай разобран в статье про «Address already in use»: смотрите её, если сервер не стартует.

Частые ошибки

Карта открывает мир всем

Веб-карта показывает ваш мир тем, у кого есть ссылка. Если на сервере есть приватные зоны или правила конфиденциальности, ограничьте рендер или выключите карту для таких миров.

Рендер по расписанию

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

Ещё несколько ошибок:

• конфиги BlueMap меняли в одном месте, а сервер перезапускали другой копией, и изменения не применились;
• порт карты указан в конфиге, но не выдан в «Сети», поэтому снаружи карта недоступна;
• на сервере с Velocity карта стоит на бэкенде. Ссылка на карту ведёт на адрес и порт бэкенда из «Сети», а не на адрес прокси: игрокам давайте именно её;
• Dynmap и BlueMap вместе: два рендера одного мира дают лишнюю нагрузку и путаницу.

Что проверить перед объявлением карты

Порт выдан, статус в «Сети» «Работает» (подробнее о портах — в статье про раздел «Сеть»), карта открывается в браузере и показывает ваш мир, а не пустой квадрат. Только после этого публикуйте ссылку на карту.

Итог

Веб-карта — полезный сервис: игроки лучше ориентируются, а вы получаете витрину сервера. BlueMap настраивается в двух файлах: core.conf с accept-download: true и webserver.conf с портом. В панели EGN порт карты выдаётся в разделе «Сеть», там же кнопка «Открыть карту». Если порт не выдан или мир не рисуется, начинайте с этих двух проверок.

Вопросы и ответы

Нужна ли карта на маленьком сервере?

Не обязательно. Карта полезна, когда мир большой и игроки часто ищут места. Для нескольких друзей она лишняя.

Можно ли закрыть карту паролем?

У BlueMap встроенной авторизации нет: карта открыта всем, у кого есть адрес. У Dynmap есть собственный механизм входа (login-enabled в configuration.txt, подробности — в вики Dynmap). Ограничивайте доступ и не публикуйте ссылку широко.

Почему карта не обновляется сразу?

Рендер фоновый и идёт порциями. Изменения мира появятся на карте после обновления, а не в ту же секунду.

Сколько памяти нужно для карты?

Зависит от размера мира и радиуса рендера. Начинайте с небольшого радиуса и смотрите нагрузку в разделе «Доктор сервера».

Сервер под Minecraft за пару минут — egnetwork.ru