Minecraft Servers HQ

Minecraft-Plugin PlaceholderAPI

Informationen zu PlaceholderAPI und den Servern, auf denen es gefunden wurde

SpigotPaperAPIAdmin ToolsPermissionsUtilityChatIntegrationDeveloper API

🔌 Über PlaceholderAPI

PlaceholderAPI ist ein Minecraft-Plugin, das ein zentrales Placeholder-System und ein Erweiterungs-Ökosystem (die eCloud) bereitstellt. Es ermöglicht anderen Plugins, Tausende dynamischer Platzhalter zu lesen und zu ersetzen (Spielerdaten, Wirtschaftswerte, pluginspezifische Werte usw.), ohne direkte Integration oder feste Abhängigkeiten zu benötigen.

🎯 Zweck

Das Plugin löst Integrationsprobleme zwischen Plugins, indem es eine einzelne, erweiterbare Placeholder-API bereitstellt. Plugin-Autoren veröffentlichen Erweiterungen, die benannte Platzhalter liefern; Server-Administratoren installieren diese Erweiterungen, damit serverseitige Plugins (Scoreboards, Chat, Hologramme, GUIs) Live-Daten mit einer einheitlichen Syntax anzeigen können.

⚙️ Funktionen

  • Zentrale API zum Parsen von Platzhaltern, an die sich andere Plugins andocken können.
  • Erweiterungssystem: einzeln verpackte Erweiterungen oder Erweiterungen, die in Plugins gebündelt sind.
  • eCloud (Expansion-Cloud) zum Finden und Herunterladen verifizierter Erweiterungen im Spiel.
  • Laufzeit-Verwaltungsbefehle zum Auflisten, Registrieren, Deregistrieren und Neuladen von Erweiterungen.
  • Debug-/Parse-Befehle zum Auswerten von Platzhaltern für einen Spieler oder zum Senden der Ergebnisse an alle, nützlich bei der Fehlersuche.
  • Hilfsfunktionen wie ein Dump-Befehl, um installierte Erweiterungen und den Plugin-Status beim Support zu teilen.

🧩 Für wen es gedacht ist

  • Server-Administratoren, die einheitlichen dynamischen Text über mehrere Plugins hinweg benötigen (Scoreboards, Tablists, Hologramme, GUIs).
  • Plugin-Entwickler, die Platzhalter bereitstellen oder nutzen möchten, ohne feste Abhängigkeiten zu erzwingen.
  • Survival-, Minigame- und Netzwerk-Server, die viele Plugins kombinieren und eine konsistente Platzhalter-Syntax brauchen.

🏗️ Beispiel-Anwendungsfälle

  • Ein Server installiert eine Vault-Erweiterung, damit Wirtschaft-Platzhalter wie das Spielerguthaben in Scoreboard- und Chat-Plugins verwendet werden können.
  • Ein Admin lädt eine plugin-spezifische Erweiterung aus der eCloud herunter, damit ein Hologramm-Plugin Live-Zieldaten anzeigen kann.
  • Ein Entwickler stellt Plugin-Daten über eine PlaceholderExpansion bereit, damit andere Server diese Daten anzeigen können, ohne direkt vom Plugin abhängig zu sein.

⌨️ Befehle

BefehlBeschreibungBerechtigungZugriff
`/papi parse <playerme> `Parst Platzhalter in einem String und zeigt das Ergebnis zur Fehlersuche an.nicht angegeben
`/papi bcparse <playerme> `Parst Platzhalter und sendet das Ergebnis an alle Spieler.nicht angegeben
`/papi cmdparse <playerme> `Parst Platzhalter und führt den resultierenden Befehl aus.nicht angegeben
/papi parserel <player1> <player2> <text>Parst relationale Platzhalter und vergleicht zwei Spieler.nicht angegebenAdmin
/papi listListet aktive/registrierte Erweiterungen auf.nicht angegebenAdmin
/papi info <expansion>Zeigt Informationen über eine registrierte Erweiterung an.nicht angegebenAdmin
/papi register <filename>Registriert ein Erweiterungs-JAR aus dem expansions-Ordner ohne Neustart.nicht angegebenAdmin
/papi unregister <filename>Deregistriert/entfernt eine registrierte Erweiterung.nicht angegebenAdmin
/papi reloadLädt die PlaceholderAPI-Konfiguration neu und registriert neu heruntergeladene Erweiterungen.nicht angegebenAdmin
/papi versionZeigt die Plugin-Version und die Autoren an.nicht angegebenAdmin
/papi dumpGibt Plugin-/Versions-/Erweiterungsinformationen für den Support aus (Paste-Dienst).nicht angegebenAdmin
/papi ecloud download <expansion> [version]Lädt eine verifizierte Erweiterung aus der eCloud auf den Server herunter.nicht angegebenAdmin
`/papi ecloud list [allinstalled]`Listet in der eCloud verfügbare Erweiterungen oder installierte Erweiterungen auf.
/papi ecloud placeholders <expansion>Listet die von einer eCloud-Erweiterung bereitgestellten Platzhalter auf.nicht angegebenAdmin
/papi ecloud statusZeigt die Verbindung/den Status des eCloud-Dienstes an.nicht angegebenAdmin

