Плагін Minecraft PlaceholderAPI

🔌 Про PlaceholderAPI

PlaceholderAPI — це Minecraft-плагін, який надає централізовану систему placeholder'ів і екосистему розширень (eCloud). Він дає змогу іншим плагінам читати й підставляти тисячі динамічних placeholder'ів (дані гравця, значення економіки, специфічні значення плагінів тощо) без прямої інтеграції чи жорстких залежностей.

🎯 Призначення

Плагін усуває труднощі інтеграції між плагінами, надаючи один розширюваний API для placeholder'ів. Автори плагінів публікують "розширення", які надають іменовані placeholder'и; адміністратори сервера встановлюють ці розширення, щоб серверні плагіни (scoreboard, чат, holograms, GUI) могли показувати живі дані за єдиним синтаксисом.

⚙️ Можливості

• Базовий API для парсингу placeholder'ів, до якого можуть підключатися інші плагіни.
• Система розширень: окремо упаковані розширення або розширення, вбудовані в плагіни.
• eCloud (хмара розширень) для пошуку та завантаження перевірених розширень прямо в грі.
• Команди керування під час роботи сервера для перегляду списку, реєстрації, скасування реєстрації та перезавантаження розширень.
• Команди debug/parse для перевірки placeholder'ів для гравця або трансляції результату, корисні для усунення несправностей.
• Допоміжні інструменти, як-от команда dump, щоб поділитися встановленими розширеннями та станом плагіна під час звернення по підтримку.

🧩 Для кого це

• Адміністратори серверів, яким потрібен єдиний динамічний текст у кількох плагінах (scoreboard, tablist, holograms, GUI).
• Розробники плагінів, які хочуть надавати або використовувати placeholder'и без жорстких залежностей.
• Survival, minigame і network сервери, які поєднують багато плагінів і потребують єдиного синтаксису placeholder'ів.

🏗️ Приклади використання

• Сервер встановлює розширення Vault, щоб економічні placeholder'и, наприклад баланс гравця, можна було використовувати в плагінах scoreboard і chat.
• Адміністратор завантажує специфічне розширення з eCloud, щоб плагін hologram міг показувати актуальні дані про цілі.
• Розробник відкриває дані плагіна через PlaceholderExpansion, щоб інші сервери могли показувати ці дані без прямої залежності від плагіна.

⌨️ Команди

(Примітка: наведені вище команди задокументовані в офіційному довіднику команд PlaceholderAPI. Ноди дозволів для окремих команд у наведеній документації не вказані.)

⚙️ Встановлення

📥 Налаштування

• Завантажте офіційний jar PlaceholderAPI та помістіть його в каталог plugins/ вашого сервера.
• Запустіть або перезапустіть сервер і переконайтеся, що PlaceholderAPI завантажується в консолі.
• Встановлюйте розширення або шляхом додавання jar-файлів розширень до plugins/PlaceholderAPI/expansions/, або за допомогою внутрішньоігрових команд eCloud (для перевірених розширень).

📦 Залежності

• Сам PlaceholderAPI не потребує загальної залежності від іншого плагіна для роботи. Деякі placeholder'и, що надаються розширеннями, залежать від інших плагінів (наприклад, розширення, яке показує значення економіки, потребуватиме відповідного плагіна економіки). Такі вимоги залежать від конкретного розширення.

🧠 Технічні примітки

• PlaceholderAPI надається для серверів на базі Spigot і також широко використовується на Paper. Він надає API, щоб розробники плагінів могли реєструвати PlaceholderExpansions.
• Розширення можуть розповсюджуватися як окремі jar-файли або бути вбудованими в інші плагіни; окремі розширення зазвичай встановлюються в plugins/PlaceholderAPI/expansions/.
• Функція eCloud дозволяє знаходити й завантажувати перевірені розширення прямо в грі; сервери мають дозволяти вихідні HTTPS-з'єднання, щоб завантаження eCloud працювали.
• Плагін містить команди debug і parsing, щоб допомогти адміністраторам перевіряти, чи placeholder'и розв'язуються правильно.

🤝 Коли цей плагін корисний

Якщо ваш сервер використовує кілька плагінів, яким потрібно показувати динамічні дані між плагінами (чат, tab, holograms, scoreboard або GUI), PlaceholderAPI корисний, бо він централізує обробку placeholder'ів і дає змогу додавати підтримку інших плагінів через модульні розширення без зміни кожного плагіна-споживача.