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

> Как поставить веб-карту на сервер Minecraft: BlueMap или Dynmap, порт карты в webserver.conf, включение рендера и открытие карты из панели EGN.

- Рубрика: Гайды по играм
- Игра: Minecraft
- Опубликовано: 2026-11-13T17:00:00+03:00
- Обновлено: 2026-11-13T17:00:00+03:00
- Адрес: https://blog.egnetwork.ru/minecraft-bluemap-dynmap
- Автор: Команда EGN

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

## Коротко

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

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

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

| Что сравниваем | BlueMap | Dynmap |
|---|---|---|
| Конфиги | `webserver.conf`, `core.conf` | `configuration.txt` в `plugins/dynmap` |
| Порт карты | поле `port` в `webserver.conf` (по умолчанию 8100) | `webserver-port` в `configuration.txt` (по умолчанию 8123) |
| Включение рендера | `accept-download: true` в `core.conf` (по умолчанию `false`) | рендер работает после установки; полный — `/dynmap fullrender <мир>` |
| Подходит для | современных версий Paper | проверяйте поддержку версии Paper в его вики |

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

Дальше разбираем BlueMap: конфиг проще и он, как правило, быстрее получает поддержку новых версий (проверьте на странице плагина). Карта голоса и Bedrock живёт на тех же принципах, см. [голосовой чат](https://blog.egnetwork.ru/minecraft-voice-chat-porty). 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:

```hocon
webserver {
  enabled: true
  port: 30541
}
```

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

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

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

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

![Раздел «Сеть»: строка «Веб-карта» с адресом карты и кнопкой «Открыть карту»](https://blog.egnetwork.ru/media/90)

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

![Раздел «Сеть»: карта без выданного порта и предложение «Выдать порт»](https://blog.egnetwork.ru/media/89)

## 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. Проверьте карту в браузере на изменённом месте.

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

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

| Симптом | Причина | Решение |
|---|---|---|
| Карта пустая, мир не рисуется | В `core.conf` не включён `accept-download` | Установите `accept-download: true` и перезапустите сервер |
| Карта не открывается по адресу | Порт в `webserver.conf` не совпадает с портом из «Сети» | Сверьте порт и перезапустите сервер |
| В «Сети» статус «Нет своего порта» | Порт карты не выдан | Нажмите «Выдать порт» или докупите порт |
| Карта открывается, но старая | Рендер ещё не обновился после изменения мира | Подождите фонового обновления или запустите рендер командой плагина |
| Карта требует много памяти | Большой мир и частый рендер | Уменьшите объём рендера по документации плагина и не запускайте полный рендер в пиковый онлайн |

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

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

Если порт карты совпал с портом другого сервиса, плагин не запустится и в консоли появится ошибка о занятом порте. Такой случай разобран в статье [про «Address already in use»](https://blog.egnetwork.ru/minecraft-address-already-in-use-port): смотрите её, если сервер не стартует.

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

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

> [!TIP] Рендер по расписанию
> Полный рендер большого мира нагружает процессор (о снижении нагрузки читайте в [чек-листе оптимизации](https://blog.egnetwork.ru/minecraft-chek-list-optimizacii)). Запускайте его в спокойное время, а не в пиковый онлайн.

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

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

> [!NOTE] Что проверить перед объявлением карты
> Порт выдан, статус в «Сети» «Работает» (подробнее о портах — в статье [про раздел «Сеть»](https://blog.egnetwork.ru/minecraft-dopolnitelnye-porty-set)), карта открывается в браузере и показывает ваш мир, а не пустой квадрат. Только после этого публикуйте ссылку на карту.

## Итог

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

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

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

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

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

### Сколько памяти нужно для карты?
Зависит от размера мира и радиуса рендера. Начинайте с небольшого радиуса и смотрите нагрузку в разделе «Доктор сервера».

Сервер под Minecraft за пару минут — [egnetwork.ru](https://egnetwork.ru/)

---

Материал EGN (blog.egnetwork.ru), обновлено 13 ноября 2026; при цитировании указывайте ссылку.