Гайд з BlueMap: 3D-вебкарта для вашого сервера Minecraft

Що таке BlueMap

BlueMap читає файли вашого світу, рендерить їх у 3D-тайли карти й віддає через невеликий вбудований вебсервер. Зблизька ви бачите блоки в повному 3D, здалеку — плоский огляд. Живі маркери показують, де перебувають гравці, а карта оновлюється в міру змін у світі.

Він рендерить лише світи Java Edition. Поточний випуск, BlueMap 5.29, має версії для:

Для старішої версії Minecraft завантажте старіший випуск BlueMap, у якому вона вказана. Кожен випуск на Modrinth і Hangar показує підтримувані версії.

Встановлення BlueMap

1. Завантажте файл для вашого сервера з Modrinth, Hangar або з релізів BlueMap на GitHub: jar -paper для Paper, -fabric для Fabric і так далі.
2. Покладіть його в папку plugins (Paper, Spigot) або mods (Fabric, Forge, NeoForge) і перезапустіть сервер. Завантаження плагінів описано в гайді як встановити плагіни Minecraft.
3. BlueMap створює конфігурацію в plugins/BlueMap/ або в config/bluemap/ на модових серверах, причому для кожного вашого світу карту вже налаштовано.

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

Прийміть завантаження в core.conf

Щоб малювати блоки, BlueMap потрібні текстури й моделі з клієнта Minecraft, які він завантажує з Mojang. Відкрийте core.conf і змініть:

accept-download: true

Встановлюючи цей параметр, ви приймаєте EULA Mojang і підтверджуєте, що володієте Minecraft Java Edition. Збережіть файл і виконайте /bluemap reload або перезапустіть сервер. BlueMap завантажить ресурси й почне рендер.

Окремий порт для вебкарти

Вебсервер BlueMap за замовчуванням слухає порт 8100. На власному комп'ютері відкрийте цей порт і зайдіть на http://your-ip:8100. На хостингу зазвичай не можна вибрати порт довільно, тому використовується порт, виділений вашому серверу:

1. Отримайте другий порт для сервера. У HytHost відкрийте в панелі вкладку Network і додайте виділення: панель підбере вільний порт і відкриє його за вас.
2. Відкрийте webserver.conf і вкажіть цей номер у port:

   port: 25570

3. Виконайте /bluemap reload і відкрийте в браузері http://your-server-ip:25570.

Не використовуйте ігровий порт — його займає Minecraft. Щоб показувати карту на власному домені без номера порту, поставте перед нею зворотний проксі, наприклад nginx; у документації BlueMap є готові приклади.

Команди BlueMap

Кожна команда має право виду bluemap.<command>, наприклад bluemap.reload. Здебільшого жодна з них не потрібна: BlueMap сам помічає зміни у світі й рендерить їх.

Як полегшити рендер

BlueMap рендерить у фонових потоках, а не в головному потоці сервера, але рендер однаково навантажує CPU. Найважчий — перший рендер великого світу; після нього перемальовуються лише змінені чанки.

• Потоки рендеру: задайте render-thread-count у core.conf. Документація BlueMap радить 1 на машинах із чотирма ядрами або менше.
• Рендерте, коли тихо: виконуйте /bluemap stop у години пік і /bluemap start уночі, поки триває перший рендер.
• Пауза, коли гравці онлайн: player-render-limit у plugin.conf зупиняє рендер, щойно онлайн набирається вказана кількість гравців.
• Встановіть межу світу. Вона не дає карті, а разом із нею й роботі рендеру, безкінечно зростати, поки гравці досліджують світ.
• Заморозьте карти, яким не потрібно оновлюватися наживо, наприклад Енд після того, як його досліджено.

Сховище: файли або база даних

За замовчуванням BlueMap зберігає карту у вигляді стиснених файлів у bluemap/web/maps, на диску вашого сервера. Карта зростає разом із дослідженою територією, тож на великому світі стежте за місцем на диску.

Карту можна перенести в базу даних. У storages/sql.conf налаштуйте підключення до MySQL, MariaDB, PostgreSQL або SQLite, потім вкажіть storage: "sql" у конфігу карти й перезавантажте:

connection-url: "jdbc:mysql://DB_HOST:3306/DB_NAME"
connection-properties: {
    user: "DB_USER",
    password: "DB_PASSWORD"
}

У Paper уже є драйвер MySQL; для Spigot, Fabric і Forge потрібно додати драйвер JDBC. Кожен тариф Minecraft від HytHost містить бази даних MySQL, які створюються на вкладці Databases панелі.