Скачать BlueMap

Описание BlueMap

инструмент для создания интерактивной 3D-карты Minecraft-мира с просмотром в браузере. Он читает файлы мира, строит модель поверхности и публикует результат через веб-приложение: администратор получает не плоскую схему сверху, а объемный обзор, где можно рассматривать ландшафт почти как удаленную камеру. Проект доступен как plugin/mod для серверов Spigot, Paper, Purpur, Folia, Sponge, Fabric, Forge и NeoForge, а также как standalone CLI для рендера без запущенного сервера. На Modrinth BlueMap указан как серверный ресурс: клиентам не нужно ставить мод, достаточно открыть карту в браузере по адресу веб-сервера. Официальная документация требует Java 21 или новее и мир Minecraft Java Edition; Bedrock-миры не поддерживаются. Это важное ограничение, потому что BlueMap работает именно с Java-структурой world-файлов и ресурсами Java Edition. > BlueMap лучше рассматривать как отдельный сервис наблюдения за миром: он живет рядом с сервером, рендерит асинхронно и отдает результат через webroot, а не заменяет игровой клиент. Ресурс особенно полезен публичным серверам, строительным проектам, техническим мирам и приватным SMP, где нужна карта базы, дорог, порталов, городов и биомов. В отличие от обычных in-game миникарт, BlueMap не требует установки у каждого игрока и может работать как постоянная веб-страница с доступом по домену, reverse proxy или стандартному порту.

Что делает ресурс BlueMap выполняет три связанные задачи. Сначала он анализирует мир и ресурсы, затем рендерит карту в собственное хранилище, после этого веб-приложение показывает готовые тайлы и 3D-данные в браузере. При установке на сервер рендер идет асинхронно относительно основного server-thread, поэтому плагин не должен напрямую блокировать тик Minecraft. Но это не значит, что стоимость равна нулю: CPU, диск и база данных все равно получают нагрузку, особенно при первом полном проходе по большому миру. Основные сценарии использования:

• публичная 3D-карта survival-сервера с городами, дорогами и базами;
• внутренняя карта строительного проекта для координации команд;
• offline-рендер старого мира через CLI без поднятия полноценного сервера;
• хранение map-data в файловой системе для простой установки;
• хранение map-data в SQL, если нужна отдельная БД или несколько узлов доступа;
• публикация карты через встроенный webserver или внешний nginx/Apache/reverse proxy. | Область | Где настраивается | Практическое значение | |---|---|---| | Конфиги plugin/mod | plugins/BlueMap/ или config/bluemap/ | Основные параметры запуска и карт | | Webroot | обычно ./bluemap/web/ | Файлы веб-приложения и отдаваемые карты | | Map-data | обычно ./bluemap/web/maps/ | Сгенерированные данные конкретных карт | | SQL storage | storages/sql.conf и map-config | Хранение карт в базе вместо файлов | Типичный базовый запуск выглядит так: ```text

1. Скачать JAR BlueMap под серверную платформу и версию Minecraft.
2. Поместить файл в plugins/ или mods/.
3. Перезапустить сервер, чтобы BlueMap создал пример конфигов.
4. Открыть порт веб-сервера, по умолчанию это 8100.
5. Проверить /bluemap и открыть http://:/. ```

Особенности Сильная сторона BlueMap — объемное представление мира без обязательной клиентской установки. Игроки и зрители открывают карту в браузере, а администратор управляет тем, какие миры и измерения рендерить, где хранить данные, какие маркеры показывать и как публиковать webroot. Официальная конфигурация использует HOCON, а сгенерированные файлы содержат комментарии к полям, поэтому первый запуск полезно делать именно для генерации шаблонов, а не писать конфиги с нуля. Важные особенности:

