PlaceholderAPI

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 powinieneś 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).

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.

1. Pobierz PlaceholderAPI z oficjalnej strony. Upewnij się, ze pobierasz wersje kompatybilna z Twoja wersja Minecraft (1.8.8 - 1.21.x).
2. Skopiuj pobrany plik .jar do folderu plugins/ w katalogu Twojego serwera.
3. Zrestartuj serwer komenda /stop i uruchom go ponownie. Nie używaj /reload przy pierwszej instalacji.
4. 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.
5. 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.

Często zadawane pytania o PlaceholderAPI

Inne pluginy z kategorii API i biblioteki