PlaceholderAPI: установка, плейсхолдеры и расширения (eCloud)

Полное руководство по PlaceholderAPI для Minecraft: установка, команды eCloud, популярные плейсхолдеры и интеграция с TAB, DeluxeMenus, Scoreboard.

Кратко: PlaceholderAPI (PAPI) - стандарт де-факто для динамических переменных на Minecraft-серверах. Установи JAR в plugins/, скачай нужные расширения командой /papi ecloud download, и любой совместимый плагин начнёт отображать имя игрока, баланс, TPS и другие данные. Без PAPI половина популярных плагинов не работает корректно.

PlaceholderAPI: установка, плейсхолдеры и расширения (eCloud)

PlaceholderAPI - один из самых загружаемых плагинов в экосистеме Bukkit/Spigot/Paper с суммарным числом загрузок, давно превысившим 700 000. По состоянию на 2026 год он является обязательным компонентом практически любого публичного сервера: без него такие плагины, как TAB, DeluxeMenus, ScoreboardReloaded, CMI и десятки других, просто не могут получить данные об игроке в реальном времени. PAPI работает как мост - он предоставляет единый API, через который один плагин может запросить переменную (плейсхолдер) у другого. Например, LuckPerms через PAPI сообщает группу игрока, а TAB подхватывает её и красиво отображает в таблице игроков. В этом руководстве разберём установку с нуля, работу с облачным репозиторием расширений (eCloud), популярные плейсхолдеры и типичные ошибки.

Pterohost - хостинг Minecraft-серверов с NVMe-дисками, защитой от DDoS и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Что такое плейсхолдер и как работает PAPI

Плейсхолдер - это строка вида %plugin_значение%, которую поддерживающий PAPI плагин заменяет реальным значением в момент отображения. Например:

• %player_name% - превращается в ник игрока
• %server_tps% - показывает текущий TPS сервера
• %vault_eco_balance% - отображает баланс из экономики Vault

Схема работы проста. Плагин A (например TAB) встречает строку %luckperms_rank% в своём конфиге. Он передаёт её в PAPI. PAPI находит зарегистрированное расширение LuckPerms и запрашивает у него значение для конкретного игрока. Расширение возвращает строку “Admin” или “VIP”. TAB получает её и отображает в нужном месте.

Без PAPI каждый плагин должен был бы напрямую зависеть от каждого другого плагина. PAPI делает эту связь универсальной и слабосвязанной.

Установка PlaceholderAPI

Шаг 1. Скачать JAR

Актуальная версия PlaceholderAPI доступна на двух площадках:

• SpigotMC: spigotmc.org/resources/placeholderapi.6245
• GitHub Releases: github.com/PlaceholderAPI/PlaceholderAPI/releases

По состоянию на 2026 год актуальная ветка - 2.11.x. Скачивай именно её для Paper/Spigot 1.16+. Для очень старых серверов (1.8-1.12) есть отдельные форки, но рекомендуется обновить ядро.

Шаг 2. Положить в plugins/

Скопируй JAR-файл в папку plugins/ на сервере. Через панель Pterodactyl это делается через вкладку Files - просто загрузи файл в директорию /plugins.

Шаг 3. Перезапустить сервер

После перезапуска PlaceholderAPI создаст свою директорию plugins/PlaceholderAPI/ со следующей структурой:

plugins/PlaceholderAPI/
  config.yml          - основной конфиг
  expansions/         - папка для скачанных расширений
  storage/            - кэш eCloud и прочие данные

Проверь в консоли, что PAPI загрузился без ошибок:

[PlaceholderAPI] Enabling PlaceholderAPI v2.11.6
[PlaceholderAPI] Successfully loaded!

Шаг 4. Проверить загрузку

Выполни в консоли или в игре с правами оператора:

/papi version

Команда вернёт версию, автора и статус соединения с eCloud.

Расширения (Expansions) и eCloud

Сам PlaceholderAPI по умолчанию содержит только несколько встроенных плейсхолдеров. Почти всё остальное поставляется в виде расширений (expansions) - отдельных JAR-файлов или классов, которые регистрируют свои плейсхолдеры.

Расширения бывают двух типов:

1. Встроенные в плагин - LuckPerms, EssentialsX, CMI и другие крупные плагины сами регистрируют свои плейсхолдеры при наличии PAPI. Отдельно качать ничего не нужно.

2. Отдельные расширения из eCloud - облачный репозиторий PlaceholderAPI, где публикуются расширения для плагинов, не имеющих встроенной поддержки PAPI, а также утилитарные расширения (Player, Server, Vault, Math, BungeeCord и другие).

