POIManager — автоматизация точек интереса для Minecraft Overviewer
Каждый администратор сервера Minecraft, который использует картографический рендерер Overviewer, знает, насколько утомительно вручную прописывать точки интереса в конфигурационных файлах. Плагин POIManager решает эту проблему кардинально — теперь создавать, удалять и редактировать маркеры можно прямо из игры, не прикасаясь к текстовым редакторам. Это не просто утилита, а полноценный мост между живым миром сервера и статичной картой.
Зачем нужен POIManager?
Minecraft Overviewer генерирует потрясающие веб-карты миров, но его стандартный механизм ручных точек (manualpois) требует правки Python-модулей и конфигов при каждом изменении. POIManager берёт на себя всю чёрную работу: ведёт список определений точек в отдельном файле, автоматически вызывает рендеринг после правок и предоставляет игрокам и администраторам интуитивные команды. Больше не нужно перезагружать сервер или лезть в код — всё работает на лету.
Установка и настройка плагина
После загрузки POIManager в папку плагинов сервера необходимо отредактировать появившийся config.yml. Именно здесь задаются пути и команды, уникальные для вашей инсталляции Overviewer. По умолчанию параметры почти гарантированно не подойдут, поэтому отнеситесь к этому этапу внимательно.
Редактирование config.yml
В конфигурационном файле два ключевых параметра:
- poifile — путь к файлу, в котором будет храниться список точек. По умолчанию это
poiMan.pyв корневой директории сервера. Важно: не указывайте здесь основной конфиг Overviewer! Этот файл будет импортироваться как модуль, и POIManager может создать его автоматически, если он отсутствует. - renderCommand — список строк, определяющих команду для обновления карты. Первая строка — исполняемый файл, остальные — аргументы. Рекомендуется использовать опцию
--genPOIвместо полного перерендера тайлов. Можно указать и собственный скрипт (bash, batch), что даёт гибкость в настройке пайплайна.
Кстати, если вы предпочитаете не возиться с ручной правкой конфигов и хотите сразу получить рабочую связку, лаунчер foxygame.net предлагает удобную установку модов прямо из меню — достаточно выбрать POIManager, и все необходимые файлы подтянутся автоматически, а гибкая система профилей позволит переключаться между сборками без головной боли.
Интеграция с конфигурацией Overviewer
Чтобы созданные через плагин точки отобразились на карте, потребуется минимальное вмешательство в основной конфиг Overviewer. Добавьте в него следующие строки:
sys.path.append("директория с вашим poi-файлом")
from poi_filename import manPOIList
Здесь poi_filename — имя выбранного poifile без расширения .py (например, poiMan). Затем в определение рендера нужно включить параметр 'manualpois': manPOIList,. Не забудьте также определить filterFunctions и словари маркеров, как того требует документация Overviewer. Пример простейшей конфигурации можно найти в описании плагина — он наглядно показывает, как фильтры применяются к списку, генерируемому POIManager.
Основные команды плагина
Управление точками реализовано через понятные серверные команды, доступные администраторам и модераторам. Вот полный список возможностей:
- /newpoi — создать новую точку. Можно указать ID, координаты и имя. Вариант
/newpoi <id> here <name>создаёт точку в текущей позиции игрока. - /deletepoi <name> — удалить точку по имени.
- /modifypoi <свойство> <значение> <имя> — изменить ID, координаты или название существующей точки.
- /listpoi — вывести список точек с возможностью фильтрации по любому свойству (id, x, y, z, name).
- /refreshpoi — принудительно запустить обновление карты Overviewer. Остальные команды модификации вызывают его автоматически.
- /telepoi <name> — телепортироваться к указанной точке.
- /navpoi <name> — проложить навигацию к точке с помощью компаса.
Благодаря автоматическому вызову /refreshpoi после каждого изменения, карта всегда остаётся актуальной без лишних действий со стороны администратора.
Пример использования и автоматизация
Представьте: вы построили торговую деревню и хотите отметить её на карте сервера. Вместо того чтобы вычислять координаты, открывать файл конфигурации и вручную прописывать структуру, вы просто встаёте в центре деревни и вводите /newpoi village1 here Торговая_деревня. Через несколько секунд точка появляется на веб-карте. Если деревня расширилась, /modifypoi x 250 village1 скорректирует положение. Всё это работает без перезагрузки и правки кода — именно та простота, ради которой и создавался POIManager.
Заключение
POIManager превращает рутинное администрирование карты в лёгкую прогулку. Интеграция с Minecraft Overviewer становится прозрачной, а управление точками интереса — интуитивным. Будь то публичный сервер с сотнями маркеров или частный проект с десятком ключевых локаций, этот плагин экономит часы времени и исключает ошибки ручного редактирования. Попробуйте его в деле, и вы уже не захотите возвращаться к старым методам.