Плагін 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'ів і дає змогу додавати підтримку інших плагінів через модульні розширення без зміни кожного плагіна-споживача.
Herocraft OnlineRPG‑мережа з багатьма класами, тауншипами, підземеллями та економікою — для фанатів рольового виживання і PvP.
2555.77
Eclipse Roleplay1655.5
LinkCraftКом’юніті‑сервер Minecraft з акцентом на ранкапах, паркур‑курсах, лабіринтах і викликах — легкі міні‑ігри та прогресія.
1354.76
Restarting...1653.79
Rooted RealmWhitelisted Java survival SMP: нема запланованих вайпів, економіка гравців, щотижневі події та опційний PvP. Дружня доросла спільнота.
851.72
A Minecraft Server851.71
SmithtainmentСпільнотний survival‑SMP з кастомними плагінами, економікою, mcMMO та міні‑іграми — дружня спільнота й активний форум.
951.13
DaemoniaCraftTowny‑орієнтований RPG Survival із кастомними мобами, економікою та підтримкою Bedrock — для любителів прогресії й гринду.
450.62
GenuineMCСпільнотно орієнтований semi-vanilla survival SMP із захистом земель, крамницями гравців, нагородами за голосування, косметикою та, ймовірно, кросплеєм між Bedrock і Java.
350.03
GospelCraftХристиянський Towny‑survival з кастомними мобами, mcMMO і Jobs — Писання знайомлять через ігровий процес.
1049.57
Minecart Rapid TransitСервер, орієнтований на спільноту, для будівництва міст і транспорту, з поїздами, на яких можна їздити, великими транспортними мережами, захищеними будівлями, економікою, якою керують гравці, та організованими PvP-аренами.
1149.3
FroggieПривітний survival SMP із захищеними клеймами, економікою з магазинами гравців і аукціонами, підтримкою кількох версій та cross-play між Java і Bedrock для казуальних будівельників і спільнот.
149.29
Netherlite is loading...148.78- LilBoxPvP
Сервер, орієнтований на BoxPvP, зі швидкими боями на арені, дуелями та сезонним прогресом. Пропонує кастомні предмети, меню на базі NPC і, ймовірно, кросплей Java–Bedrock.
348.32 
A Minecraft Server148.2
Racsu PlanetCross-play Survival MMORPG (Java + Bedrock) з навичками, квестами, кастомними підземеллями та внутрішньоігровою економікою, що підтримується офіційним магазином і спільнотним хабом.
447.39
MoodCraftФранцузький survival SMP у стилі напів-RP, зосереджений на містах, якими керують гравці, економіці та міських проєктах — дружній прогрес із внутрішньоігровими гайдами, крамницями, роботами та надійним захистом скринь. Підтримуються Java та Bedrock.
247.22
TGG OnlineКорейський сервер Minecraft у стилі FPS, що пропонує zombie survival і мініігри bomb/escape, із великою кількістю кастомної зброї, кастомних моделей та досвідом на базі resource pack.
044.55
Сторінка плагіна PlaceholderAPI показує, на яких серверах моніторинг знайшов цей плагін, з якими платформами та версіями він зустрічається.
Плагіни можуть додавати команди, економіку, захист, права доступу, міні-ігри, інтеграції або інші механіки. Фактична роль PlaceholderAPI залежить від конфігурації конкретного сервера.
Дані формуються автоматично з технічних відповідей серверів. Якщо сервер приховує список плагінів, він може не відображатися в цьому розділі, навіть якщо використовує PlaceholderAPI.
Використовуйте список серверів з PlaceholderAPI, щоб порівняти проєкти, перевірити сумісні версії або знайти приклади використання плагіна на публічних серверах.