Команды для работы с eCloud

Установка основных расширений

После установки PAPI скачай базовые расширения, которые нужны большинству серверов:

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

Если eCloud недоступен (редкость, но бывает), расширения можно скачать вручную с GitHub и положить в plugins/PlaceholderAPI/expansions/.

Популярные плейсхолдеры

Плейсхолдеры расширения Player

Расширение Player - одно из самых используемых. Оно предоставляет базовые данные об игроке:

Плейсхолдеры расширения Server

Расширение Server даёт информацию о сервере в целом:

Плейсхолдеры расширения Vault

Требует установленного плагина Vault и экономики (EssentialsX Economy, CMI Economy и т.д.):

Плейсхолдеры LuckPerms (встроенные)

LuckPerms регистрирует свои плейсхолдеры автоматически при наличии PAPI - отдельное расширение не нужно:

Плейсхолдеры EssentialsX (встроенные)

EssentialsX также имеет встроенную поддержку PAPI:

Интеграция с популярными плагинами

TAB (плагин для табов и нейминга)

TAB - один из главных потребителей PAPI. В конфиге plugins/TAB/config.yml плейсхолдеры используются напрямую:

groups:
  Admin:
    tabprefix: "&c[Admin] "
    tabsuffix: " &7| &aTPS: %server_tps_1%"
    customtabname: "&c%player_name%"
  default:
    tabprefix: "&7[%luckperms_primary_group_name%] "
    tabsuffix: ""

В конфиге header/footer:

header:
  - "&6Сервер: &f%server_name% &7| &aОнлайн: &f%server_online%/%server_max_players%"
  - "&7TPS: &a%server_tps_1% &7| RAM: &e%server_ram_used%MB"
footer:
  - "&7Пинг: &a%player_ping%ms &7| Мир: &f%player_world%"

DeluxeMenus (GUI-меню)

DeluxeMenus использует PAPI для отображения данных в кнопках меню. Пример конфига кнопки в plugins/DeluxeMenus/gui_menus/profile.yml:

items:
  'info':
    material: PLAYER_HEAD
    skull: '%player_name%'
    display_name: '&6Профиль: &f%player_displayname%'
    lore:
      - '&7Группа: &f%luckperms_primary_group_name%'
      - '&7Баланс: &a%vault_eco_balance_formatted%'
      - '&7Здоровье: &c%player_health%&7/&c%player_max_health%'
      - '&7Мир: &f%player_world%'
      - '&7Пинг: &e%player_ping%ms'
    slot: 4

Scoreboard (AnimatedScoreboard / FastScoreboard)

Пример конфига боковой панели (scoreboard) с PAPI-плейсхолдерами:

title: "&6&lМой сервер"
lines:
  - ""
  - "&7Игрок: &f%player_name%"
  - "&7Группа: &f%luckperms_primary_group_name%"
  - ""
  - "&7Баланс:"
  - "&a$ %vault_eco_balance_formatted%"
  - ""
  - "&7TPS: &a%server_tps_1%"
  - "&7Онлайн: &f%server_online%"
  - ""
  - "&emc.example.com"

CMI (Comprehensive Minecraft Inventory)

CMI имеет обширный встроенный набор плейсхолдеров PAPI. Несколько примеров:

Проверка и диагностика плейсхолдеров

Базовая проверка

Главный инструмент диагностики - команда /papi parse:

/papi parse <ник> <плейсхолдер>

Примеры:

/papi parse Notch %player_name%
/papi parse Notch %server_tps%
/papi parse Notch %vault_eco_balance%
/papi parse Notch %luckperms_primary_group_name%

Если плейсхолдер возвращает сам себя (то есть %player_name% вместо “Notch”), значит расширение не загружено.

Список загруженных расширений

/papi list

Команда показывает все активные расширения. Если нужного расширения нет в списке - его надо скачать или переустановить.

Диагностика eCloud

/papi ecloud status

Показывает, доступен ли облачный репозиторий. Если статус “offline” - загрузи расширения вручную.

Типичные ошибки и их решение

Ошибка 1. Плейсхолдер возвращает сам себя

Симптом: В табе или скорборде отображается буквально %player_name% вместо ника.

Причина: Расширение Player не установлено или не загружено.

Решение:

/papi ecloud download Player
/papi reload

Ошибка 2. Vault-плейсхолдеры не работают

Симптом: %vault_eco_balance% возвращает пустую строку или саму себя.

Причины:

• Не установлен плагин Vault
• Не установлена экономика (EssentialsX Economy, CMI Economy и т.д.)
• Не скачано расширение Vault для PAPI

