Введение: карта мира в браузере

Dynmap и BlueMap — это плагины, которые создают интерактивную веб-карту вашего мира Minecraft. Игроки могут смотреть карту в браузере: видеть свои постройки, местоположение других игроков в реальном времени, чат сервера. Для администратора это инструмент мониторинга: вы видите, где кто находится, какие территории освоены, где происходят конфликты. В этом гайде я разберу оба плагина, их отличия и настройку.

Dynmap vs BlueMap: что выбрать?

Вывод: Dynmap — для классической 2D-карты с кучей функций. BlueMap — для красивой 3D-карты и лучшей производительности.

Установка Dynmap

1. Скачайте Dynmap с официальной страницы на SpigotMC (бесплатный).
2. Поместите JAR-файл в папку plugins.
3. Перезапустите сервер. Dynmap начнёт полный рендер мира (может занять часы/дни для большого мира).
4. Откройте браузер и перейдите по адресу http://IP_сервера:8123.

Настройка Dynmap

Конфигурационный файл: plugins/dynmap/config.yml. Ключевые параметры:

webserver:
  port: 8123
  bindaddress: 0.0.0.0

worlds:
  - name: world
    title: "Основной мир"
    center:
      x: 0
      z: 0
    extrazoomout: 3

render:
  fullrender:
    period: 0  # 0 = только по команде
  updaterender:
    period: 60  # Обновление изменённых чанков каждые 60 сек

Установка BlueMap

1. Скачайте BlueMap с официального сайта bluemap.bluecolored.de (бесплатный).
2. Поместите JAR-файл в папку plugins.
3. Перезапустите сервер. BlueMap создаст папку plugins/BlueMap.
4. Откройте браузер и перейдите по адресу http://IP_сервера:8100.

Настройка BlueMap

Конфигурация в файлах внутри plugins/BlueMap/:

webserver:
  ip: 0.0.0.0
  port: 8100

maps:
  - world: world
    name: "Основной мир"
    render-distance: 2000
    sky-color: "#87CEEB"

Маркеры и регионы на карте

Dynmap: автоматически отображает регионы WorldGuard (нужен плагин Dynmap-WorldGuard). Маркеры игроков, спавна, варпов настраиваются в markers.yml.

BlueMap: маркеры добавляются через API или плагин BlueMapMarkers. Регионы WorldGuard нужно добавлять вручную через конфиг или плагин-мост.

Защита карты от DDoS и нежелательных гостей

1. Закройте порт 8123 (Dynmap) или 8100 (BlueMap) брандмауэром от внешнего мира.
2. Настройте обратный прокси (Nginx) перед картой. Это даёт:
   • HTTPS (шифрование).
   • Защиту от DDoS (rate limiting).
   • Белый список IP (только игроки сервера).

Пример конфигурации Nginx для Dynmap:

server {
    listen 443 ssl;
    server_name map.ваш-сервер.ru;

    location / {
        proxy_pass http://127.0.0.1:8123;
        limit_req zone=minecraft burst=10 nodelay;
    }
}

limit_req_zone $binary_remote_addr zone=minecraft:10m rate=5r/s;

Типичные ошибки

• Карта не отображается в браузере. Проверьте, что порт 8123/8100 открыт в брандмауэре. Проверьте, что сервер запущен и слушает этот порт (netstat -ano | findstr :8123).
• Рендер занимает вечность. Уменьшите радиус рендера. Используйте /dynmap fullrender world:surface для рендера только поверхности (без пещер).
• Карта занимает много места на диске. Тайлы карты могут занимать гигабайты. Ограничьте радиус рендера в конфиге.

💡 Совет профи

Разместите карту на отдельном поддомене (map.ваш-сервер.ru) и защитите её паролем через Nginx basic auth. Игроки получают пароль в личном кабинете на сайте или в Discord. Это предотвращает использование карты посторонними и снижает нагрузку от ботов. Пароль можно автоматически генерировать и отправлять игроку при регистрации на сервере.