BlueMap

Что такое BlueMap

BlueMap - это утилита для Майнкрафт, которая читает файлы вашего мира и генерирует не просто плоскую карту, а полноценные 3D-модели всей поверхности. Через веб-приложение вы можете просматривать результат в браузере - примерно так же, как если бы вы находились непосредственно в игре. Либо можно отдалить камеру и оценить владения с высоты птичьего полета.

По факту, это один из самых удобных способов показать игрокам карту сервера. Вместо того чтобы объяснять новичкам, куда идти, вы просто кидаете им ссылку на веб-карту, и они сами видят весь мир, постройки, биомы и территорию. Для RPG-серверов, экономических проектов и просто больших SMP-серверов - вещь практически must-have.

Варианты установки

BlueMap доступен в нескольких форматах:

• Плагин для Spigot/Paper или Sponge
• Мод для Fabric или Forge
• CLI-утилита - можно использовать вообще без сервера, прямо из командной строки как отдельный инструмент

Это значит, что BlueMap можно поставить практически на любую сборку. Независимо от того, сидите ли вы на ванильном сервере с плагинами или используете модовый сервер - инструмент подстроится. Если вы арендуете сервер Minecraft на BungeeHost, плагин установится в один клик через панель управления.

Как работает рендеринг

Если установить BlueMap как плагин или мод, он рендерит карту асинхронно - то есть в отдельном потоке, не блокируя основной поток сервера. На практике это значит, что пока генерируется 3D-карта, ваш сервер Майнкрафт продолжает работать в обычном режиме. Тики не проседают, игроки не замечают лагов.

Правда, есть нюанс - если ваш процессор уже загружен на 100%, дополнительный поток рендеринга всё-таки добавит нагрузки. На слабом железе лучше запускать обновление карты вручную или по расписанию в часы минимального онлайна.

Веб-сервер и метрики

Веб-сервер - это ключевая функциональность BlueMap. По умолчанию он включен и слушает все сетевые интерфейсы на порту 8100, отдавая содержимое папки ./bluemap/web/. Вы можете изменить порт или отключить веб-сервер в конфиге плагина.

BlueMap также собирает метрики через bStats и собственную систему статистики. Собственные метрики отправляют небольшой отчет с названием реализации и версией плагина - это нужно, потому что bStats поддерживает не все варианты (Fabric, Forge, CLI не учитываются). Выглядит это примерно так:

{

    "implementation": "sponge",
    "version": "5.23",
    "mcVersion": "26.2"
}

Все метрики можно отключить в конфигурации.

Практические советы

• Для больших миров первый рендер может занять considerable времени. Запускайте его ночью или когда на сервере нет игроков
• Веб-карту можно встроить на сайт вашего сервера через iframe или дать прямую ссылку вида http://ваш-ип:8100
• Если используете reverse proxy (nginx, Cloudflare), настройте проксирование на порт 8100, чтобы карта была доступна по обычному домену без указания порта
• BlueMap совместим с большинством плагинов на защиту регионов (WorldGuard, GriefPrevention) - на карте видно границы приватов, если включить соответствующий аддон

Планы разработки

Автор развивает BlueMap в свободное время, поэтому точных сроков по новым фичам нет. Список задач может меняться в зависимости от приоритетов и обратной связи от сообщества.

Скачайте BlueMap, если вам нужна качественная 3D-карта сервера Minecraft, которая не грузит основной поток и работает из коробки.