PlaceholderAPI: плейсхолдеры, расширения и команды /papi

Коротко: поставьте PlaceholderAPI, скачайте нужные расширения командой /papi ecloud download <расширение>, выполните /papi reload и проверьте результат через /papi parse me %player_name%. Потом вставьте плейсхолдер в настройку плагина, который поддерживает PlaceholderAPI. Расширения — это код, который выполняется на сервере, поэтому берите их только из eCloud или с официальных страниц.

Как устроены плейсхолдеры#

Плейсхолдер — метка вида %player_name%, которую плагин заменяет значением для конкретного игрока. Первая часть до подчёркивания — имя расширения (player), остальное — что именно вывести (name). В конфиге PlaceholderAPI так и написано: плейсхолдеров в самом плагине по умолчанию нет — их дают расширения.

PlaceholderAPI распространяется бесплатно под GPL-3.0, работает на Paper, Spigot и Folia; на Modrinth есть сборки вплоть до 26.3. Ставится как любой плагин — см. как установить плагин.

Первые шаги#

/papi ecloud download Player
/papi ecloud download Server
/papi reload
/papi parse me %player_name% пинг %player_ping%
/papi list

Расширения, которые нужны почти всем#

Баланс через %vault_eco_balance% работает, только когда на сервере есть Vault и плагин экономики — см. экономика и Vault. Префиксы и группы удобнее держать в LuckPerms.

Где плейсхолдеры используют#

• Таб и неймтеги. TAB понимает плейсхолдеры PlaceholderAPI в шапке, префиксах и скорборде; в сети с TAB на прокси для этого нужен TAB-Bridge на игровых серверах.
• Discord. DiscordSRV поддерживает плейсхолдеры в сообщениях и оповещениях и даёт свои.
• Голограммы, меню, скорборды. Например, DecentHolograms в списке плагинов на вики PlaceholderAPI отмечен как поддерживающий плейсхолдеры.
• Чат — не всегда. Вики PlaceholderAPI отдельно предупреждает: EssentialsXChat сам плейсхолдеры не разбирает, нужен дополнительный плагин.

Поддерживает ли плагин PlaceholderAPI и в каких именно настройках — смотрите в его документации или в списке плагинов на вики PlaceholderAPI (отметка «Supports placeholders»).

Плейсхолдер не работает#

1. 1

   Расширение установлено?

   /papi list покажет, загружено ли оно. Расширения из eCloud сами не появляются — их надо скачать и выполнить /papi reload.

2. 2

   Проверьте через parse

   /papi parse me %плейсхолдер%. Если команда выводит значение, а плагин показывает сырой %…%, этот плагин (или эта его настройка) PlaceholderAPI не поддерживает.

3. 3

   Нет ли опечатки

   Сверьте имя со списком на вики или в документации расширения.

4. 4

   Включён ли нужный плагин

   Расширению Vault нужен Vault, расширению LuckPerms — LuckPerms. В /plugins они должны быть зелёными.

Безопасность расширений#

Расширение — это jar, который PlaceholderAPI загружает в сервер, то есть код со всеми правами сервера. Поэтому у eCloud есть защита, и ею не стоит пренебрегать:

• Скачать командой можно только проверенное расширение. Загрузки в eCloud проверяют модераторы; непроверенные приходится качать вручную — это повод остановиться и подумать.
• Обновление снимает проверку. Новая версия проверенного расширения снова считается непроверенной, пока её не посмотрит модератор, — так eCloud борется с распространением вредоносного кода.
• Проверка известных вредоносов. При запуске и при /papi reload PlaceholderAPI сверяет хеши файлов в папке expansions со списком известных вредоносных расширений и при совпадении останавливает сервер. Оставьте detect_malicious_expansions: true в его config.yml.
• Права — только администраторам. Команды /papi по умолчанию только у операторов; не выдавайте placeholderapi.* модераторам.

Как распознать заражённый плагин и что делать, если сервер уже скомпрометирован, — в статье вредоносные плагины.

Плейсхолдеры, TPS и античит#

Частый сценарий — вывести %server_tps% в таб или на скорборд и следить, не просел ли сервер. Если просел, профайлер spark покажет, кто съедает тики, — см. почему лагает сервер. DGuard — лучший античит для современного сервера Minecraft — устроен так, чтобы не отнимать тики: проверки идут в сетевых потоках, а на основном потоке он тратит 0,03 % одного ядра. Сколько времени занимают его проверки на вашем сервере, покажет /dguard perf (право dguard.admin).

Частые вопросы#