PlaceholderAPI — плагин для подстановки динамических данных в Minecraft
PlaceholderAPI (PAPI) позволяет плагинам Minecraft выводить динамические данные — имя игрока, баланс, ранг — через простые маркеры…
PlaceholderAPI (PAPI) позволяет плагинам Minecraft выводить динамические данные — имя игрока, баланс, ранг — через простые маркеры %placeholder%.
PlaceholderAPI — плагин для подстановки динамических данных в Minecraft
Версия Minecraft, на которой протестирована и написана статья: 26.1.2
Диапазон поддерживаемых версий: 1.8.x – 26.1.x
PlaceholderAPI (сокращённо PAPI) — серверный плагин для Minecraft, который подставляет в текст динамические значения вместо специальных маркеров. Сам по себе он ничего не выводит: это движок, который находит в строке маркер вида %player_name% и заменяет его на актуальное значение — имя игрока, баланс, ранг, онлайн сервера. Сами данные поставляют отдельные модули — расширения, а PAPI лишь выполняет замену. Благодаря этому плагины чата, скорборда, таб-листа и меню читают значения в одном формате, без собственного синтаксиса.
Формат плейсхолдеров
Плейсхолдер записывается между двумя знаками процента: %<розширення>_<параметр>%. Первая часть до подчёркивания — название расширения, далее — конкретный параметр. Например, %player_name% возвращает имя игрока, а %server_online% — количество игроков онлайн.
Замена срабатывает только там, где её вызывает сам плагин-приёмник. Если плагин не поддерживает PAPI, маркеры в его сообщениях останутся обычным текстом. Проверить отдельный плейсхолдер можно командой разбора:
/papi parse me %player_name%
Если в ответ возвращается сам текст маркера, а не значение — нужного расширения нет либо плагин-источник отключён.
Расширения и eCloud
PlaceholderAPI из коробки не содержит ни одного плейсхолдера — все они приходят из расширений. Одни встроены в плагин-источник и регистрируются сами при запуске сервера; другие лежат отдельными jar-файлами в облаке расширений (eCloud) и устанавливаются в каталог /plugins/PlaceholderAPI/expansions/.
Загрузить нужное расширение можно прямо из игры:
/papi ecloud download <розширення>
/papi reload
Через команду скачиваются только проверенные расширения — это защита от вредоносного кода. Непроверенные ставят вручную: скачивают jar с сайта и кладут в каталог расширений.
Доступ к eCloud: если хостинг или файрвол блокирует внешнее соединение, загрузка через команду не сработает — расширение придётся добавлять вручную.
Команды
Все команды начинаются с /papi. По умолчанию они доступны только операторам; отдельные права выдаются через узлы placeholderapi.*.
Команда | Назначение |
| Разобрать плейсхолдеры в тексте для игрока |
| Разобрать реляционные плейсхолдеры для двух игроков |
| Показать активные расширения |
| Информация о конкретном расширении |
| Загрузить расширение из облака |
| Список плейсхолдеров расширения |
| Перезагрузить плагин и конфиг |
| Версия установленного плагина |
Конфиг
В config.yml для редактирования полезны лишь несколько параметров:
Параметр | Что делает |
| Соединение с eCloud. |
| Текст логических значений плейсхолдеров; можно заменить на да / нет |
| Формат даты и времени для соответствующих плейсхолдеров |
| Проверка обновлений плагина при запуске и уведомление операторов |
Остальные значения в файле — служебные (защита расширений, режим замены в компонентах Adventure, отладка) и по умолчанию их не трогают.
Заключение
PlaceholderAPI даёт единый формат подстановки данных, который понимают сотни плагинов: вместо отдельной интеграции под каждый плагин достаточно одной строки с плейсхолдером. Нужен администраторам Minecraft-серверов с чатом, таб-листом, скорбордом или меню на динамических данных; для одиночной игры применения не имеет.
Установка
Базовая установка занимает около 5 минут. Общий процесс одинаков, отличается только лоадер и совместимый билд.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
