tapscrollWIKI

Platzhalter

Gavels PlaceholderAPI-Expansion — Angebotszahlen, Postfach, Erlöse und Grand-Auction-Status für Scoreboards und Hologramme.

Gavel v1.0.0Paper · Folia supported1.21 – 1.21.x

Mit installiertem PlaceholderAPI registriert Gavel die Expansion gavel automatisch. Kein zusätzlicher Download, kein /papi ecloud — sie kommt aus dem Plugin.

Spieler-Platzhalter

PlatzhalterLiefert
%gavel_listings%Anzahl der aktuell aktiven Angebote des Spielers
%gavel_limit%Sein Angebotslimit aus gavel.limit.<n> oder dem Config-Standard
%gavel_mail%Anzahl ungeholter Items im Postfach
%gavel_sales%Abgeschlossene Verkäufe als Verkäufer
%gavel_purchases%Abgeschlossene Käufe als Käufer
%gavel_earned%Gesamt verdientes Geld, formatiert nach deinen economy-Einstellungen
%gavel_spent%Gesamt ausgegebenes Geld, formatiert

Grand-Auction-Platzhalter

PlatzhalterLiefert
%gavel_grand_running%true oder false
%gavel_grand_bid%Aktuelles Höchstgebot, formatiert
%gavel_grand_leader%Name des aktuell Führenden

Caching

Jeder Wert wird pro Spieler kurz zwischengespeichert. Platzhalter werden im Scoreboard-Takt ausgewertet — oft mehrmals pro Sekunde und Spieler — und so häufig auf die Datenbank zuzugreifen, wäre für sich genommen ein Performanceproblem.

Die praktische Folge: %gavel_listings% kann einer gerade ausgeführten Aktion ein bis zwei Sekunden hinterherhinken. Das ist Absicht und der richtige Kompromiss.

Geldwerte respektieren deine Formatierung

%gavel_earned%, %gavel_spent% und %gavel_grand_bid% kommen bereits mit economy.currency-format, den Trennzeichen und compact-numbers formatiert heraus. Du musst nichts nachbearbeiten.

Beispiele

Eine Scoreboard-Zeile mit der Auslastung gegen das Ranglimit:

TEXT
&7Angebote: &e%gavel_listings%&7/&e%gavel_limit%

Eine Postfach-Erinnerung, die nur erscheint, wenn es etwas zu holen gibt — die meisten Scoreboard-Plugins unterstützen eine Bedingung auf einen Platzhalterwert:

TEXT
&6Du hast %gavel_mail% Items in /ah mail

Ein Hologramm über einem Auktions-NPC, live während einer Grand Auction:

TEXT
&e&lGRAND AUCTION&fFührend: &a%gavel_grand_leader%&fGebot: &e%gavel_grand_bid%

Wenn ein Platzhalter als Rohtext erscheint

Drei Prüfungen, in dieser Reihenfolge:

  1. PlaceholderAPI ist installiert und Gavel wurde danach geladen. Gavel deklariert PlaceholderAPI als softdepend, die Ladereihenfolge stimmt also — aber nur, wenn PAPI beim Start überhaupt da ist.
  2. /aha info bestätigt, dass Gavel sauber geladen hat.
  3. /papi parse me %gavel_listings% testet die Expansion direkt, unabhängig vom Plugin, das dein Scoreboard rendert.

Funktioniert Schritt 3 und dein Scoreboard nicht, liegt das Problem beim Parsing des Scoreboard-Plugins, nicht bei Gavel.