PlaceholderAPI

PlaceholderAPI (PAPI) löst eine wiederkehrende Sache: wie man Live-Daten in Text bekommt. Anstatt dass jedes Plugin sein eigenes System pflegt, wird ein einheitlicher Platzhalter in Prozentzeichen verwendet — der Placeholder. Zum Beispiel wird %player_name% als Spielername ausgegeben, %vault_eco_balance% als sein Guthaben und %server_online% als Anzahl der Spieler auf dem Server.

Die Platzhalter stammen nicht aus einer einzigen Quelle: PAPI hat sogenannte Erweiterungen. Jede fügt ein eigenes Set hinzu — eine für Spielerdaten (Player), eine für Wirtschaft (Vault), eine für den Server (Server) und Hunderte weitere. Erweiterungen werden mit dem Befehl /papi ecloud download heruntergeladen und PAPI behält sie.

Ohne Erweiterung wird der Platzhalter nicht ausgefüllt und bleibt im Text als gewöhnlicher Text sichtbar. Das ist der häufigste Fehler: Der Besitzer vergisst, die Erweiterung zu installieren, und wundert sich, warum in der Tabelle %vault_eco_balance% statt des Betrags angezeigt wird.

Erweiterungen werden von jedem Plugin verwendet, das PAPI unterstützt: DeluxeMenus (Menü), TAB (Tabelle und Name über dem Kopf), Hologramme, Chat sowie Vote-Belohnungen. Deshalb wird PAPI fast immer installiert, obwohl es selbst nichts sichtbar macht.

Wenn du herausfinden willst, was welcher Platzhalter ausgibt, verwende /papi parse me . PAPI füllt ihn aus und zeigt das Ergebnis — zum Beispiel /papi parse me Jsem %player_name% und ich habe %vault_eco_balance%.

1. Lade PlaceholderAPI von modrinth.com/plugin/placeholderapi oder dev.bukkit.org herunter — die Version für deine Serverversion.
2. Lade die .jar in den Ordner plugins hoch.
3. Starte den Server neu. In der Konsole erscheint eine Zeile mit der PAPI-Version und der Anzahl geladener Erweiterungen.
4. Schreibe /papi list — es listet die installierten Erweiterungen auf. Auf einem frischen Server sind es nur wenige.
5. Ergänze, was du brauchst: /papi ecloud download Player (Spielerdaten), /papi ecloud download Vault (Geld), /papi ecloud download Server (Serverstatus).
6. Schreibe nach jedem Download /papi reload — damit wird die Erweiterung geladen.
7. Prüfe den Platzhalter: /papi parse me %player_name% muss deinen Namen ausgeben, nicht den Text mit dem Platzhalter.
8. Wenn die Platzhalter funktionieren, nutze sie dort, wo du sie sehen willst — in TAB, in einem Menü, in einem Hologramm oder im Chat (für den Chat brauchst du ein Plugin, das PAPI unterstützt).
9. Wenn ein Platzhalter auch nach dem Hinzufügen der Erweiterung nicht funktioniert, prüfe in der Dokumentation des Plugins, dass es ihn wirklich unterstützt. Manche Plugins haben eigene Platzhalter.
10. Aktualisiere die Erweiterungen mit /papi ecloud refresh und dann /papi reload.

Wenn im Text %player_name% anstelle des Namens angezeigt wird, fehlt die Player-Erweiterung oder sie wurde nach dem Herunterladen nicht gestartet. /papi reload. Nejd Zuerst kontrolliere /papi list, erst dann suche den Fehler im Plugin, das den Platzhalter verwendet.
Platzhalter sind empfindlich gegenüber Groß- und Kleinschreibung und dem genauen Namen. %player_name% funktioniert, %Player_Name% nicht — kopiere den Namen immer aus /papi info .
Erweiterungen werden nicht über /reload geladen. Immer /papi ecloud download und dann /papi reload.
N Einige Platzhalter hängen von anderen Plugins ab: %vault_eco_balance% benötigt Vault und ein Economy-Plugin, %luckperms_prefix% benötigt LuckPerms. Ohne sie bleibt der Platzhalter leer — und das ist kein PAPI-Fehler.
Jedes Ausfüllen eines Platzhalters ist eine kleine Abfrage. In einer Tabelle, die jede Sekunde aktualisiert wird, setze nicht Dutzende davon ein — der Server merkt das an der Leistung.
Erweiterungen werden in plugins/PlaceholderAPI/expansions gespeichert. Wenn du sie sicherst, überträgst du sie auch auf einen anderen Server.