Создание интерактивных веб-карт для вашего сервера Minecraft

Хотите, чтобы мир вашего сервера Minecraft был виден друзьям без необходимости входа? Pl3xMap преобразует территорию вашего сервера в интерактивную веб-карту. Никаких клиентских модов не требуется. Просто легковесный плагин, который превращает ваш мир в браузерную карту с рендерингом по стандартам Minecraft.

Что делает Pl3xMap

В основе Pl3xMap - плагин Bukkit/Spigot, периодически сканирующий мир сервера и генерирующий интерактивную HTML-карту. Подумайте про Google Maps, но для Minecraft. Игроки могут увеличивать масштаб, перемещаться по карте и видеть вашу территорию точно так, как она отображается в игре, рендеренная в стандартных цветах и текстурах Minecraft. Карта автоматически обновляется, когда вы строите или исследуете, поэтому ваша веб-карта всегда актуальна.

Настройка удивительно проста. Плагин создает директорию с файлами HTML, CSS и JavaScript, которые можно размещать на любом веб-сервере. Нет необходимости в базе данных, нет сложной настройки. Результатом является просто набор статических файлов, которые можно загрузить на любой хостинг.

С точки зрения производительности, это легковесное решение. Проект имеет 149 звезд на GitHub и написан на Java, поэтому он идеально интегрируется со стандартными серверами Spigot.

Почему использовать это

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

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

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

И честно говоря, это выглядит профессионально. Когда кто-то спрашивает «какой ваш сервер?», вы можете отправить ссылку вместо того, чтобы пытаться объяснить или ожидать, пока они запустят Minecraft.

Установка

Эта часть прямолинейна, что освежает.

Скачайте последний релиз с страницы релизов GitHub и положите JAR-файл в папку плагинов вашего сервера. Перезапустите сервер. Готово. Pl3xMap автоматически создаст файл конфигурации.

cd /path/to/your/server
cp Pl3xMap-vX.X.X.jar plugins/
java -jar server.jar nogui

Плагин генерирует вывод в папке webmap по умолчанию. Эта папка содержит все необходимое для размещения на веб-сервере.

Если вы размещаете его локально для тестирования, можно просто открыть HTML-файлы напрямую в браузере. Для продакшена скопируйте папку webmap на ваш веб-хостинг и направьте домен на нее.

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

Важные функции

Pl3xMap сохраняет простоту, что и является целью. Вот, что вы получаете.

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

Несколько вариантов рендеринга позволяют переключать разные виды. День/ночь, разные стили карты, позиции игроков (если включено). Кто-то вроде testuser, исследующий карту ночью, может переключиться на дневной вид, чтобы лучше видеть цвета.

Границы мира и метки настраиваемы. Отметьте конкретные места с помощью пользовательских иконок и меток. Ваша точка появления, магазины, подземелья, знаковые места - все, что важно для вашей сообщества.

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

Производительность быстрая. Обновления происходят в фоновом режиме без задержек. Сама карта загружается быстро даже для огромных миров, поскольку автоматически тилирует изображение.

Общие ошибки и исправления

Новые пользователи обычно спотыкаются о хостинг.

Если вы сгенерировали папку webmap локально, но забыли фактически размещать HTML-файлы где-то, ничего не появится в браузере. Файлы должны быть на веб-сервере, а не только на вашем рабочем столе. Используйте хостинг-сервис, свой сервер или даже бесплатные варианты, такие как GitHub Pages, если вы готовы закоммитить папку.

Частота обновлений также может удивить. По умолчанию Pl3xMap обновляется периодически на основе своих настроек. Если вы ожидаете реальные обновления, и ничего не изменилось за 30 минут, проверьте конфиг. Вы можете сделать обновления более частыми, но это слегка увеличит нагрузку на CPU. Есть компромисс.

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

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

Другие инструменты для карт в этой области

Pl3xMap не единственный вариант, хотя он солиден для минимального подхода.

Dynmap - это главный конкурент. Он более насыщен функциями, поддерживает больше программного обеспечения сервера и рендерит более агрессивно в реальном времени. Минус: более тяжелая нагрузка на серверные ресурсы и более сложная настройка. Если вы хотите максимальную настройку и не беспокоитесь о нагрузке, Dynmap делает больше. Если вы хотите что-то, что просто работает и не нагружает сервер, Pl3xMap выигрывает.

Bluemap - другая легковесная опция с другой эстетикой - он рендерит в 3D изометрический вид, который некоторые игроки предпочитают. Он также ориентирован на производительность, как и Pl3xMap, но использует другой подход к визуализации.

Создатели, подобные joakim2tusen, которые заботятся о визуальной стороне карты, могут предпочесть рендеринг в стиле vanilla, предлагаемый Pl3xMap, над 3D изометрическими видами. Все зависит от того, хотите ли вы, чтобы ваша карта соответствовала тому, что игроки видят в игре.

Настоящий вопрос: стоит ли это того?

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

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

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

Кто-то, строящий что-то вроде housecz_zero, вкладывает серьезную работу в формирование рельефа или архитектуру. Общая карта позволяет им показать это всей общине.

Значит: легковесное, малообслуживаемое, фактически полезное для мультиплеерных серверов. Стоит 5 минут, необходимых для установки.