Minecraft plugin PlaceholderAPI

🔌 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

(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.