PlaceholderAPI — plugin pro vkládání dynamických dat do Minecraftu
PlaceholderAPI (PAPI) nahrazuje v textu placeholdery dynamickými hodnotami, jako je jméno hráče nebo zůstatek. Přehled příkazů, rozšíření a…
PlaceholderAPI (PAPI) nahrazuje v textu placeholdery dynamickými hodnotami, jako je jméno hráče nebo zůstatek. Přehled příkazů, rozšíření a nastavení.
PlaceholderAPI — plugin pro vkládání dynamických dat do Minecraftu
Verze Minecraftu, na které byl článek otestován a napsán: 26.1.2
Rozsah podporovaných verzí: 1.8.x – 26.1.x
PlaceholderAPI (zkráceně PAPI) je serverový plugin pro Minecraft, který do textu dosazuje dynamické hodnoty místo speciálních značek. Sám o sobě nic nevypisuje: jde o engine, který v řetězci hledá značku ve tvaru %player_name% a nahrazuje ji aktuální hodnotou — jménem hráče, zůstatkem, hodností, počtem hráčů online. Samotná data dodávají jednotlivé moduly — rozšíření, zatímco PAPI provádí pouze samotné nahrazení. Díky tomu pluginy pro chat, scoreboard, tab-list i menu čtou hodnoty ve stejném formátu, bez vlastní syntaxe.
Formát placeholderů
Placeholder se zapisuje mezi dvě procenta: %<розширення>_<параметр>%. První část před podtržítkem je název rozšíření, dále následuje konkrétní parametr. Například %player_name% vrací jméno hráče a %server_online% počet hráčů online.
Nahrazení funguje pouze tam, kde ho vyvolá samotný přijímající plugin. Pokud plugin PAPI nepodporuje, značky v jeho zprávách zůstanou obyčejným textem. Jednotlivý placeholder lze ověřit příkazem pro rozbor:
/papi parse me %player_name%
Pokud se v odpovědi vrátí samotný text značky, a ne hodnota, chybí potřebné rozšíření, nebo je zdrojový plugin vypnutý.
Rozšíření a eCloud
PlaceholderAPI sám o sobě neobsahuje žádný placeholder — všechny pocházejí z rozšíření. Některá jsou zabudovaná přímo do zdrojového pluginu a registrují se sama při startu serveru; jiná existují jako samostatné jar soubory v cloudu rozšíření (eCloud) a instalují se do adresáře /plugins/PlaceholderAPI/expansions/.
Potřebné rozšíření lze stáhnout přímo ze hry:
/papi ecloud download <розширення>
/papi reload
Přes příkaz se stahují pouze ověřená rozšíření — to chrání před škodlivým kódem. Neověřená rozšíření se instalují ručně: jar soubor se stáhne z webu a vloží do složky s rozšířeními.
Přístup k eCloudu: pokud hosting nebo firewall blokuje externí připojení, stahování přes příkaz nebude fungovat — rozšíření pak bude nutné přidat ručně.
Příkazy
Všechny příkazy začínají na /papi. Ve výchozím nastavení jsou dostupné pouze operátorům; jednotlivá oprávnění se udělují přes uzly placeholderapi.*.
Příkaz | Účel |
| Rozebrat placeholdery v textu pro hráče |
| Rozebrat relační placeholdery pro dva hráče |
| Zobrazit aktivní rozšíření |
| Informace o konkrétním rozšíření |
| Stáhnout rozšíření z cloudu |
| Seznam placeholderů rozšíření |
| Znovu načíst plugin a konfiguraci |
| Verze nainstalovaného pluginu |
Konfigurace
V souboru config.yml má smysl upravovat jen několik parametrů:
Parametr | Co dělá |
| Připojení k eCloudu. |
| Text logických hodnot placeholderů; lze nahradit například za ano / ne |
| Formát data a času pro odpovídající placeholdery |
| Kontrola aktualizací pluginu při startu a upozornění operátorů |
Zbylé hodnoty v souboru jsou servisní (ochrana rozšíření, režim nahrazování v komponentách Adventure, ladění) a ve výchozím stavu se nemění.
Závěr
PlaceholderAPI dává jednotný formát pro dosazování dat, kterému rozumí stovky pluginů: místo samostatné integrace pro každý plugin stačí jeden řádek s placeholderem. Potřebují ho správci Minecraft serverů s chatem, tab-listem, scoreboardem nebo menu založeným na dynamických datech; pro hru v jednom hráči využití nemá.
Instalace
Typická instalace trvá asi 5 minut. Postup je stejný; liší se jen loader a odpovídající verze.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.
