Плагін Minecraft BlueMap

🔌 Про BlueMap

BlueMap — це інструмент мапінгу Minecraft, який читає файли світу сервера та генерує 3D-моделі й інтерактивний вебпереглядач. Його можна запускати як серверний плагін або мод (плагін Spigot/Paper чи Sponge, мод Fabric/Forge) або як окремий CLI-рендерер. Якщо BlueMap встановлено на запущеному сервері, він рендерить асинхронно, тож не блокує основний потік сервера.

🎯 Призначення

BlueMap надає доступне з браузера тривимірне представлення світу Minecraft, щоб адміністратори та гравці могли досліджувати місцевість, знаходити структури й оглядати будівлі без входу на сервер. Він орієнтований на операторів серверів, яким потрібна актуальна візуальна мапа для адміністрування, навігації або показу спільноті.

⚙️ Можливості

• Генерує 3D-моделі поверхні світу та показує їх у вебпереглядачі в браузері.
• Працює як плагін/мод (Spigot/Paper, Sponge, Fabric, Forge) або як окремий CLI-інструмент.
• Асинхронне рендерення, щоб не блокувати основний потік Minecraft server.
• Підтримує resource pack і data pack для налаштування текстур, моделей блоків і кольорів біомів, які використовуються під час рендеру.
• Підтримує кілька backend-сховищ і керування мапами через команди (load, unload, list, delete тощо).
• Підтримка маркерів і API для сторонніх плагінів, щоб додавати маркери на мапи або керувати ними.
• Команди для перезавантаження та керування рендером під час роботи (reload, запуск/зупинка рендеру, оновлення/очищення мап, freeze/unfreeze мап).

🧩 Для кого це

• Сервери Survival і SMP, яким потрібна публічна або адміністративна 3D-мапа.
• Сервери Creative або showcase, яким потрібні попередні перегляди будівель у браузері.
• Адміністратори серверів, яким потрібні інструменти для віддаленого огляду та навігації по мапі.

🏗️ Приклади використання

• Надати гравцям публічно розміщену 3D-мапу світу, щоб полегшити навігацію та показувати будівлі.
• Адміністратор може знайти й переглянути бази або claim-и гравців у вебпереглядачі перед тим, як відвідати їх у грі.
• Плагін використовує API BlueMap, щоб показувати динамічні маркери для подій, магазинів або точок телепорту.

⌨️ Команди

(Усі команди вище задокументовані проєктом; точні permission nodes наведені в документації проєкту й тут не повторюються.)

⚙️ Встановлення

📥 Налаштування

• Завантажте відповідний BlueMap JAR для вашої платформи (JAR плагіна для Spigot/Paper/Sponge, JAR мода для Fabric/Forge або окремий CLI-дистрибутив).
• Помістіть JAR у папку plugins/ сервера (для Spigot/Paper/Sponge) або в папку mods/ (для Fabric/Forge), або використовуйте файли CLI-дистрибутива для окремого рендерингу.
• Запустіть або перезапустіть сервер. Перевірте консоль сервера, щоб переконатися, що BlueMap і вбудований вебсервер успішно запустилися.

📦 Залежності

• Для основного рендерингу мапи обов’язкові зовнішні залежності не потрібні. Доступні необов’язкові інтеграції та доповнення; дивіться документацію проєкту для інформації про сторонні addon-и.

🧠 Технічні примітки

• BlueMap поширюється як серверні плагіни, моди та CLI-інструмент; оберіть артефакт, що відповідає вашому налаштуванню.
• Рендеринг виконується асинхронно, щоб не блокувати основний потік сервера.
• Resource pack і data pack можна покласти в налаштований каталог pack-ів, щоб змінити вигляд мапи.
• Проєкт має публічний репозиторій коду та релізні збірки; конфігурація файлово-орієнтована й може бути перезавантажена під час роботи.

🤝 Коли цей плагін корисний

Якщо вам потрібен доступний із браузера тривимірний вигляд вашого світу Minecraft для навігації, огляду будівель або показу спільноті, BlueMap надає автоматичний рендеринг, керування під час роботи та API для маркерів і інтеграцій без потреби, щоб гравці заходили на сервер.