PlaceholderAPI
System dynamicznych zmiennych (placeholderow) używanych przez tablice wyników, chat, hologramy, TAB, scoreboard i dziesiątki pluginow.
O pluginie PlaceholderAPI
PlaceholderAPI (w skrócie 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 się 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 odczytywać cudze. Dzięki temu plugin tablicy wyników 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 pluginów API, który powinienes rozważyć 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 skonfigurować w pliku konfiguracyjnym pluginu.
- Ujednolicony system zmiennych
- eCloud z setkami rozszerzeń
- Obsługa przez dziesiątki pluginów
- Parsowanie w czasie rzeczywistym
- JavaScript placeholdery
Komendy PlaceholderAPI
PlaceholderAPI rejestruje 5 komend (pokazujemy najważniejsze). Pelna lista dostępna jest w oficjalnej dokumentacji. Pamiętaj, ze każda komendę możesz zablokować lub odlokowac przez system uprawnień (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 | Przeładowuje plugin | placeholderapi.reload |
/papi info [expansion] | Informacje o rozszerzeniu | placeholderapi.info |
Uprawnienia (permissions)
System uprawnień pozwala kontrolować, kto może używać poszczególnych funkcji PlaceholderAPI. Uprawnienia nadajesz przez plugin rang, np. LuckPerms (/lp group [grupa] permission set [node] true). Kolumna "Domyślnie 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 ustawień 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 użyj komendy przeładowania pluginu (np. /reload lub dedykowanej komendy pluginu). Jeśli plugin nie pobiera zmian po przeładowaniu, zrestartuj serwer komenda /stop.
Jak zainstalować PlaceholderAPI
Pobierz PlaceholderAPI ze SpigotMC. Wrzuć .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 się, 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 używaj/reloadprzy pierwszej instalacji. - Sprawdź konsole serwera. Jeśli PlaceholderAPI załadował się poprawnie, zobaczysz komunikat z wersja pluginu. Jeśli pojawił się błąd, sprawdź czy masz zainstalowane wszystkie zaleznosciow.
-
Skonfiguruj plugin edytujac plik
plugins/PlaceholderAPI/config.yml(lub odpowiednik). Po zmianach użyj komendy przeladowania.
Alternatywy dla PlaceholderAPI
PlaceholderAPI nie jest jedynym pluginem w swojej kategorii. Poniżej znajdziesz alternatywy, które warto rozważyć, jeśli szukasz czegoś innego lub PlaceholderAPI nie spełnia Twoich oczekiwan.
MVdWPlaceholderAPI
Alternatywne API placeholderow od MVdW. Kompatybilne z jego pluginami.
Często zadawane pytania o PlaceholderAPI
Jak zainstalować PlaceholderAPI?
Pobierz PlaceholderAPI ze SpigotMC. Wrzuć .jar do plugins/, zrestartuj. Potem pobierz rozszerzenia komenda /papi ecloud download [nazwa]. Popularne rozszerzenia: Player, Vault, Server, Statistic, Math. Szczegolowa instrukcja z zależnościami i konfiguracja znajduje się w sekcji instalacja powyżej.
Na jakich silnikach serwerowych działa PlaceholderAPI?
PlaceholderAPI działa na: Spigot, Paper, Purpur. Rekomendujemy Paper jako silnik - większości serwerów daje najlepsza równowagę miedzy wydajnością a kompatybilnością z pluginami. Więcej o silnikach serwerowych przeczytasz w naszym porównaniu.
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 robić?
Sprawdź plik logs/latest.log w katalogu serwera. Najczęstsze 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 mogę 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