PlaceholderAPI
System dynamicznych zmiennych (placeholderow) używanych przez tablice wynikow, chat, hologramy, TAB, scoreboard i dziesiatki pluginow.
O pluginie PlaceholderAPI
PlaceholderAPI (w skrocie PAPI) to system zmiennych dynamicznych, który umożliwia pluginom wyświetlanie danych o graczach, serwerze i świecie w czasie rzeczywistym. Placeholder to tekst w formacie %nazwa_zmienna%, który zostaje automatycznie zamieniony na wartość, 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, pozwalając innym pluginom rejestrować swoje placeholdery i odczytywac cudze. Dzięki temu plugin tablicy wynikow może wyświetlić 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, który powinienes rozwazyc na swoim serwerze Minecraft. Wspiera wersje 1.8.8 - 1.21.x i działa na Spigot, Paper, Purpur.
Funkcje PlaceholderAPI
Poniżej lista głównych funkcji, które PlaceholderAPI dodaje do Twojego serwera. Każda z nich można skonfigurowac w pliku konfiguracyjnym pluginu.
- Ujednolicony system zmiennych
- eCloud z setkami rozszerzeń
- Obsługa przez dziesiatki pluginow
- Parsowanie w czasie rzeczywistym
- JavaScript placeholdery
Komendy PlaceholderAPI
PlaceholderAPI rejestruje 5 komend (pokazujemy najważniejsze). Pelna lista dostepna jest w oficjalnej dokumentacji. Pamietaj, ze każda komende możesz 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 dostępnych rozszerzeń | placeholderapi.ecloud |
/papi reload | Przeladowuje plugin | placeholderapi.reload |
/papi info [expansion] | Informacje o rozszerzeniu | placeholderapi.info |
Uprawnienia (permissions)
System uprawnien pozwala kontrolowac, kto może używać 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/. Poniżej najważniejsze opcje z komentarzami. Pełna 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). Jeśli 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. - Sprawdź konsole serwera. Jeśli PlaceholderAPI zaladowal sie poprawnie, zobaczysz komunikat z wersja pluginu. Jeśli pojawił sie błąd, sprawdź 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. Poniżej znajdziesz alternatywy, które warto rozwazyc, jeśli szukasz czegos innego lub PlaceholderAPI nie spelnia Twoich oczekiwan.
MVdWPlaceholderAPI
Alternatywne API placeholderow od MVdW. Kompatybilne z jego pluginami.
Często 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 powyżej.
Na jakich silnikach serwerowych działa PlaceholderAPI?
PlaceholderAPI działa na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik — wiekszosci serwerow daje najlepsza rownowage miedzy wydajnoscia a kompatybilnoscia z pluginami. Więcej o silnikach serwerowych przeczytasz w naszym porownaniu.
Czy PlaceholderAPI jest darmowy?
Tak, PlaceholderAPI jest darmowy i dostępny na SpigotMC. Kod źródłowy jest otwarty na GitHub.
PlaceholderAPI nie działa — co robic?
Sprawdź plik logs/latest.log w katalogu serwera. Najczestsze przyczyny błędów: (1) brakujaca zależność, (2) niekompatybilna wersja Minecraft (sprawdź czy masz 1.8.8 - 1.21.x), (3) błąd w pliku config.yml (sprawdź format YAML), (4) konflikt z innym pluginem o tej samej funkcji.
Czy moge używać PlaceholderAPI na serwerze Bedrock?
Nie. PlaceholderAPI to plugin Java Edition i działa na serwerach Spigot/Paper/Purpur. Bedrock Edition używa innego systemu (behavior packs). Jeśli chcesz łączyć graczy Java i Bedrock na jednym serwerze, sprawdź Geyser.
Komentarze