• встроенный webserver включен как ключевая функция и по умолчанию может слушать 0.0.0.0:8100;
• map-config файлы лежат в папке maps, а имя файла становится идентификатором карты;
• удаление карты из конфигурации не обязательно удаляет уже сгенерированные данные, их нужно чистить отдельно;
• для CLI-режима нужно принять загрузку дополнительных ресурсов Mojang через настройку accept-download=true;
• метрики bStats и собственный минимальный отчет можно отключить в конфиге;
• SQL-хранилище требует переключить каждую карту на storage = "sql" и удалить старые file-данные, чтобы они не мешали. Пример HOCON-фрагмента для карты, где важна читаемость и явное хранилище: hocon storage: "file" enabled: true display-name: "Survival Overworld" world: "world" sorting: 0 BlueMap не является античитом, системой claims или полноценной панелью администрирования. Он показывает мир, но права доступа, приватность баз и скрытие координат нужно проектировать отдельно. Для публичного сервера стоит заранее решить, нужна ли задержка публикации, какие маркеры допустимы, будет ли карта доступна всему интернету или только участникам через прокси и авторизацию.

Совместимость и установка По данным Modrinth ресурс работает на стороне dedicated server и поддерживает широкий диапазон Minecraft Java Edition: от 1.13.x до актуальных 1.21.x и 26.1.x. Загрузчики и платформы включают Fabric, Folia, Forge, NeoForge, Paper, Purpur, Spigot и Sponge. Клиентская установка игрокам не требуется, потому что просмотр выполняется через браузер. Официальная установка в базовом варианте проста: скачать подходящий JAR, положить его в plugins или mods, перезапустить сервер, дождаться генерации конфигов и проверить логи. Документация отдельно указывает, что нужен дополнительный порт помимо Minecraft-порта. После корректной настройки прогресс можно смотреть командой /bluemap, а карту — по HTTP-адресу сервера и порту веб-сервера. Если используется CLI без сервера, рабочий каталог становится местом для конфигов и данных. Первый запуск java -jar BlueMap-cli.jar создает файлы, затем в core.conf нужно прочитать комментарии и включить accept-download, если вы согласны на загрузку необходимых ресурсов от Mojang. Для SQL-сценария сначала ставят BlueMap как обычно, затем настраивают storages/sql.conf, переводят нужные карты на SQL-хранилище и выполняют /bluemap reload. Минимальный operational checklist:

1. Проверить Java 21+ на той же машине или контейнере, где запускается BlueMap.
2. Скачать файл именно под свою платформу: Paper/Spigot, Fabric/Forge/NeoForge/Sponge или CLI.
3. Убедиться, что порт 8100 или выбранный порт открыт у хостера и не занят другим сервисом.
4. После первого запуска читать сгенерированные комментарии в HOCON-конфигах, а не копировать чужие настройки вслепую.
5. Для больших миров оценить место на диске или сразу проектировать SQL-хранилище.
6. При публикации наружу использовать reverse proxy и HTTPS, если карта доступна не только локально.

Вопросы и ответы

Нужно ли ставить BlueMap каждому игроку?

Нет. Это серверный ресурс и веб-приложение. Игроку достаточно открыть ссылку в браузере, если администратор разрешил доступ к карте.

Почему карта не появилась сразу после установки?

Первый рендер большого мира занимает время. Проверьте логи, команду /bluemap, выбранный мир в map-config и доступность webserver-порта.

Можно ли использовать Bedrock-мир?

Нет. Официальная документация указывает поддержку Minecraft Java Edition worlds, Bedrock Edition worlds не поддерживаются.

Что выбрать: file storage или SQL?

File проще и подходит большинству одиночных серверов. SQL полезен при сложной инфраструктуре, больших данных, переносе webroot или нескольких компонентах, которым удобнее работать через базу.

Повлияет ли BlueMap на TPS?

Он рендерит асинхронно и не блокирует server-thread напрямую, но при полной загрузке CPU или медленном диске сервер все равно может почувствовать нагрузку. Ограничивайте рендер и следите за ресурсами.

Можно ли поставить карту за доменом?

Да, но это уже задача веб-инфраструктуры: внешний webserver или reverse proxy должен отдавать webroot и корректно проксировать запросы к BlueMap, желательно с HTTPS и понятными правилами доступа.