(Hinweis: Die obigen Befehle sind in der offiziellen PlaceholderAPI-Befehlsreferenz dokumentiert. Berechtigungsknoten für einzelne Befehle sind in der referenzierten Dokumentation nicht aufgeführt.)

⚙️ Installation

📥 Einrichtung

  • Lade das offizielle PlaceholderAPI-JAR herunter und lege es in das Verzeichnis plugins/ deines Servers.
  • Starte oder starte den Server neu und bestätige in der Konsole, dass PlaceholderAPI geladen wird.
  • Installiere Erweiterungen, indem du die Erweiterungs-JARs in plugins/PlaceholderAPI/expansions/ legst oder die eCloud-Befehle im Spiel verwendest (für verifizierte Erweiterungen).

📦 Abhängigkeiten

  • PlaceholderAPI selbst benötigt keine allgemeine Plugin-Abhängigkeit, um zu funktionieren. Einige von Erweiterungen bereitgestellte Platzhalter sind auf andere Plugins angewiesen (zum Beispiel benötigt eine Erweiterung, die Wirtschaftswerte ausgibt, das entsprechende Economy-Plugin). Diese Anforderungen hängen von der jeweiligen Erweiterung ab.

🧠 Technische Hinweise

  • PlaceholderAPI wird für auf Spigot basierende Server bereitgestellt und wird auch häufig auf Paper verwendet. Es stellt eine API bereit, mit der Plugin-Entwickler PlaceholderExpansions registrieren können.
  • Erweiterungen können als eigenständige JAR-Dateien verteilt oder in andere Plugins eingebettet werden; eigenständige Erweiterungen werden üblicherweise in plugins/PlaceholderAPI/expansions/ installiert.
  • Die eCloud-Funktion ermöglicht das Entdecken und Herunterladen verifizierter Erweiterungen im Spiel; Server müssen ausgehendes HTTPS zulassen, damit eCloud-Downloads funktionieren.
  • Das Plugin enthält Debug- und Parsing-Befehle, mit denen Administratoren prüfen können, ob Platzhalter korrekt aufgelöst werden.

🤝 Wann dieses Plugin nützlich ist

Wenn dein Server mehrere Plugins verwendet, die dynamische Daten zwischen Plugins anzeigen müssen (Chat, Tab, Hologramme, Scoreboards oder GUIs), ist PlaceholderAPI nützlich, weil es die Auflösung von Platzhaltern zentralisiert und es dir ermöglicht, Unterstützung für weitere Plugins über modulare Erweiterungen hinzuzufügen, ohne jedes konsumierende Plugin zu ändern.

Server mit dem Plugin PlaceholderAPI

Die Seite des Plugins PlaceholderAPI zeigt, auf welchen Servern das Monitoring dieses Plugin gefunden hat, sowie mit welchen Plattformen und Versionen es vorkommt.

Plugins können Befehle, Wirtschaft, Schutz, Zugriffsrechte, Mini-Spiele, Integrationen oder andere Mechaniken hinzufügen. Die tatsächliche Rolle von PlaceholderAPI hängt von der Konfiguration des jeweiligen Servers ab.

Daten werden automatisch aus den technischen Antworten der Server gebildet. Wenn ein Server die Plugin-Liste verbirgt, erscheint er möglicherweise nicht in diesem Abschnitt, auch wenn er PlaceholderAPI nutzt.

Nutze die Serverliste mit PlaceholderAPI, um Projekte zu vergleichen, kompatible Versionen zu prüfen oder Beispiele der Plugin-Nutzung auf öffentlichen Servern zu finden.