PlaceholderAPI
System dynamicznych zmiennych (placeholderow) uzywanych przez tablice wynikow, chat, hologramy, TAB, scoreboard i dziesiatki pluginow.
O pluginie PlaceholderAPI
PlaceholderAPI (w skrocie PAPI) to system zmiennych dynamicznych, ktory umozliwia pluginom wyswietlanie danych o graczach, serwerze i swiecie w czasie rzeczywistym. Placeholder to tekst w formacie %nazwa_zmienna%, ktory zostaje automatycznie zamieniony na wartosc, np. %player_name% zamienia sie na nick gracza, %vault_eco_balance% na saldo konta, a %server_tps% na TPS serwera. PlaceholderAPI nie dostarcza tych zmiennych sam z siebie.
Zamiast tego ujednolica system, pozwalajac innym pluginom rejestrować swoje placeholdery i odczytywac cudze. Dzieki temu plugin tablicy wynikow moze wyswietlic saldo z EssentialsX, range z LuckPerms i statystyki z mcMMO, wszystko przez jeden API. Dodatkowe rozszerzenia (expansions) pobierasz komenda /papi ecloud download [nazwa], np. /papi ecloud download Player.
PlaceholderAPI to jeden z fundamentalnych pluginow API, ktory powinienes rozwazyc na swoim serwerze Minecraft. Wspiera wersje 1.8.8 - 1.21.x i dziala na Spigot, Paper, Purpur.
Funkcje PlaceholderAPI
Ponizej lista glownych funkcji, ktore PlaceholderAPI dodaje do Twojego serwera. Kazda z nich mozna skonfigurowac w pliku konfiguracyjnym pluginu.
- Ujednolicony system zmiennych
- eCloud z setkami rozszerzen
- Obsluga przez dziesiatki pluginow
- Parsowanie w czasie rzeczywistym
- JavaScript placeholdery
Komendy PlaceholderAPI
PlaceholderAPI rejestruje 5 komend (pokazujemy najwazniejsze). Pelna lista dostepna jest w oficjalnej dokumentacji. Pamietaj, ze kazda komende mozesz zablokowac lub odlokowac przez system uprawnien (np. LuckPerms).
| Komenda | Opis | Uprawnienie |
|---|---|---|
/papi parse [gracz] [tekst] | Parsuje placeholder dla gracza | placeholderapi.parse |
/papi ecloud download [expansion] | Pobiera rozszerzenie z eCloud | placeholderapi.ecloud |
/papi ecloud list | Lista dostepnych rozszerzen | placeholderapi.ecloud |
/papi reload | Przeladowuje plugin | placeholderapi.reload |
/papi info [expansion] | Informacje o rozszerzeniu | placeholderapi.info |
Uprawnienia (permissions)
System uprawnien pozwala kontrolowac, kto moze uzywac poszczegolnych funkcji PlaceholderAPI. Uprawnienia nadajesz przez plugin rang, np. LuckPerms (/lp group [grupa] permission set [node] true). Kolumna "Domyslnie OP" oznacza, czy operatorzy serwera maja to uprawnienie bez konfiguracji.
Konfiguracja PlaceholderAPI
Po pierwszym uruchomieniu PlaceholderAPI wygeneruje plik konfiguracyjny w folderze plugins/PlaceholderAPI/. Ponizej najwazniejsze opcje z komentarzami. Pelna lista ustawien jest w oficjalnej dokumentacji.
# config.yml PlaceholderAPI
check_updates: true
cloud_enabled: true
# Popularne placeholdery:
# %player_name% - nick gracza
# %player_health% - HP gracza
# %vault_eco_balance% - saldo (wymaga Vault)
# %server_online% - liczba graczy online
# %server_tps% - TPS serwera
Po zmianie konfiguracji zapisz plik i uzyj komendy przeladowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jesli plugin nie pobiera zmian po przeladowaniu, zrestartuj serwer komenda /stop.
Jak zainstalowac PlaceholderAPI
Pobierz PlaceholderAPI ze SpigotMC. Wrzuc .jar do plugins/, zrestartuj. Potem pobierz rozszerzenia komenda /papi ecloud download [nazwa]. Popularne rozszerzenia: Player, Vault, Server, Statistic, Math.
- Pobierz PlaceholderAPI z oficjalnej strony. Upewnij sie, ze pobierasz wersje kompatybilna z Twoja wersja Minecraft (1.8.8 - 1.21.x).
-
Skopiuj pobrany plik
.jardo folderuplugins/w katalogu Twojego serwera. -
Zrestartuj serwer komenda
/stopi uruchom go ponownie. Nie uzywaj/reloadprzy pierwszej instalacji. - Sprawdz konsole serwera. Jesli PlaceholderAPI zaladowal sie poprawnie, zobaczysz komunikat z wersja pluginu. Jesli pojawil sie blad, sprawdz czy masz zainstalowane wszystkie zaleznosciow.
-
Skonfiguruj plugin edytujac plik
plugins/PlaceholderAPI/config.yml(lub odpowiednik). Po zmianach uzyj komendy przeladowania.
Alternatywy dla PlaceholderAPI
PlaceholderAPI nie jest jedynym pluginem w swojej kategorii. Ponizej znajdziesz alternatywy, ktore warto rozwazyc, jesli szukasz czegos innego lub PlaceholderAPI nie spelnia Twoich oczekiwan.
MVdWPlaceholderAPI
Alternatywne API placeholderow od MVdW. Kompatybilne z jego pluginami.
Czesto zadawane pytania o PlaceholderAPI
Jak zainstalowac PlaceholderAPI?
Pobierz PlaceholderAPI ze SpigotMC. Wrzuc .jar do plugins/, zrestartuj. Potem pobierz rozszerzenia komenda /papi ecloud download [nazwa]. Popularne rozszerzenia: Player, Vault, Server, Statistic, Math. Szczegolowa instrukcja z zaleznosciami i konfiguracja znajduje sie w sekcji instalacja powyzej.
Na jakich silnikach serwerowych dziala PlaceholderAPI?
PlaceholderAPI dziala na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik — wiekszosci serwerow daje najlepsza rownowage miedzy wydajnoscia a kompatybilnoscia z pluginami. Wiecej o silnikach serwerowych przeczytasz w naszym porownaniu.
Czy PlaceholderAPI jest darmowy?
Tak, PlaceholderAPI jest darmowy i dostepny na SpigotMC. Kod zrodlowy jest otwarty na GitHub.
PlaceholderAPI nie dziala — co robic?
Sprawdz plik logs/latest.log w katalogu serwera. Najczestsze przyczyny bledow: (1) brakujaca zaleznosc, (2) niekompatybilna wersja Minecraft (sprawdz czy masz 1.8.8 - 1.21.x), (3) blad w pliku config.yml (sprawdz format YAML), (4) konflikt z innym pluginem o tej samej funkcji.
Czy moge uzywac PlaceholderAPI na serwerze Bedrock?
Nie. PlaceholderAPI to plugin Java Edition i dziala na serwerach Spigot/Paper/Purpur. Bedrock Edition uzywa innego systemu (behavior packs). Jesli chcesz laczyc graczy Java i Bedrock na jednym serwerze, sprawdz Geyser.
Komentarze