PlaceholderAPI: плейсхолдеры
Установка PlaceholderAPI, загрузка расширений, список полезных плейсхолдеров и отладка, когда вместо значения виден сам плейсхолдер.
Обновлено 13 августа 2026 г.
PlaceholderAPI — библиотека подстановок. Она позволяет одному плагину показывать данные другого: баланс в чате, регион в скорборде, клан в списке игроков.
Установка
Плагин из каталога, затем расширения под нужные источники:
papi ecloud download Vault
papi ecloud download Player
papi ecloud download Server
papi reload
Расширения ставятся по одному, под каждый источник данных.
Полезные плейсхолдеры
| Плейсхолдер | Значение |
|---|---|
%player_name% | Ник |
%player_ping% | Пинг |
%player_world% | Мир |
%server_online% | Онлайн |
%server_tps_1% | TPS за минуту |
%vault_eco_balance_formatted% | Баланс |
%luckperms_prefix% | Префикс группы |
%worldguard_region_name% | Регион под игроком |
Проверка
papi parse me %vault_eco_balance%
Команда покажет, что реально подставляется. Если видно сам текст %vault_eco_balance%, значит:
- не установлено расширение;
- источник данных отсутствует (нет плагина экономики);
- плагин, где вы вставили плейсхолдер, не поддерживает PlaceholderAPI.
Последнее — самая частая причина: не все плагины умеют внешние подстановки, даже если у них есть свои.
Нагрузка
Плейсхолдеры вычисляются при каждом обновлении. Скорборд с десятью значениями, обновляемый каждый тик, — это 200 вычислений в секунду на игрока: Скорборд.