Minecraft Servers HQ

Plugin Minecraft PlaceholderAPI

Informacje o PlaceholderAPI i potwierdzonych serwerach

SpigotPaperAPIAdmin ToolsPermissionsUtilityChatIntegrationDeveloper API

🔌 O PlaceholderAPI

PlaceholderAPI to wtyczka do Minecrafta, która udostępnia scentralizowany system placeholderów oraz ekosystem rozszerzeń (eCloud). Pozwala innym wtyczkom odczytywać i podmieniać tysiące dynamicznych placeholderów (dane gracza, wartości ekonomii, wartości specyficzne dla wtyczek itp.) bez konieczności bezpośredniej integracji lub sztywnych zależności.

🎯 Cel

Wtyczka rozwiązuje problemy z integracją między wtyczkami, udostępniając jedno, rozszerzalne API placeholderów. Autorzy wtyczek publikują rozszerzenia, które dostarczają nazwane placeholdery; administratorzy serwera instalują te rozszerzenia, aby wtyczki skierowane do serwera (scoreboards, chat, hologramy, GUI) mogły wyświetlać dane na żywo za pomocą spójnej składni.

⚙️ Funkcje

  • Główne API parsowania placeholderów, do którego mogą podłączać się inne wtyczki.
  • System rozszerzeń: rozszerzenia pakowane osobno lub dołączone do wtyczek.
  • eCloud (chmura rozszerzeń) do wyszukiwania i pobierania zweryfikowanych rozszerzeń w grze.
  • Polecenia do zarządzania w czasie działania, służące do listowania, rejestrowania, wyrejestrowywania i przeładowywania rozszerzeń.
  • Polecenia debug/parsing do sprawdzania placeholderów dla gracza lub rozgłaszania wyniku, przydatne przy rozwiązywaniu problemów.
  • Narzędzia, takie jak komenda dump, do udostępniania zainstalowanych rozszerzeń i stanu wtyczki podczas kontaktu z pomocą techniczną.

🧩 Dla kogo jest ta wtyczka

  • Administratorzy serwerów, którzy potrzebują ujednoliconego dynamicznego tekstu w wielu wtyczkach (scoreboards, tablists, hologramy, GUI).
  • Twórcy wtyczek, którzy chcą udostępniać lub wykorzystywać placeholdery bez wymuszania sztywnych zależności.
  • Serwery Survival, minigame i sieciowe, które łączą wiele wtyczek i potrzebują spójnej składni placeholderów.

🏗️ Przykładowe zastosowania

  • Serwer instaluje rozszerzenie Vault, aby placeholdery ekonomii, takie jak saldo gracza, mogły być używane we wtyczkach scoreboard i chat.
  • Administrator pobiera z eCloud rozszerzenie specyficzne dla wtyczki, aby wtyczka hologramów mogła wyświetlać dane celu na żywo.
  • Twórca udostępnia dane wtyczki przez PlaceholderExpansion, aby inne serwery mogły wyświetlać te dane bez bezpośredniej zależności od tej wtyczki.

⌨️ Komendy

KomendaOpisUprawnienieDostęp
`/papi parse <playerme> `Parsuje placeholdery w ciągu i pokazuje wynik do debugowania.nie określono
`/papi bcparse <playerme> `Parsuje placeholdery i rozgłasza wynik do wszystkich graczy.nie określono
`/papi cmdparse <playerme> `Parsuje placeholdery i wykonuje wynikową komendę.nie określono
/papi parserel <player1> <player2> <text>Parsuje placeholdery relacyjne, porównując dwóch graczy.nie określonoAdministrator
/papi listWyświetla aktywne/zarejestrowane rozszerzenia.nie określonoAdministrator
/papi info <expansion>Pokazuje informacje o zarejestrowanym rozszerzeniu.nie określonoAdministrator
/papi register <filename>Rejestruje jar rozszerzenia z folderu expansions bez restartu.nie określonoAdministrator
/papi unregister <filename>Wyrejestrowuje/usuwa zarejestrowane rozszerzenie.nie określonoAdministrator
/papi reloadPrzeładowuje konfigurację PlaceholderAPI i rejestruje nowo pobrane rozszerzenia.nie określonoAdministrator
/papi versionPokazuje wersję wtyczki i autorów.nie określonoAdministrator
/papi dumpWyświetla informacje o wtyczce, wersji i rozszerzeniach do pomocy technicznej (usługa paste).nie określonoAdministrator
/papi ecloud download <expansion> [version]Pobiera zweryfikowane rozszerzenie z eCloud na serwer.nie określonoAdministrator
`/papi ecloud list [allinstalled]`Wyświetla rozszerzenia dostępne w eCloud lub zainstalowane rozszerzenia.
/papi ecloud placeholders <expansion>Wyświetla placeholdery dostarczane przez rozszerzenie eCloud.nie określonoAdministrator
/papi ecloud statusPokazuje połączenie/status usługi eCloud.nie określonoAdministrator

