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, де гравцям важливо ділитись координатами і оглядати будівлі; для міні-ігрових серверів без постійного світу він зайвий.