BlueMap — плагин для генерации интерактивной 3D-карты мира в браузере для Minecraft

BlueMap — плагин для генерации интерактивной 3D-карты мира в браузере для Minecraft

BlueMap — это плагин для Minecraft, который читает файлы мира и строит из них трехмерную модель поверхности, доступную в браузере через встроенный веб-сервер. Стандартный клиент рендерит мир только вокруг игрока и не дает вида сверху или снаружи. Плагин формирует полную карту с возможностью вращать камеру, переходить в перспективный или изометрический (flat) режим и видеть постройки обычным переходом по URL. Решает одну задачу: внешний просмотр серверного мира без необходимости заходить в игру.

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

Плагин разбивает чанки на тайлы и генерирует два слоя детализации: hires-модели с полноценной геометрией блоков и lowres-карту для дальнего обзора. Hires активен на близком зуме — тогда видны конкретные блоки, текстуры и высоты. На дальнем зуме подгружается упрощенный слой с цветными пятнами биомов и ландшафтом.

Процесс рендеринга в веб-интерфейсе: тайлы постепенно подгружаются при зуме. 

Рендер выполняется асинхронно в отдельном пуле потоков. Серверный тред Minecraft при этом не блокируется — пока у CPU есть свободные ядра, игроки не почувствуют лагов от построения карты. Изменения в мире плагин отслеживает сам: BlueMap периодически проверяет mca-файлы, замечает измененные чанки и перерендеривает только их. Ручные команды типа /bluemap update нужны редко — преимущественно для диагностики.

Рендер в веб-интерфейсе от первого лица 

Команды

Плагин регистрирует один корневой слэш /bluemap с подкомандами. В большинстве случаев не требуется ни одной команды — рендер работает автоматически.

Выполнение команды /bluemap 

Конфигурация

Папка плагина содержит четыре конфигурационных файла: core.conf, plugin.conf, webapp.conf, webserver.conf. А также три подпапки: maps/ (по .conf на каждый мир), packs/ (ресурс-паки для рендера) и storages/ (file.conf для файловой системы, sql.conf для SQL-базы).

core.conf

Главный файл. Ключевой параметр — accept-download, который нужно установить в true для первого запуска. Параметр render-thread-count (по умолчанию 1) задает количество потоков рендера — отрицательное значение означает «количество ядер CPU минус модуль числа». metrics (true) контролирует отправку анонимной статистики.

plugin.conf

Параметры видимости игроков на карте и поведения рендера:

webapp.conf

Настройки веб-приложения. default-to-flat-view (false) определяет стартовый вид — перспективный или изометрический. Ползунки hires-slider-default (100) и lowres-slider-default (2000) задают дистанцию детального и упрощенного рендера в блоках. resolution-default (1) принимает значения 0.5, 1 или 2. Массивы scripts и styles подключают кастомные JS- и CSS-файлы.

webserver.conf

Встроенный веб-сервер. enabled (true) — включить или выключить. port (8100) — порт. webroot ("bluemap/web") — директория с файлами веб-приложения (должна совпадать с webroot в webapp.conf). Секция log настраивает запись HTTP-активности в файл.

Вывод

BlueMap дает возможность внешнего просмотра мира в формате полноценной 3D-модели с вращением камеры и свободным полетом. Плагин подходит серверам выживания и RPG, где игрокам важно делиться координатами и осматривать постройки; для мини-игровых серверов без постоянного мира он лишний.