StatMonsPAPI (plugin for hybrid servers)
Если вы держите гибридный сервер с модом Cobblemon и хотите, чтобы статистика игроков красиво отображалась в чате, на табличках, в скорбордах и меню, то StatMonsPAPI (plugin for hybrid servers) — ровно тот инструмент, который закрывает эту задачу. Плагин собирает данные о ловле, боях, яйцах, покедекс-прогрессе и десятках других показателей, а затем отдаёт их через PlaceholderAPI в удобном виде.
Материал ниже поможет понять, что умеет плагин, какие плейсхолдеры он поддерживает и как установить его на сервер без лишней головной боли.
Что такое StatMonsPAPI и зачем он нужен
StatMonsPAPI (plugin for hybrid servers) — это мост между данными мода Cobblemon и экосистемой плагинов Bukkit/Spigot/Paper. Сам по себе он не рисует интерфейсы, но даёт другим плагинам готовые значения: сколько покемонов поймано, сколько было шайни, сколько побед в PvP, какой прогресс по покедексу. Дальше вы вставляете эти плейсхолдеры куда угодно — в DeluxeMenus, TAB, Scoreboard, чат-формат или голограммы.
Особенность в том, что плагин рассчитан именно на гибридные сборки, где рядом с модами работает серверная платформа плагинов. Это редкое сочетание, и StatMonsPAPI (plugin for hybrid servers) для Minecraft решает проблему, с которой обычно сталкиваются админы таких проектов: данные мода есть, а показать их игрокам штатными средствами не получается.
Поддерживаемые версии и загрузчики
Плагин ориентирован на связку Cobblemon и серверной платформы плагинов. Актуальные сборки Cobblemon 1.8.x дружат с современными версиями Minecraft, а сам плагин ставится как обычный серверный плагин на Paper или его форки, работающие в гибридном режиме с модами. Перед установкой стоит свериться с описанием конкретного релиза: часть статистики (например, defeated и caught_type_*) зависит от структуры файлов игрока в Cobblemon 1.8.2, поэтому на других версиях мода отдельные счётчики могут вести себя иначе.
Требования
- Гибридный сервер с установленным модом Cobblemon.
- Плагин PlaceholderAPI — без него значения просто некуда выводить.
- Совместимая версия серверного ядра (Paper и форки).
Как установить
Установка простая и занимает пару минут. Сначала убедитесь, что на сервере уже работает PlaceholderAPI. Затем поместите jar-файл плагина в папку plugins и перезапустите сервер. После старта появится конфигурация config.yml, где можно настроить формат покедекс-прогресса, общее число записей, количество знаков после запятой, а также значения для пустых данных (empty-name и empty-value).
Ранги пересчитываются каждые refresh-seconds, по умолчанию раз в 30 секунд, так что топы обновляются без перезагрузки. Событийные счётчики (ловля, бои, яйца, трейды) обновляются в реальном времени, а данные из файлов Cobblemon подтягиваются в момент сохранения профиля игрока — включая офлайн-игроков.
Тем, кто ценит время, стоит заглянуть на foxygame.net: в лаунчере foxygame.net каталог дополнений собран так, что StatMonsPAPI (plugin for hybrid servers) находится поиском за секунды, а установка в один клик избавляет от ручного копирования файлов.
Плейсхолдеры: краткий обзор
Все плейсхолдеры используют префикс statmonspapi. Имена статистик нечувствительны к регистру и подчёркиваниям: shinycaught, shiny_caught и shiny_pokemon_caught — это одно и то же. Базовые шаблоны выглядят так:
- %statmonspapi_<stat>% — значение для игрока, которому показывают плейсхолдер.
- %statmonspapi_rank_<stat>% — место игрока в рейтинге (или дефис, если он не в топе).
- %statmonspapi_top<N>_<stat>% — значение игрока на позиции N.
- %statmonspapi_top<N>_<stat>_name% — ник игрока на позиции N.
- %statmonspapi_dexprogress%, %statmonspapi_dexpercent%, %statmonspapi_dextotal% — прогресс покедекса, процент и общее число записей.
N принимает значения от 1 до лимита топов, по умолчанию до 100. Отдельно есть топы по покедексу: %statmonspapi_top<N>_dexprogress% и %statmonspapi_top<N>_dexpercent%.
Какие статистики доступны
Событийные счётчики считаются плагином на лету по событиям Cobblemon: caught (поймано), shinycaught (шайни), battlewon и battlelose (PvP), registered и seen (покедекс), reel (рыбалка), trades (обмены), fossilrevived (ископаемые), pokeballthrown (броски шаров), evolved (эволюции).
Данные из файлов Cobblemon дают более глубокую историю: defeated (побеждённые дикие покемоны), battle_victory (все победы), pvw_wins и pvn_wins (победы над дикими и NPC-тренерами), eggs_collected и eggs_hatched (яйца), alpha_caught (альфы), tm_learned (изученные TM), aspects_collected (собранные формы). Плюс восемнадцать статистик caught_type_<type> по каждому типу покемонов — от normal до fairy.
Пример использования
Типичный блок топа по шайни в меню или на табличке выглядит так:
- %statmonspapi_top1_shinycaught_name% — %statmonspapi_top1_shinycaught%
- %statmonspapi_top2_shinycaught_name% — %statmonspapi_top2_shinycaught%
- %statmonspapi_top3_shinycaught_name% — %statmonspapi_top3_shinycaught%
А личная строка игрока — %statmonspapi_shinycaught% с рангом %statmonspapi_rank_shinycaught%. Тот же шаблон работает для любой другой статистики: достаточно заменить имя.
Полезные нюансы
Если данных нет, ник отображается как дефис, а значение — как 0; оба символа меняются в конфиге. Если какой-то счётчик упорно показывает ноль, проверьте секцию advancementData в файле игрока — от неё зависят defeated и caught_type_*. А если вы собираете сервер с нуля, лаунчер foxygame.net автоматически подтянет свежую версию StatMonsPAPI (plugin for hybrid servers) и не заставит вручную сверять совместимость с ядром.
Вывод
StatMonsPAPI (plugin for hybrid servers) — узкоспециализированный, но крайне полезный плагин для гибридных серверов с Cobblemon. Он превращает разрозненные данные мода в аккуратные плейсхолдеры, которые легко встроить в любое меню, скорборд или чат. Если вам нужно показать игрокам их достижения и добавить дух соревнования через топы — скачать StatMonsPAPI (plugin for hybrid servers) стоит хотя бы для теста. Настройка занимает минуты, а отдача в виде живой статистики на сервере ощущается сразу.