PlaceholderAPI — Plugin zum Einsetzen dynamischer Daten in Minecraft
PlaceholderAPI (PAPI) lässt Minecraft-Plugins dynamische Werte wie Spielername, Guthaben und Rang über einfache %placeholder%-Marker…
PlaceholderAPI (PAPI) lässt Minecraft-Plugins dynamische Werte wie Spielername, Guthaben und Rang über einfache %placeholder%-Marker anzeigen.
PlaceholderAPI — Plugin zum Einsetzen dynamischer Daten in Minecraft
Minecraft-Version, mit der der Artikel getestet und geschrieben wurde: 26.1.2
Unterstützter Versionsbereich: 1.8.x – 26.1.x
PlaceholderAPI (kurz PAPI) ist ein serverseitiges Plugin für Minecraft, das anstelle spezieller Marker dynamische Werte in Text einsetzt. Für sich genommen gibt es nichts aus: Es ist eine Engine, die in einer Zeichenkette einen Marker wie %player_name% findet und ihn durch den aktuellen Wert ersetzt — Spielername, Guthaben, Rang, Spieleranzahl online. Die Daten selbst liefern separate Module — Expansions, während PAPI nur die Ersetzung ausführt. Dadurch lesen Chat-, Scoreboard-, Tabliste- und Menü-Plugins die Werte im selben Format, ohne eigene Syntax.
Format der Placeholder
Ein Placeholder wird zwischen zwei Prozentzeichen geschrieben: %<розширення>_<параметр>%. Der erste Teil vor dem Unterstrich ist der Name der Expansion, danach folgt der konkrete Parameter. Zum Beispiel gibt %player_name% den Spielernamen zurück, und %server_online% die Anzahl der Spieler online.
Die Ersetzung greift nur dort, wo sie vom empfangenden Plugin selbst aufgerufen wird. Unterstützt ein Plugin PAPI nicht, bleiben die Marker in seinen Nachrichten einfacher Text. Einen einzelnen Placeholder kann man mit dem Parse-Befehl prüfen:
/papi parse me %player_name%
Wird als Antwort der Markertext selbst zurückgegeben statt eines Werts, fehlt die benötigte Expansion, oder das Quell-Plugin ist deaktiviert.
Expansions und eCloud
PlaceholderAPI enthält von Haus aus keinen einzigen Placeholder — sie alle kommen aus Expansions. Manche sind in das Quell-Plugin eingebaut und registrieren sich beim Serverstart selbst; andere liegen als separate jar-Dateien in der Expansion-Cloud (eCloud) und werden im Verzeichnis /plugins/PlaceholderAPI/expansions/ installiert.
Die benötigte Expansion lässt sich direkt aus dem Spiel herunterladen:
/papi ecloud download <розширення>
/papi reload
Über den Befehl werden nur verifizierte Expansions heruntergeladen — das ist ein Schutz vor schädlichem Code. Nicht verifizierte werden manuell installiert: das jar von der Website herunterladen und in den Expansions-Ordner legen.
Zugang zu eCloud: Blockiert das Hosting oder eine Firewall die ausgehende Verbindung, funktioniert der Download über den Befehl nicht — die Expansion muss dann manuell hinzugefügt werden.
Befehle
Alle Befehle beginnen mit /papi. Standardmäßig stehen sie nur Operatoren zur Verfügung; einzelne Rechte werden über die Nodes placeholderapi.* vergeben.
Befehl | Zweck |
| Placeholder im Text für einen Spieler auflösen |
| Relationale Placeholder für zwei Spieler auflösen |
| Aktive Expansions anzeigen |
| Informationen zu einer bestimmten Expansion |
| Expansion aus der Cloud herunterladen |
| Liste der Placeholder einer Expansion |
| Plugin und Konfiguration neu laden |
| Version des installierten Plugins |
Konfiguration
In der config.yml sind nur wenige Parameter zum Bearbeiten nützlich:
Parameter | Was er tut |
| Verbindung zur eCloud. |
| Text der booleschen Placeholder-Werte; kann durch ja / nein ersetzt werden |
| Datums- und Zeitformat für die entsprechenden Placeholder |
| Prüft beim Start auf Plugin-Updates und benachrichtigt Operatoren |
Die übrigen Werte in der Datei sind intern (Schutz der Expansions, Ersetzungsmodus in Adventure-Komponenten, Debug) und werden standardmäßig nicht angefasst.
Fazit
PlaceholderAPI bietet ein einheitliches Format zum Einsetzen von Daten, das Hunderte Plugins verstehen: Statt einer separaten Integration für jedes Plugin genügt eine Zeile mit einem Placeholder. Wird von Administratoren von Minecraft-Servern mit Chat, Tabliste, Scoreboard oder Menüs auf Basis dynamischer Daten benötigt; für Singleplayer hat es keinen Nutzen.
Installation
Eine typische Installation dauert etwa 5 Minuten. Der Ablauf ist gleich; nur Loader und der passende Build unterscheiden sich.
- 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.
