PlaceholderAPI

PlaceholderAPI представляет собой популярный плагин для Minecraft серверов на базе Spigot, который открывает широкие возможности по интеграции данных из различных плагинов в едином формате.

Основные возможности

Данный модуль предлагает универсальную систему подстановок (плейсхолдеров), благодаря которой владельцы серверов могут отображать практически любую информацию из разнообразных плагинов, используя единый стандарт оформления.

Поддержка конкретных плагинов осуществляется либо через встроенные функции самих плагинов, либо с помощью специальных расширений. В распоряжении пользователей находится более 230 готовых расширений, которые охватывают большинство популярных решений включая Essentials, Factions, LuckPerms и Vault. Все расширения можно легко загружать непосредственно в игре через интегрированное PAPI Expansion Cloud хранилище.

Установка

Процесс установки плагина интуитивно понятен и не занимает много времени. Все необходимые файлы доступны на официальных ресурсах разработчика.

Настройка

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

# PlaceholderAPI
# Версия: 2.11.4
# Создано: extended_clip
# Разработчики: https://github.com/PlaceholderAPI/PlaceholderAPI/graphs/contributors
# Проблемы: https://github.com/PlaceholderAPI/PlaceholderAPI/issues
# Расширения: https://api.extendedclip.com/all/
# Документация: https://github.com/PlaceholderAPI/PlaceholderAPI/wiki
# Проверять обновления: true
cloud_enabled: true
cloud_sorting: "name"
cloud_allow_unverified_expansions: false
boolean:
  'true': 'да'
  'false': 'нет'
format_dat: ММ/дд/гг ЧЧ:мм:cc
debug: false

Права доступа

Система разрешений организована по иерархическому принципу:

permissions:
  placeholderapi.:
    description: "Доступ ко всем командам PAPI"
    children:
      placeholderapi.admin: true
      placeholderapi.ecloud.: true
  placeholderapi.admin:
    description: "Администрирование PAPI"
    children:
      placeholderapi.help: true
      placeholderapi.info: true
      placeholderapi.list: true
      placeholderapi.parse: true
      placeholderapi.reload: true
      placeholderapi.version: true
      placeholderapi.register: true
      placeholderapi.unregister: true
  placeholderapi.ecloud.download:
    default: "op"
    description: "Скачивание расширений из облака"

Команды администратора

Команды обработки плейсхолдеров

• /papi bcparse <игрок|--null|me> <текст>
• /papi cmdparse <игрок|me> <текст>
• /papi parse <игрок|--null|me> <текст>
• /papi parserel <игрок> <игрок> <текст>

Управление облачными расширениями

• /papi ecloud status - проверка состояния
• /papi ecloud download <расширение> [версия] - загрузка
• /papi ecloud update <расширение/все> - обновления
• /papi ecloud list <все|<автор>|установленные> [страница] - список
• /papi ecloud info <расширение> [версия] - информация

Работа с расширениями

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

Дополнительные утилиты

• /papi dump - диагностика
• /papi reload - перезагрузка
• /papi version - проверка версии

Статистика загрузок превышает 1.5 миллиона, а количество активных серверов составляет более 40000, что делает плагин практически обязательным к установке для серверов любого типа и масштаба.