Настройка плагина Dynmap Для вашего Bukkit Сервера Minecraft

  • Post published:August 19, 2021
  • Post last modified:January 2, 2025
  • Post category:Minecraft / Гайды
  • Reading time:22 mins read

В этой статье я опишу работу с плагином Dynmap и помогу самостоятельно настроить его для вашего Minecraft сервера. С этим плагином можно быстро и легко создать 3D карту вашего сервера, просматривать ее в браузере и выставить ее на всеобщее обозрение.

Для работы с этим плагином вам прежде всего понадобится установить сам сервер Bukkit. Подойдет и любой другой сервер – Spigot или Paper. Статья по установке серверов на Java (ПК) и для мобильных устройств (Bedrock Edition) есть у меня на сайте.

Установка

Установка данного плагина проста до безобразия. Достаточно зайти на страницу разработчика плагина и скачать оттуда один файл в формате .jar для сервера.

После этого просто закинуть данный файл в папку вашего сервера в директорию /plugins и запустить ваш сервер.

Консоль сервера с плагином Dynmap

После успешной инициализации плагина Dynmap можно приступать к следующему этапу – Настройке.

Настройка Dynmap

По умолчанию плагин автоматически с запуском сервера инициализирует веб-сервер, на который уже можно зайти через любой браузер. Открыть эту карту можно по этому адресу – http://localhost:8123

Как правило, этот адрес с вашей карты сервера привязан к вашему IP-адресу (локальному или онлайн) и порту. Например: localhost:8123 или 192.168.0.100:8123 (ваш адрес карты в локальной сети), а чтобы можно было зайти на вашу карту через интернет из любой точки земли, то для этого необходимо узнать динамический или статический IPv4 адрес (в зависимости от провайдера) при помощи сторонних сайтов типа myIp.com, whatismyipaddress.com или в личном кабинете роутера (WAN IP).

Так выглядит страница карты Dynmap

💡Чтобы страница карты успешно открывалась, вам возможно также понадобится открыть порт TCP 8123 (по умол.) в настройках роутера.

С адресом карты разобрались. Не пугайтесь если вы открыли адрес карты вашего сервера и вместо вашего мира вы видите просто черное окно. Для отрисовки нам понадобятся некоторые команды, которые перечислены ниже. Использовать их можно как в командной строке, так и в самой игре (с правами администратора)

dynmap fullrender <имя мира> - Полностью отрисовывает карту мира и сохраняет ее на диск.
dynmap radiusrender <имя мира> <X><Z><число чанков> - Отрисовывает карту в радиусе чанков по координатам X, Z. Координаты можно узнать прямо на странице карты в окне location.
dynmap cancelrender - отменить текущую отрисовку карты 
dynmap reload - перезагрузка плагина
dynmap hide <никнейм игрока> - скрыть отображение игрока на карте
dmarker add <имя> icon: <ID иконки> - добавить маркер на карту в местоположении игрока
dmarker list - список всех размещенных маркеров на карте
dmarker delete id:<ID маркера> - удалить маркер с карты 

Командой /dynmap fullrender world (стандартное имя карты) вы создаете карту вашего сервера и всех связанных миров (Ад, Ендер мир и прочие). Эта команда так же полностью (по умолчанию) отрисовывает карту в 3D наклонной плоскости и показывает подземные уровни.

Если по какой-то причине вы видите не отрисованный черный куб на вашей карте, можно использовать команду (можно использовать через консоль или внутри игры) /dynmap radiusrender имя_мира X Z число_чанков. При помощи нее, вы указываете координаты в мире и число блоков, которые следует заново отрисовать и обновить изображение мира.

Детальное руководство по настройке Dynmap можно найти на странице разработчика или же на русскоязычной википедии.

FAQ / Решение проблем

Самые распространенные вопросы по этому плагину перечислены ниже:

Как изменить качество прорисовки карты?

Работает ли Dynmap с другими серверами (Spigot, Bukkit, Paper)?

Как отключить рендер 3D (Surface) поверхности карты?

Где изменить порт веб-сервера?

Как переименовать название мира на карте?

Как переместить центрирование веб-карты по умолчанию (от спавна)?

Как зайти на свою карту через браузер?

Как изменить IP адрес веб-сервера?

Как выключить/включить чат на странице карты?

Как можно отключить отображение мира на карте?

Как добавить маркер на интерактивную карту?

Можно ли поменять иконку (favicon) для веб-карты?

Как узнать, сколько осталось времени на рендер всей карты?

Как очистить рендер карты?

Как обновить плагин до новой версии?

В заключении

Данная статья не охватывает всевозможный функционал этого плагина, а лишь рассказывает о его ключевых особенностях. Подробное описание всех настроек рендеринга карты, кастомных текстур паков, маркеров, систему регистрации и интеграций с другими плагинами можно найти в официальном руководстве автора.