Minecraft plugin PlaceholderAPI
Informace o PlaceholderAPI a serverech, kde byl nalezen
🔌 O PlaceholderAPI
PlaceholderAPI je Minecraft plugin, který poskytuje centralizovaný systém placeholderů a ekosystém rozšíření (eCloud). Umožňuje ostatním pluginům číst a nahrazovat tisíce dynamických placeholderů (data hráče, hodnoty ekonomiky, hodnoty specifické pro plugin atd.) bez přímé integrace nebo těsných závislostí.
🎯 Účel
Tento plugin řeší složitosti integrace mezi pluginy tím, že poskytuje jedno rozšiřitelné API pro placeholdery. Autoři pluginů vydávají "rozšíření", která poskytují pojmenované placeholdery; správci serveru tato rozšíření instalují, aby pluginy zobrazující data na serveru (scoreboardy, chat, hologramy, GUI) mohly zobrazovat živá data pomocí jednotné syntaxe.
⚙️ Funkce
- Základní API pro parsování placeholderů, na které se mohou ostatní pluginy napojit.
- Systém rozšíření: samostatně balená rozšíření nebo rozšíření přibalená přímo v pluginech.
- eCloud (cloud rozšíření) pro vyhledávání a stahování ověřených rozšíření přímo ve hře.
- Správcovské příkazy za běhu pro výpis, registraci, odregistraci a znovunačtení rozšíření.
- Debug/parse příkazy pro vyhodnocení placeholderů pro hráče nebo pro vysílání výsledků, užitečné při odstraňování problémů.
- Nástroje jako příkaz dump pro sdílení nainstalovaných rozšíření a stavu pluginu při žádosti o podporu.
🧩 Pro koho je určen
- Správci serverů, kteří potřebují jednotný dynamický text napříč více pluginy (scoreboardy, tablisty, hologramy, GUI).
- Vývojáři pluginů, kteří chtějí poskytovat nebo používat placeholdery bez vynucování těsných závislostí.
- Survival, minihry a network servery, které kombinují mnoho pluginů a potřebují konzistentní syntaxi placeholderů.
🏗️ Příklady použití
- Server nainstaluje rozšíření Vault, takže ekonomické placeholdery, jako je zůstatek hráče, lze používat v pluginu pro scoreboard i chat.
- Správce stáhne z eCloud rozšíření pro konkrétní plugin, aby hologram plugin mohl zobrazovat živá data o cílech.
- Vývojář zpřístupní data pluginu přes PlaceholderExpansion, aby je jiné servery mohly zobrazit bez přímé závislosti na pluginu.
⌨️ Příkazy
| Příkaz | Popis | Oprávnění | Přístup |
|---|---|---|---|
| `/papi parse <player | me> | Parsuje placeholdery v řetězci a zobrazuje výsledek pro ladění. | neuvedeno |
| `/papi bcparse <player | me> | Parsuje placeholdery a vysílá výsledek všem hráčům. | neuvedeno |
| `/papi cmdparse <player | me> | Parsuje placeholdery a spustí výsledný příkaz. | neuvedeno |
/papi parserel <player1> <player2> <text> | Parsuje relační placeholdery porovnáním dvou hráčů. | neuvedeno | Admin |
/papi list | Zobrazí aktivní/registrovaná rozšíření. | neuvedeno | Admin |
/papi info <expansion> | Zobrazí informace o registrovaném rozšíření. | neuvedeno | Admin |
/papi register <filename> | Zaregistruje jar rozšíření ze složky expansions bez restartu. | neuvedeno | Admin |
/papi unregister <filename> | Zruší registraci/odstraní registrované rozšíření. | neuvedeno | Admin |
/papi reload | Znovu načte konfiguraci PlaceholderAPI a zaregistruje nově stažená rozšíření. | neuvedeno | Admin |
/papi version | Zobrazí verzi pluginu a autory. | neuvedeno | Admin |
/papi dump | Vypíše informace o pluginu/verzi/rozšířeních pro podporu (paste služba). | neuvedeno | Admin |
/papi ecloud download <expansion> [version] | Stáhne ověřené rozšíření z eCloud na server. | neuvedeno | Admin |
| `/papi ecloud list [all | installed]` | Zobrazí rozšíření dostupná na eCloud nebo nainstalovaná rozšíření. | |
/papi ecloud placeholders <expansion> | Zobrazí placeholdery poskytované rozšířením z eCloud. | neuvedeno | Admin |
/papi ecloud status | Zobrazí připojení/stav služby eCloud. | neuvedeno | Admin |
(Poznámka: výše uvedené příkazy jsou zdokumentovány v oficiální referenci příkazů PlaceholderAPI. Permission nody pro jednotlivé příkazy nejsou v uvedené dokumentaci vypsány.)
⚙️ Instalace
📥 Nastavení
- Stáhněte oficiální jar PlaceholderAPI a vložte jej do adresáře
plugins/na serveru. - Spusťte nebo restartujte server a v konzoli ověřte, že se PlaceholderAPI načítá.
- Instalujte rozšíření buď vložením jarů rozšíření do
plugins/PlaceholderAPI/expansions/, nebo pomocí herních eCloud příkazů (pro ověřená rozšíření).
📦 Závislosti
- PlaceholderAPI sám o sobě nevyžaduje žádnou obecnou závislost na pluginu, aby fungoval. Některé placeholdery poskytované rozšířeními spoléhají na jiné pluginy (například rozšíření zobrazující ekonomické hodnoty bude vyžadovat odpovídající ekonomický plugin). Tyto požadavky závisí na konkrétním rozšíření.
🧠 Technické poznámky
- PlaceholderAPI je určen pro servery založené na Spigotu a běžně se používá i na Paperu. Poskytuje API, díky kterému mohou vývojáři pluginů registrovat PlaceholderExpansions.
- Rozšíření lze distribuovat jako samostatné jar soubory nebo je přibalit do jiných pluginů; samostatná rozšíření se obvykle instalují do
plugins/PlaceholderAPI/expansions/. - Funkce eCloud umožňuje vyhledávání a stahování ověřených rozšíření přímo ve hře; servery musí povolit odchozí HTTPS, aby stahování z eCloud fungovalo.
- Plugin obsahuje debug a parsing příkazy, které pomáhají správcům ověřit, že se placeholdery vyhodnocují správně.
🤝 Kdy je tento plugin užitečný
Pokud váš server používá více pluginů, které potřebují zobrazovat dynamická data napříč pluginy (chat, tab, hologramy, scoreboardy nebo GUI), je PlaceholderAPI užitečný, protože centralizuje vyhodnocování placeholderů a umožňuje přidávat podporu dalších pluginů pomocí modulárních rozšíření bez úprav každého spotřebitelského pluginu.
- Herocraft Online
RPG síť s mnoha třídami, townshippy, dungeony a ekonomikou — pro hráče, kteří mají rádi survival s RP a PvP.
2555.77 - Eclipse Roleplay1555.45
- LinkCraft
Komunitní Minecraft server zaměřený na rankupy, parkour tratě, bludiště a výzvy — nenáročné mini‑hry a postup.
1354.86 - Restarting...2053.78
- A Minecraft Server851.71
- Rooted Realm
Whitelistovaný Java Survival SMP: bez plánovaných wipeů, ekonomika řízená hráči, týdenní akce a volitelné PvP. Přátelská dospělá komunita.
651.36 - Smithtainment
Komunitně orientované survival SMP s vlastním pluginovým balíčkem, ekonomikou, mcMMO a mini‑hrami — přátelští hráči a aktivní fórum.
1051.05 - DaemoniaCraft
Towny RPG survival s vlastnÍmi moby, ekonomikou a podporou Bedrock — hluboká progresie pro grind‑hráče.
550.89 - GenuineMC
Komunitně zaměřené semi-vanilla survival SMP s ochranou pozemků, obchody hráčů, odměnami za hlasování, kosmetikou a pravděpodobně crossplayem mezi Bedrockem a Javou.
349.99 - GospelCraft
Křesťanské Towny survival s vlastními moby, mcMMO a Jobs — Písmo představováno hrou.
1449.71 - Netherlite is loading...249.66
- Froggie
Přátelský survival SMP nabízející chráněné claimy, ekonomiku s obchody hráčů a aukcemi, podporu více verzí a cross-play Java–Bedrock pro příležitostné stavitele a komunity.
149.29 - LilBoxPvP
Server zaměřený na BoxPvP s rychlými souboji v aréně, duely a sezónním postupem. Nabízí vlastní předměty, nabídky ovládané NPC a pravděpodobně crossplay mezi Java a Bedrock.
348.41 - Minecart Rapid Transit
Server zaměřený na komunitu, stavbu měst a dopravu, s jezdícími vlaky, rozsáhlými dopravními sítěmi, chráněnými stavbami, ekonomikou řízenou hráči a organizovanými PvP arénami.
548.23 - A Minecraft Server148.21
- TGG Online
Korejský Minecraft server ve stylu FPS nabízející zombie survival a minihry bomb/escape, s bohatou nabídkou vlastních zbraní, vlastních modelů a zážitkem postaveným na resource packu.
247.11 - MoodCraft
Francouzské survival SMP v semi-RP stylu zaměřené na města spravovaná hráči, ekonomiku a městské projekty — přátelský postup s průvodci ve hře, obchody, pracemi a bezpečnou ochranou truhel. Podporuje Java i Bedrock.
247.02 - Racsu Planet
Cross-play Survival MMORPG (Java + Bedrock) s dovednostmi, úkoly, vlastními dungeony a herní ekonomikou, podporované oficiálním obchodem a komunitním hubem.
346.73 - AnarchyLands CZ/SK144.43
Stránka pluginu PlaceholderAPI ukazuje, na kterých serverech monitoring tento plugin našel a s jakými platformami a verzemi se objevuje.
Pluginy mohou přidávat příkazy, ekonomiku, ochranu, oprávnění, minihry, integrace nebo jiné mechaniky. Skutečná role PlaceholderAPI závisí na konfiguraci konkrétního serveru.
Data se generují automaticky z technických odpovědí serverů. Pokud server skrývá seznam pluginů, nemusí se v této sekci zobrazit, i když PlaceholderAPI používá.
Použijte seznam serverů s PlaceholderAPI k porovnání projektů, kontrole kompatibilních verzí nebo nalezení příkladů použití pluginu na veřejných serverech.