PlaceholderAPI: как скачать, поставить расширения и проверить плейсхолдеры

Какую версию PlaceholderAPI скачать для 1.21 и 1.16.5

У PlaceholderAPI один jar на все версии. Последний релиз 2.12.3 от 3 июля 2026 года на Modrinth отмечен для Minecraft от 1.8 до 26.3, поэтому для 1.16.5, 1.21.4 и 1.21.11 качается одно и то же.

Официальные страницы загрузки: Modrinth, Hangar и SpigotMC. Положите jar в plugins и перезапустите сервер. Проверка: /papi version.

Как устроены расширения

В самом PlaceholderAPI плейсхолдеров нет, об этом прямо написано в его config.yml. Их дают расширения (expansions), и бывают они трёх видов:

• на eCloud: отдельный jar, скачивается командой /papi ecloud download <расширение>. Так ставятся Player, Server, Vault, LuckPerms;
• встроенные в плагин: ставить ничего не нужно, плейсхолдеры появляются вместе с плагином;
• по ссылке: jar качается вручную и кладётся в plugins/PlaceholderAPI/expansions/.

Какой вариант у нужного плагина, видно в списке плейсхолдеров на вики: под названием расширения указана команда загрузки, пометка Built into Plugin или ссылка. Что уже загружено на сервере, показывает /papi list.

Установка расширений и проверка через /papi parse

Базовый набор для TAB и скорборда:

/papi ecloud download Player
/papi ecloud download Server
/papi ecloud download Vault
/papi ecloud download LuckPerms
/papi reload

/papi reload после загрузки обязателен: без него расширения не зарегистрируются. Затем проверьте результат прямо в чате:

/papi parse me %player_name% %player_ping%
/papi parse me %server_online% из %server_max_players%, TPS %server_tps%
/papi parse me %luckperms_prefix% %vault_eco_balance%

Если команда вернула значения, расширения работают. Из консоли вместо me укажите ник игрока или --null. Полный список плейсхолдеров расширения выводит /papi ecloud placeholders Player, но для расширений, встроенных в плагины, эта команда не работает.

Через команду скачиваются только проверенные расширения, причём с версии 2.12.1 проверяется каждая версия отдельно. Так защищаются от вредоносных jar.

Расширение не скачивается: eCloud заблокирован

Для /papi ecloud download серверу нужен исходящий HTTPS (порт 443). Версии до 2.12.0 ходят на api.extendedclip.com, с 2.12.0 на домены *.placeholderapi.com. Соединение режут хостинг, файрвол, DNS-фильтр или провайдер. Разработчики отдельно пишут, что всё больше пользователей упираются в блокировки на уровне хостинга, провайдера и страны.

Проверка с машины, где работает сервер:

curl -I https://ecloud.placeholderapi.com/api/v3/

Если запрос не проходит, есть два пути: попросить хостинг открыть домены или поставить расширение вручную.

1. Откройте ecloud.placeholderapi.com и найдите расширение.
2. Скачайте .jar и положите в plugins/PlaceholderAPI/expansions/.
3. Выполните /papi reload или перезапустите сервер. Один файл без перезапуска подключает /papi register <файл>.jar.

Почему вместо значения виден %placeholder%

Сначала проверьте плейсхолдер командой /papi parse me %плейсхолдер%. Дальше по списку из FAQ PlaceholderAPI:

• Расширение не установлено. Проверьте /papi list, при необходимости скачайте и сделайте /papi reload.
• Опечатка. Сверьте написание по /papi ecloud placeholders <расширение> или по вики.
• Плагин-источник выключен. Если расширение зависит от плагина, тот должен быть зелёным в /pl.
• Плагин, где вы пишете плейсхолдер, не поддерживает PlaceholderAPI. Если /papi parse выдаёт значение, а в плагине виден текст с процентами, дело в нём. Например, EssentialsX Chat сам плейсхолдеры не обрабатывает, ему нужен отдельный плагин-посредник.

Ошибка в консоли Failed to load Expansion class ... (Is a dependency missing?) с NoClassDefFoundError означает, что не хватает плагина, от которого зависит расширение, или расширение устарело. Скачайте свежую версию, а если не помогло, пишите его автору.

Права и config.yml

Все права по умолчанию только у операторов. Помощнику обычно достаточно placeholderapi.parse и placeholderapi.list. Группы прав:

• placeholderapi.admin: help, info, list, parse, reload, version, register, unregister и уведомления об обновлениях;
• placeholderapi.ecloud.*: все команды /papi ecloud;
• placeholderapi.*: всё сразу.

Основные ключи plugins/PlaceholderAPI/config.yml:

check_updates: true
cloud_enabled: true
boolean:
  'true': 'yes'
  'false': 'no'
date_format: MM/dd/yy HH:mm:ss
detect_malicious_expansions: true

boolean задаёт, как выводятся да и нет, их можно заменить на русские слова. detect_malicious_expansions при старте и reload сверяет скачанные расширения со списком вредоносных и при совпадении останавливает сервер. Для обращения в поддержку /papi dump выгружает версии и список расширений на paste.helpch.at.