Решение:

1. Убедись, что Vault.jar стоит в plugins/
2. Убедись, что есть плагин экономики
3. Выполни /papi ecloud download Vault и /papi reload

Ошибка 3. PAPI не загружается - ошибка в консоли

Симптом: В консоли при старте сервера ошибка Could not load PlaceholderAPI.

Частые причины:

• Версия PAPI не совместима с версией сервера
• Конфликт с другим плагином (редко)
• Повреждённый JAR

Решение: Скачай свежую версию PAPI с GitHub Releases, убедись, что она совместима с твоей версией Paper/Spigot.

Ошибка 4. eCloud недоступен

Симптом: Команда /papi ecloud download выдаёт ошибку соединения.

Решение: Скачай нужное расширение вручную. Большинство расширений есть на GitHub PlaceholderAPI organisation или на Spigot. Готовый JAR положи в plugins/PlaceholderAPI/expansions/ и выполни /papi reload.

Ошибка 5. Плейсхолдеры работают в консоли, но не в игре

Симптом: /papi parse в консоли работает, но в скорборде или табе значение не подставляется.

Причина: Плагин (TAB, DeluxeMenus) не обновляет значения плейсхолдеров. Возможно, устаревшая версия плагина или неправильный синтаксис в конфиге (лишний пробел, неверные кавычки).

Решение: Проверь, что плагин поддерживает PAPI (обычно это указано на странице плагина). Проверь синтаксис конфига - плейсхолдеры должны быть внутри строк в кавычках, без лишних пробелов.

Обновление расширений

Расширения eCloud периодически обновляются. Чтобы обновить всё одной командой:

/papi ecloud update all
/papi reload

Для обновления конкретного расширения:

/papi ecloud update Player
/papi ecloud update Vault
/papi reload

Если сервер запущен под управлением Pterodactyl, можно запланировать автоматическое обновление через планировщик задач: добавь команду /papi ecloud update all в список команд при старте сервера (в секцию startup commands) - тогда расширения будут обновляться при каждом перезапуске.

Создание собственных плейсхолдеров (для разработчиков)

Если ты пишешь свой плагин и хочешь добавить поддержку PAPI, добавь зависимость в pom.xml или build.gradle:

<!-- Maven -->
<dependency>
  <groupId>me.clip</groupId>
  <artifactId>placeholderapi</artifactId>
  <version>2.11.6</version>
  <scope>provided</scope>
</dependency>

Затем создай класс, расширяющий PlaceholderExpansion:

public class MyExpansion extends PlaceholderExpansion {

    @Override
    public String getIdentifier() {
        return "myplugin"; // плейсхолдеры будут %myplugin_xxx%
    }

    @Override
    public String getAuthor() {
        return "YourName";
    }

    @Override
    public String getVersion() {
        return "1.0.0";
    }

    @Override
    public String onPlaceholderRequest(Player player, String params) {
        if (params.equals("score")) {
            return String.valueOf(getScore(player));
        }
        return null; // если плейсхолдер не известен
    }
}

Зарегистрируй расширение в onEnable():

if (Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null) {
    new MyExpansion().register();
}

После этого плейсхолдер %myplugin_score% будет доступен во всех PAPI-совместимых плагинах.

Связанные материалы

Если ты настраиваешь полноценный сервер, обрати внимание на связанные руководства. В статье Лучшие плагины для Minecraft-сервера собраны топовые плагины, большинство из которых работают через PlaceholderAPI. Для настройки прав и групп на сервере читай Установка и настройка LuckPerms - именно LuckPerms чаще всего используется в связке с PAPI для отображения рангов. А полный список команд EssentialsX, чьи плейсхолдеры мы разобрали в этой статье, смотри в руководстве Команды EssentialsX: полный список.

Заключение

PlaceholderAPI - это фундамент, без которого современный публичный Minecraft-сервер практически не функционирует. Установка занимает несколько минут: скачай JAR, положи в plugins/, перезапусти сервер, установи нужные расширения через /papi ecloud download. После этого десятки плагинов получат доступ к единой системе переменных и смогут отображать имена, балансы, TPS, группы и любые другие данные в нужных местах. Регулярно обновляй расширения командой /papi ecloud update all, используй /papi parse для диагностики - и PAPI будет работать без проблем долгие годы.

Pterohost - надёжный хостинг Minecraft с NVMe-хранилищем, защитой от DDoS и русскоязычной поддержкой 24/7, которая поможет с любыми вопросами по настройке плагинов. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг