PlaceholderAPI — plugin do podstawiania dynamicznych danych w Minecraft
PlaceholderAPI (PAPI) pozwala wtyczkom Minecraft wyświetlać dane dynamiczne — imię gracza, saldo, rangę — dzięki prostym znacznikom…
PlaceholderAPI (PAPI) pozwala wtyczkom Minecraft wyświetlać dane dynamiczne — imię gracza, saldo, rangę — dzięki prostym znacznikom %placeholder%.
PlaceholderAPI — plugin do podstawiania dynamicznych danych w Minecraft
Wersja Minecraft, na której przetestowano i napisano artykuł: 26.1.2
Zakres obsługiwanych wersji: 1.8.x – 26.1.x
PlaceholderAPI (w skrócie PAPI) to wtyczka serwerowa do Minecrafta, która podstawia do tekstu dynamiczne wartości zamiast specjalnych znaczników. Sama w sobie niczego nie wyświetla: to silnik, który znajduje w ciągu znak w postaci %player_name% i zamienia go na aktualną wartość — imię gracza, saldo, rangę, liczbę graczy online. Same dane dostarczają osobne moduły — rozszerzenia, a PAPI wykonuje jedynie podstawienie. Dzięki temu wtyczki czatu, tablicy wyników, tab-listy i menu odczytują wartości w jednym formacie, bez własnej składni.
Format placeholderów
Placeholder zapisuje się między dwoma znakami procenta: %<розширення>_<параметр>%. Pierwsza część przed podkreśleniem to nazwa rozszerzenia, dalej — konkretny parametr. Na przykład %player_name% zwraca imię gracza, a %server_online% — liczbę graczy online.
Podstawienie działa tylko tam, gdzie wywołuje je sama wtyczka odbierająca. Jeśli wtyczka nie obsługuje PAPI, znaczniki w jej wiadomościach pozostaną zwykłym tekstem. Pojedynczy placeholder można sprawdzić komendą analizy:
/papi parse me %player_name%
Jeśli w odpowiedzi zwracany jest sam tekst znacznika, a nie wartość — brakuje odpowiedniego rozszerzenia albo wtyczka-źródło jest wyłączona.
Rozszerzenia i eCloud
PlaceholderAPI od razu po instalacji nie zawiera ani jednego placeholdera — wszystkie pochodzą z rozszerzeń. Niektóre są wbudowane w wtyczkę-źródło i rejestrują się same przy starcie serwera; inne leżą jako osobne pliki jar w chmurze rozszerzeń (eCloud) i instaluje się je w katalogu /plugins/PlaceholderAPI/expansions/.
Potrzebne rozszerzenie można pobrać bezpośrednio z gry:
/papi ecloud download <розширення>
/papi reload
Przez komendę pobierane są wyłącznie zweryfikowane rozszerzenia — to zabezpieczenie przed szkodliwym kodem. Niezweryfikowane instaluje się ręcznie: pobiera się plik jar ze strony i umieszcza w katalogu rozszerzeń.
Dostęp do eCloud: jeśli hosting lub firewall blokuje połączenie zewnętrzne, pobieranie przez komendę nie zadziała — rozszerzenie trzeba będzie dodać ręcznie.
Komendy
Wszystkie komendy zaczynają się od /papi. Domyślnie są dostępne tylko dla operatorów; poszczególne uprawnienia nadaje się przez węzły placeholderapi.*.
Komenda | Przeznaczenie |
| Rozłożyć placeholdery w tekście dla gracza |
| Rozłożyć relacyjne placeholdery dla dwóch graczy |
| Pokazać aktywne rozszerzenia |
| Informacje o konkretnym rozszerzeniu |
| Pobrać rozszerzenie z chmury |
| Lista placeholderów rozszerzenia |
| Przeładować wtyczkę i konfigurację |
| Wersja zainstalowanej wtyczki |
Konfiguracja
W pliku config.yml do edycji przydaje się tylko kilka parametrów:
Parametr | Co robi |
| Połączenie z eCloud. |
| Tekst wartości logicznych placeholderów; można zamienić na tak / nie |
| Format daty i czasu dla odpowiednich placeholderów |
| Sprawdzanie aktualizacji wtyczki przy starcie i powiadamianie operatorów |
Pozostałe wartości w pliku są wewnętrzne (ochrona rozszerzeń, tryb podstawiania w komponentach Adventure, debug) i domyślnie się ich nie zmienia.
Podsumowanie
PlaceholderAPI daje jednolity format podstawiania danych, który rozumieją setki wtyczek: zamiast osobnej integracji dla każdej wtyczki wystarczy jedna linijka z placeholderem. Potrzebny administratorom serwerów Minecraft z czatem, tab-listą, tablicą wyników lub menu opartym na danych dynamicznych; do gry jednoosobowej nie ma zastosowania.
Instalacja
Typowa instalacja zajmuje około 5 minut. Procedura jest taka sama; różni się tylko loader i odpowiedni build.
- 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.
