PlaceholderAPI — плагін для підстановки динамічних даних у Minecraft
PlaceholderAPI — плагін для підстановки динамічних даних у Minecraft
Версія Minecraft, на якій протестовано і написано статтю: 26.1.2
Діапазон підтримуваних версій: 1.8.x – 26.1.x
PlaceholderAPI (скорочено PAPI) — серверний плагін для Minecraft, який підставляє у текст динамічні значення замість спеціальних маркерів. Сам по собі він нічого не виводить: це рушій, що знаходить у рядку маркер виду %player_name% і замінює його на актуальне значення — ім'я гравця, баланс, ранг, онлайн сервера. Самі дані постачають окремі модулі — розширення, а PAPI лише виконує заміну. Завдяки цьому плагіни чату, скорборду, таб-листа й меню читають значення в одному форматі, без власного синтаксису.
Формат плейсхолдерів
Плейсхолдер записується між двома знаками відсотка: %<розширення>_<параметр>%. Перша частина до підкреслення — назва розширення, далі — конкретний параметр. Наприклад, %player_name% повертає ім'я гравця, а %server_online% — кількість гравців онлайн.
Заміна спрацьовує лише там, де її викликає сам плагін-приймач. Якщо плагін не підтримує PAPI, маркери в його повідомленнях залишаться звичайним текстом. Перевірити окремий плейсхолдер можна командою розбору:
/papi parse me %player_name%
Якщо у відповідь повертається сам текст маркера, а не значення — потрібного розширення немає або плагін-джерело вимкнений.
Розширення та eCloud
PlaceholderAPI з коробки не містить жодного плейсхолдера — усі вони приходять із розширень. Одні вбудовані в плагін-джерело й реєструються самі при запуску сервера; інші лежать окремими jar-файлами в хмарі розширень (eCloud) і встановлюються в каталог /plugins/PlaceholderAPI/expansions/.
Завантажити потрібне розширення можна прямо з гри:
/papi ecloud download <розширення>
/papi reload
Через команду викачуються лише перевірені розширення — це захист від шкідливого коду. Неперевірені ставлять вручну: завантажують jar із сайту й кладуть у каталог розширень.
Доступ до eCloud: якщо хостинг чи фаєрвол блокує зовнішнє з'єднання, завантаження через команду не спрацює — розширення доведеться додавати вручну.
Команди
Усі команди починаються з /papi. За замовчуванням вони доступні лише операторам; окремі права роздаються через вузли placeholderapi.*.
Команда | Призначення |
| Розібрати плейсхолдери в тексті для гравця |
| Розібрати реляційні плейсхолдери для двох гравців |
| Показати активні розширення |
| Інформація про конкретне розширення |
| Завантажити розширення з хмари |
| Перелік плейсхолдерів розширення |
| Перезавантажити плагін і конфіг |
| Версія встановленого плагіна |
Конфіг
У config.yml для редагування корисні лише кілька параметрів:
Параметр | Що робить |
| З'єднання з eCloud. |
| Текст логічних значень плейсхолдерів; можна замінити на так / ні |
| Формат дати й часу для відповідних плейсхолдерів |
| Перевірка оновлень плагіна при запуску й сповіщення операторів |
Решта значень у файлі — службові (захист розширень, режим заміни в компонентах Adventure, дебаг) і за замовчуванням їх не чіпають.
Висновок
PlaceholderAPI дає єдиний формат підстановки даних, який розуміють сотні плагінів: замість окремої інтеграції під кожен плагін достатньо одного рядка з плейсхолдером. Потрібен адміністраторам Minecraft-серверів із чатом, таб-листом, скорбордом чи меню на динамічних даних; для одиночної гри застосування не має.
Встановлення
Типове встановлення займає близько 5 хвилин. Порядок однаковий; відрізняються лише лоадер і відповідна збірка.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
