Plugin Minecraft PlaceholderAPI

🔌 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

(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.