На странице 12 разделов
Коротко
BlueMap читает сохранённый Java-мир, превращает его в трёхмерную карту и показывает её в браузере. Для первого результата не нужен отдельный сайт: встроенный веб-сервер отдаёт карту через дополнительный порт. Начните с уже исследованной местности и проверьте локальный адрес карты до настройки домена.
Minecraft: Java Edition 1.21.1, сервер Paper. Версия: BlueMap 5.9, файл bluemap-5.9-paper.jar.
Схема BlueMap: сохранённые данные мира проходят рендер и становятся HTTP-картой, доступной браузеру через отдельный TCP-порт.
- Проверьте, что сервер действительно работает на Paper 1.21.1 с Java 21. Скачайте bluemap-5.9-paper.jar из авторского релиза 5.9.
- Положите JAR в plugins и полностью перезапустите сервер. Дождитесь генерации конфигурации в plugins/BlueMap.
- Если ваша платформа другая, вернитесь к таблице Targets релиза. Например, fabric-файл 5.9 рассчитан на 1.21.6–1.21.8: поддержка Paper 1.21.1 не означает поддержку Fabric 1.21.1 тем же релизом.
В plugins/BlueMap/core.conf прочитайте пояснение accept-download и поставьте true, если согласны с загрузкой ресурсов клиента Mojang для рендера. Без этих ресурсов карта не соберётся. В webserver.conf выберите свободный дополнительный порт; стандартный пример — 8100.
Это порт HTTP-карты, а не игровой порт Minecraft. На хостинге нужен выделенный дополнительный TCP-порт. После сохранения выполните /bluemap reload или перезапуск и проверьте консоль на ошибки загрузки ресурсов и запуска веб-сервера.
core.conf
accept-download: truewebserver.conf, пример свободного порта
port: 8100- Введите /bluemap: команда показывает состояние рендера. На новом сервере первая обработка всего существующего мира занимает больше ресурсов, чем дальнейшие обновления.
- На самом серверном компьютере откройте http://127.0.0.1:8100/. Для другого компьютера используйте адрес сервера. Если порт изменили, подставьте новый.
- Разрешите выбранный TCP-порт в брандмауэре и панели хостинга. Для домашнего сервера настройте его проброс на роутере.
- Если карта открылась, выберите нужный мир и проверьте знакомую постройку. Пустая дальняя область может просто никогда не генерироваться в Minecraft.
Измените небольшой участок в известном месте и дождитесь сохранения мира сервером. BlueMap читает данные с диска, поэтому изменение не обязано появляться в браузере в тот же тик. В меню веб-карты используйте Update Map, чтобы обновить полученные браузером плитки.
Обычно команды ручного рендера не нужны: изменения отслеживаются автоматически. Для диагностики посмотрите /bluemap maps, затем статус и очередь /bluemap tasks. Сначала исключите паузу и неверную карту; постоянный полный purge превращает каждую проверку в дорогой новый рендер.
Если рендер отнимает слишком много CPU, уменьшите render-thread-count в core.conf, затем перезагрузите настройки. Оценивайте одновременно нагрузку хоста и отзывчивость игры. Команда /bluemap stop приостанавливает рендер, /bluemap start возобновляет; эта пауза сохраняется между перезапусками.
Ресурспаки для карты кладутся в plugins/BlueMap/packs. Они должны соответствовать версии мира. После смены набора ресурсов нужен повторный рендер: заранее запланируйте /bluemap purge с точным ID карты. Команда удаляет готовые данные этой карты и запускает построение заново.
Встроенный сервер BlueMap обслуживает HTTP. Для HTTPS используйте внешний веб-сервер, например NGINX, как обратный прокси. Сначала добейтесь работы адреса с портом, затем настройте прокси и сертификат: иначе непонятно, какой из трёх компонентов не работает.
Папка webroot содержит доступные браузеру файлы карты. Не направляйте веб-сервер на весь каталог Minecraft-сервера. Если нужен закрытый доступ, авторы рекомендуют настраивать аутентификацию на внешнем веб-сервере: собственной системы входа у BlueMap нет.
| Проблема | Что проверить |
|---|---|
| Браузер не подключается | Проверьте сообщение о запуске веб-сервера, правильный порт, HTTP вместо HTTPS и открытый TCP-порт. Сравните localhost на хосте и внешний адрес: это разные участки сети. |
| Карта отвечает 404 | Проверьте accept-download и ошибки загрузки ресурсов, затем совпадение webroot в webapp.conf и webserver.conf. |
| Карта чёрная или с пропусками | Проверьте ID мира, путь world, dimension, статус рендера и наличие сгенерированных чанков. У импортированных миров могут отсутствовать данные света: используйте отдельную авторскую инструкцию FixLighting. |
| Постройка ещё старая | Дождитесь сохранения мира, проверьте паузу или freeze карты и нажмите Update Map в браузере. Не начинайте с удаления готового рендера. |
| После установки ресурспака текстуры перепутаны | Проверьте соответствие версии пакета и порядок его загрузки. После изменения ресурсов выполните запланированный purge нужной карты, чтобы старые плитки не смешивались с новыми. |
| Нужно ли регулярно выполнять purge? | Нет. Обычные изменения мира обновляются автоматически. Purge нужен при конкретных изменениях ресурсов или настроек, требующих полной пересборки карты. |
Minecraft: Java Edition 1.21.1, сервер Paper. Версия: BlueMap 5.9, файл bluemap-5.9-paper.jar. Установка: Плагин Paper; релизный диапазон этого файла — Paper/Folia 1.20.6–1.21.8. Java: Java 21 по таблице Targets конкретного релиза 5.9. BlueMap не читает миры Bedrock. Файлы paper, spigot, fabric, forge, neoforge и cli не взаимозаменяемы. Общая актуальная инструкция уже может требовать более новую Java; для 5.9 проверена именно таблица релиза. Рендерится существующий мир; BlueMap сам не исследует бесконечные новые территории.
- BlueMap 5.9: таблица Targets и Java 21
- BlueMap: Installation
- BlueMap: Commands and Permissions
- BlueMap: FAQ
- BlueMap: Core-Config
- BlueMap: Installing Resourcepacks or Datapacks
Справка сверена 31 октября 2026 года. Перед установкой выбирайте файл для своей версии игры и загрузчика.
Игрокам нужен клиентский мод?
Для просмотра карты в браузере нет. В этом сценарии плагин работает на Paper-сервере.
Почему карта не бесконечная?
BlueMap рендерит уже сгенерированные и сохранённые чанки. Неизведанную область сначала создаёт Minecraft или отдельно настроенный генератор чанков.
Можно ли поставить порт 25565?
Уже занятый игровой адрес и порт нельзя считать свободным веб-портом. Для простой установки выделите карте отдельный TCP-порт.
Сверено по официальной документации авторов. Совместимость указана для примера на странице.