PlaceholderAPI

PlaceholderAPI (PAPI) řeší jednu opakující se věc: jak dostat živá data do textu. Místo aby si každý plugin vedl vlastní systém, používá se jednotná značka v procentech — placeholder. Například %player_name% se vypíše jako jméno hráče, %vault_eco_balance% jako jeho zůstatek a %server_online% jako počet hráčů na serveru.

Značky nepocházejí z jednoho zdroje: PAPI má takzvaná rozšíření. Každé přidává vlastní sadu — jedno pro údaje o hráči (Player), jedno pro ekonomiku (Vault), jedno pro server (Server) a stovky dalších. Rozšíření se stahují příkazem /papi ecloud download <název> a PAPI si je drží.

Bez rozšíření se značka nevyplní a v textu zůstane vidět jako obyčejný text. To je nejčastější chyba: majitel zapomene rozšíření nainstalovat a diví se, proč se v tabulce ukazuje %vault_eco_balance% místo částky.

Rozšíření používá každý plugin, který PAPI podporuje: DeluxeMenus (menu), TAB (tabulka a jméno nad hlavou), hologramy, chat i odměny za hlas. Proto se PAPI instaluje skoro vždy, i když samo o sobě nic vidět nedělá.

Když chceš zjistit, co která značka vypíše, použij /papi parse me <text se značkou>. PAPI ji vyplní a ukáže výsledek — například /papi parse me Jsem %player_name% a mám %vault_eco_balance%.

1. Stáhni PlaceholderAPI z modrinth.com/plugin/placeholderapi nebo z dev.bukkit.org — verzi pro svou verzi serveru.
2. Nahraj .jar do složky plugins.
3. Restartuj server. V konzoli se objeví řádek s verzí PAPI a počtem načtených rozšíření.
4. Napiš /papi list — vypíše nainstalovaná rozšíření. Na čistém serveru jich bude jen několik.
5. Doplň, co potřebuješ: /papi ecloud download Player (údaje o hráči), /papi ecloud download Vault (peníze), /papi ecloud download Server (stav serveru).
6. Po každém stažení napiš /papi reload — tím se rozšíření načte.
7. Ověř značku: /papi parse me %player_name% musí vypsat tvoje jméno, ne text se značkou.
8. Až značky fungují, použij je tam, kde je chceš vidět — v TABu, v menu, v hologramu nebo v chatu (u chatu potřebuješ plugin, který PAPI podporuje).
9. Když značka nefunguje ani po přidání rozšíření, ověř v dokumentaci pluginu, že ji opravdu podporuje. Některé pluginy mají vlastní značky.
10. Rozšíření aktualizuj příkazem /papi ecloud refresh a pak /papi reload.

Když se v textu zobrazuje %player_name% místo jména, chybí rozšíření Player nebo se po jeho stažení nespustil /papi reload. Nejdřív zkontroluj /papi list, teprve pak hledej chybu v pluginu, který značku používá.
Značky jsou citlivé na velikost písmen a přesný název. %player_name% funguje, %Player_Name% ne — název si vždy opiš z /papi info <rozšíření>.
Rozšíření se nenačte přes /reload. Vždy /papi ecloud download <název> a pak /papi reload.
Některé značky závisí na jiných pluginech: %vault_eco_balance% potřebuje Vault i ekonomiku, %luckperms_prefix% potřebuje LuckPerms. Bez nich zůstane značka prázdná — a to není chyba PAPI.
Každé vyplnění značky je malý dotaz. V tabulce, která se obnovuje každou vteřinu, jich nedávej desítky — server to pozná na výkonu.
Rozšíření se ukládají do plugins/PlaceholderAPI/expansions. Když je zálohuješ, přeneseš si je i na jiný server.