BlueMapPortalMarkers: автоматические маркеры порталов для BlueMap
Каждый администратор сервера Minecraft, использующий BlueMap, знает, как утомительно вручную расставлять маркеры для порталов. Дополнение BlueMapPortalMarkers решает эту проблему раз и навсегда. Оно самостоятельно находит все порталы в мире, отслеживает их состояние и выводит аккуратные иконки прямо на веб-карту. Больше никаких таблиц с координатами и ручного обновления — всё работает в реальном времени.
Как работает BlueMapPortalMarkers
Дополнение подключается к API Paper и отслеживает события создания и разрушения порталов. При запуске сервера выполняется первичное сканирование области вокруг спавна и всех игроков, находящихся онлайн. Затем, по мере исследования мира, маркеры добавляются автоматически. Если портал сломан, его иконка исчезает с карты без вашего вмешательства. BlueMapPortalMarkers также умеет предсказывать связку порталов по стандартному правилу 8:1 и показывает кнопку «Перейти к связанному порталу» во всплывающем окне.
Ключевые возможности
- Живой слой «Nether Portals» — игроки могут включать и отключать его в меню BlueMap.
- Мгновенное обнаружение — новые порталы появляются сразу после зажигания, старые подхватываются при загрузке чанков.
- Автоматическая чистка — сломанные рамки удаляют маркер без лишних команд.
- Связывание миров — во всплывающем окне отображается расчётная точка в противоположном измерении и кнопка быстрого перехода.
- Отсутствие дубликатов — один портал всегда даёт ровно один маркер, независимо от размера рамки.
- Сохранение состояния — все обнаруженные порталы записываются на диск и восстанавливаются после перезагрузки.
- Гибкая настройка — фильтрация по мирам, кастомные иконки, радиус сканирования и фоновая проверка.
Требования и совместимость
BlueMapPortalMarkers работает исключительно на серверах Paper 26.1.2 и новее (Spigot и более старые версии Paper не поддерживают нужное API). Также требуется Java 25+ и установленный плагин BlueMap. Дополнение тестировалось на актуальных сборках Minecraft и остаётся лёгким даже на оживлённых серверах — вся логика опирается на данные, которые игра уже хранит в памяти.
Как установить BlueMapPortalMarkers
Процесс установки прост, но если вы пользуетесь лаунчером foxygame.net, задача сводится к одному клику: в каталоге дополнений лаунчера достаточно найти BlueMapPortalMarkers и добавить его в сборку, после чего лаунчер сам проверит совместимость версий и разместит файл в нужной папке. Для ручной установки скачайте BlueMapPortalMarkers-<version>.jar и поместите его в папку plugins/ вашего сервера рядом с BlueMap. После рестарта сервера автоматически создастся конфигурационный файл. Откройте веб-карту BlueMap и активируйте слой «Nether Portals» в меню маркеров — всё готово.
Быстрый старт
- Скачайте BlueMapPortalMarkers для Minecraft с официального репозитория или через лаунчер foxygame.net.
- Переместите JAR-файл в директорию
plugins/. - Перезапустите сервер.
- Включите слой порталов в интерфейсе BlueMap.
Конфигурация и тонкая настройка
Все параметры хранятся в plugins/BlueMapPortalMarkers/config.yml. Вы можете изменить подпись слоя и иконку через markers.label и markers.icon, задать радиус стартового сканирования в discovery.sweep-radius, а также ограничить работу плагина конкретными мирами с помощью белого или чёрного списка в discovery.worlds. Опция linking.enabled управляет отображением предсказанной связи между порталами, а discovery.background-sweep включает периодическое фоновое обновление для ещё более точного покрытия. Большинство настроек применяются на лету командой /bmportals reload.
Команды для администраторов
Все подкоманды /bmportals требуют права bmportals.admin (по умолчанию доступно операторам).
/bmportals reload— перечитать конфиг и применить изменения без перезагрузки сервера./bmportals sweep [радиус]— принудительно просканировать область вокруг спавна и всех игроков онлайн./bmportals sweep me | <игрок> | <x> <z>— точечное сканирование конкретной локации./bmportals stats— показать общее количество порталов и статистику по каждому миру./bmportals purge [мир]— удалить сохранённые маркеры, например, после массовых правок через WorldEdit.
Практические советы и ограничения
Порталы в чанках, которые никогда не загружались после обновления до Paper 26.1.2, не будут обнаружены до тех пор, пока игроки не посетят эти области. Стартовое сканирование охватывает только радиус вокруг спавна и текущих позиций игроков, а не весь мир. Однако кочующее покрытие и фоновое сканирование постепенно заполнят пробелы. Для мгновенного результата используйте /bmportals sweep с большим радиусом.
BlueMapPortalMarkers не собирает персональные данные — только анонимную агрегированную статистику через bStats, которую можно отключить в конфиге. Проект распространяется под лицензией GNU GPL v3.0, исходный код открыт.
Если вы ищете способ сделать навигацию по серверу интуитивно понятной, BlueMapPortalMarkers — незаменимый инструмент. Он избавляет от рутины и дарит игрокам удобный обзор всех порталов прямо в браузере. А благодаря интеграции с foxygame.net установка дополнения становится делом пары секунд, позволяя сосредоточиться на развитии сервера, а не на технических мелочах.