PlaceholderAPI

PlaceholderAPI - это плагин для Spigot серверов Minecraft, который решает одну из главных проблем админов: как красиво и гибко отображать данные из разных плагинов в одном месте. Без него пришлось бы каждый раз лезть в код или ставить костыли. А с ПлейсхолдерАПИ всё просто - используешь плейсхолдеры вида %plugin_placeholder%, и они автоматически подставляют нужные значения: баланс игрока, онлайн сервера, клан, уровень и многое другое.

Поддержка конкретных плагинов реализуется либо самим плагином (если он поддерживает PAPI), либо через расширения (expansions). Расширения можно скачать прямо в игре через PAPI Expansion Cloud. На данный момент доступно более 230+ расширений для таких популярных плагинов, как Essentials, Factions, LuckPerms, Vault и многих других. Если ты разработчик - можешь добавить поддержку PlaceholderAPI в свой плагин.

PlaceholderAPI скачали уже более 2 миллионов раз, и он работает одновременно на более чем 50 000 серверах. Это must-have для любого сервера - от маленького фан-сервера до огромной сети.

Конфигурация

Файл config.yml содержит основные настройки плагина, а также секцию для расширений, которые могут добавлять свои опции. Когда расширение загружается, его настройки автоматически появляются в конфиге.

# PlaceholderAPI
# Version: 2.11.4
check_updates: true
cloud_enabled: true
cloud_sorting: "name"
cloud_allow_unverified_expansions: false
boolean:
  'true': 'yes'
  'false': 'no'
date_format: MM/dd/yy HH:mm:ss
debug: false

Права (Permissions)

Плагин использует развёрнутую систему прав. Вот основные группы:

• placeholderapi.* - все права PAPI.
• placeholderapi.admin - доступ ко всем командам управления.
• placeholderapi.ecloud.* - все команды eCloud.
• Остальные права - для конкретных команд (help, info, list, parse и т.д.).

По умолчанию большинство прав выданы только операторам (op).

Команды

Parse Commands - для тестирования плейсхолдеров:

• /papi bcparse <player|--null|me> <string> - broadcast parse.
• /papi cmdparse <player|me> <string> - command parse.
• /papi parse <player|--null|me> <string> - обычный парсинг.
• /papi parserel <player> <player> <string> - относительный парсинг (для двух игроков).

eCloud Commands - управление облаком расширений:

• /papi ecloud status - статус облака.
• /papi ecloud clear - очистить локальный кэш.
• /papi ecloud download <expansion> [version] - скачать расширение.
• /papi ecloud update <expansion/all> - обновить.
• /papi ecloud info <expansion> [version] - информация о расширении.
• /papi ecloud list <all|<author>|installed> [page] - список расширений.
• /papi ecloud placeholders <expansion> - список плейсхолдеров расширения.
• /papi ecloud refresh - обновить кэш облака.

Expansion Commands - управление установленными расширениями:

• /papi info <expansion> - информация о расширении.
• /papi list - список активных расширений.
• /papi register <jar file> - зарегистрировать расширение из файла.
• /papi unregister <jar file> - удалить расширение.

Utility Commands:

• /papi dump - дамп информации для отладки.
• /papi reload - перезагрузить плагин и конфиг.
• /papi version - версия плагина.

Вот такой набор команд покрывает все нужды админа. Скачайте PlaceholderAPI и настройте отображение данных на своём сервере Minecraft как душе угодно.