Плагін Minecraft PlaceholderAPI
Інформація про 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, щоб інші сервери могли показувати ці дані без прямої залежності від плагіна.
⌨️ Команди
| Команда | Опис | Дозвіл | Доступ |
|---|---|---|---|
| `/papi parse <player | me> | Парсить placeholder'и в рядку та показує результат для налагодження. | не вказано |
| `/papi bcparse <player | me> | Парсить placeholder'и та транслює результат усім гравцям. | не вказано |
| `/papi cmdparse <player | me> | Парсить placeholder'и та виконує отриману команду. | не вказано |
/papi parserel <player1> <player2> <text> | Парсить реляційні placeholder'и, порівнюючи двох гравців. | не вказано | Адмін |
/papi list | Показує активні/зареєстровані розширення. | не вказано | Адмін |
/papi info <expansion> | Показує інформацію про зареєстроване розширення. | не вказано | Адмін |
/papi register <filename> | Реєструє jar-файл розширення з папки expansions без перезапуску. | не вказано | Адмін |
/papi unregister <filename> | Скасовує реєстрацію/видаляє зареєстроване розширення. | не вказано | Адмін |
/papi reload | Перезавантажує конфігурацію PlaceholderAPI та реєструє нещодавно завантажені розширення. | не вказано | Адмін |
/papi version | Показує версію плагіна та авторів. | не вказано | Адмін |
/papi dump | Виводить інформацію про плагін/версію/розширення для підтримки (сервіс paste). | не вказано | Адмін |
/papi ecloud download <expansion> [version] | Завантажує перевірене розширення з eCloud на сервер. | не вказано | Адмін |
| `/papi ecloud list [all | installed]` | Показує розширення, доступні в eCloud, або встановлені розширення. | |
/papi ecloud placeholders <expansion> | Показує placeholder'и, які надає розширення з eCloud. | не вказано | Адмін |
/papi ecloud status | Показує стан/підключення служби eCloud. | не вказано | Адмін |
(Примітка: наведені вище команди задокументовані в офіційному довіднику команд 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'ів і дає змогу додавати підтримку інших плагінів через модульні розширення без зміни кожного плагіна-споживача.
Restarting...1458.29
FoxyCraft657.72
FroggieПривітний survival SMP із захищеними клеймами, економікою з магазинами гравців і аукціонами, підтримкою кількох версій та cross-play між Java і Bedrock для казуальних будівельників і спільнот.
2056.78
Rooted RealmWhitelisted Java survival SMP: нема запланованих вайпів, економіка гравців, щотижневі події та опційний PvP. Дружня доросла спільнота.
555.47
Minecart Rapid TransitСервер, орієнтований на спільноту, для будівництва міст і транспорту, з поїздами, на яких можна їздити, великими транспортними мережами, захищеними будівлями, економікою, якою керують гравці, та організованими PvP-аренами.
355
All the Mods 10 To The Sky254.68
SmithtainmentСпільнотний survival‑SMP з кастомними плагінами, економікою, mcMMO та міні‑іграми — дружня спільнота й активний форум.
454.19
MinetownГолландський Minetopia‑стиль survival‑сервер з економікою, кастомними плагінами та дружньою спільнотою — почни пригоду вже зараз!
454.19
AetherCraftНапівкастомний Survival SMP із захистом територій, економікою, що керується гравцями, кастомними предметами та мобами, кількома світами та підтримкою кросплею Bedrock/Java.
353.49
AntyMCПольський сервер Lifesteal у стилі Anarchy, зосереджений на PvP та виживанні — має кастомні предмети, клани, аукціони гравців і внутрішньоігрову економіку для змагальної гри з високими ставками.
253.43
minecity.pl353.42- LinkCraft
Ком’юніті‑сервер Minecraft з акцентом на ранкапах, паркур‑курсах, лабіринтах і викликах — легкі міні‑ігри та прогресія.
1653.38 
FragPixelБагаторежимна Java-мережа з Survival, SkyBlock, BedWars і Duels, із внутрішньосерверною економікою, крамницями гравців, аукціонами та захистом захоплених земель.
352.74
TGG OnlineКорейський сервер Minecraft у стилі FPS, що пропонує zombie survival і мініігри bomb/escape, із великою кількістю кастомної зброї, кастомних моделей та досвідом на базі resource pack.
1152.63
GenuineMCСпільнотно орієнтований semi-vanilla survival SMP із захистом земель, крамницями гравців, нагородами за голосування, косметикою та, ймовірно, кросплеєм між Bedrock і Java.
152.6
ArdakazMCПривітний survival‑сервер з фокусом на спільноту: будівництво, захист від гриферства, довготривалі світи.
552.5
BendingMCВиживання з фокусом на Towny: кастомні предмети, Jobs, mcMMO та події — будуй міста й захищай землі.
352.44
Сторінка плагіна PlaceholderAPI показує, на яких серверах моніторинг знайшов цей плагін, з якими платформами та версіями він зустрічається.
Плагіни можуть додавати команди, економіку, захист, права доступу, міні-ігри, інтеграції або інші механіки. Фактична роль PlaceholderAPI залежить від конфігурації конкретного сервера.
Дані формуються автоматично з технічних відповідей серверів. Якщо сервер приховує список плагінів, він може не відображатися в цьому розділі, навіть якщо використовує PlaceholderAPI.
Використовуйте список серверів з PlaceholderAPI, щоб порівняти проєкти, перевірити сумісні версії або знайти приклади використання плагіна на публічних серверах.