(Uwaga: powyższe komendy są opisane w oficjalnej dokumentacji komend PlaceholderAPI. W dokumentacji referencyjnej nie podano węzłów uprawnień dla pojedynczych komend.)

⚙️ Instalacja

📥 Konfiguracja

  • Pobierz oficjalny plik jar PlaceholderAPI i umieść go w katalogu plugins/ na serwerze.
  • Uruchom lub zrestartuj serwer i potwierdź w konsoli, że PlaceholderAPI został załadowany.
  • Zainstaluj rozszerzenia, umieszczając pliki jar w plugins/PlaceholderAPI/expansions/ albo używając komend eCloud w grze (dla zweryfikowanych rozszerzeń).

📦 Zależności

  • Sam PlaceholderAPI nie wymaga ogólnej zależności od innej wtyczki, aby działać. Niektóre placeholdery dostarczane przez rozszerzenia zależą od innych wtyczek (na przykład rozszerzenie wyświetlające wartości ekonomii będzie wymagało odpowiedniej wtyczki ekonomicznej). Te wymagania zależą od konkretnego rozszerzenia.

🧠 Uwagi techniczne

  • PlaceholderAPI jest dostarczany dla serwerów opartych na Spigot i jest również często używany na Paper. Udostępnia API, dzięki któremu twórcy wtyczek mogą rejestrować PlaceholderExpansions.
  • Rozszerzenia mogą być dystrybuowane jako samodzielne pliki jar albo dołączane do innych wtyczek; samodzielne rozszerzenia zwykle instaluje się w plugins/PlaceholderAPI/expansions/.
  • Funkcja eCloud umożliwia odkrywanie i pobieranie zweryfikowanych rozszerzeń w grze; serwery muszą zezwalać na wychodzące połączenia HTTPS, aby pobieranie z eCloud działało.
  • Wtyczka zawiera komendy debug i parsing, które pomagają administratorom sprawdzić, czy placeholdery są poprawnie rozwiązywane.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli Twój serwer używa wielu wtyczek, które muszą wyświetlać dynamiczne dane między wtyczkami (chat, tab, hologramy, scoreboards lub GUI), PlaceholderAPI jest przydatny, ponieważ centralizuje rozwiązywanie placeholderów i pozwala dodawać obsługę kolejnych wtyczek poprzez modułowe rozszerzenia bez modyfikowania każdej wtyczki korzystającej z danych.

Serwery z pluginem PlaceholderAPI

Strona pluginu PlaceholderAPI pokazuje serwery, na których monitoring znalazł ten plugin, używaną platformę i wersję.

Plugin może dodawać komendy, ekonomię, bezpieczeństwo, uprawnienia dostępu, minigry, integracje i inne mechaniki. Rzeczywista rola PlaceholderAPI zależy od ustawień serwera.

Dane są generowane automatycznie z technicznych odpowiedzi serwerów. Jeśli serwer trzyma listę pluginów prywatnie, może używać PlaceholderAPI, ale nie pojawiać się w tej sekcji.

Użyj listy serwerów z PlaceholderAPI, aby porównać projekty, sprawdzić wspierane wersje lub znaleźć przykłady użycia pluginu na publicznych serwerach.