Befehle

QuestsTracker bietet Spielerbefehle fuer das Menue und das Tracking sowie Administratorbefehle fuer Verwaltung, Diagnose und Wartung.

Spielerbefehle

/quests

Oeffnet das Quest-Menue.

/quests

Aliase: /quetes, /quete, /quest, /q

Zeigt das GUI-Menue mit den Quest-Kategorien an. Der Spieler kann zwischen Kategorien navigieren, den Status seiner Quests einsehen und Quests verfolgen/nicht mehr verfolgen.

/quests [Spieler]

Oeffnet das Quest-Menue eines anderen Spielers.

/quests Spielername

Erforderliche Berechtigung: kginfoservs_quetes.admin

Der Menuetitel zeigt "Quests - Spielername" an.

/quests track

Beginnt eine Quest im Scoreboard zu verfolgen.

/quests track <quest_id>

Der Spieler kann bis zu 3 Quests gleichzeitig verfolgen. Verfolgte Quests werden im Ingame-Scoreboard mit ihren Zielen in Echtzeit angezeigt.

Tracking-Limit

Wenn der Spieler bereits 3 Quests verfolgt, muss er eine entfernen, bevor er eine neue hinzufuegen kann.

---

Administratorbefehle

/kgquests

Hauptbefehl fuer die Administration.

/kgquests <Unterbefehl>

Aliase: /kgquetes, /kgq

Erforderliche Berechtigung: kginfoservs_quetes.admin

---

/kgquests purgepackage

Loescht alle Spielerdaten fuer ein Quest-Paket. Unterstuetzt Wildcard-Patterns (%).

/kgquests purgepackage <pattern> [confirm|--force]

Beispiele:

# Ein bestimmtes Paket bereinigen
/kgquests purgepackage MeinPaket

# Alle Pakete bereinigen, die mit "Daily-" beginnen (Wildcard)
/kgquests purgepackage Daily-%

# Ohne Bestaetigung bereinigen (erzwungen)
/kgquests purgepackage MeinPaket --force

Ablauf:

1. Der Befehl zeigt eine Vorschau der zu loeschenden Daten an
2. Fuehren Sie den Befehl erneut mit confirm aus, um zu bestaetigen
3. Oder verwenden Sie --force, um die Bestaetigung zu ueberspringen

Geloeschte Daten:

• Quest-Fortschritt (player_quest_progress)
• Verfolgte Quests (player_tracked_quest)
• Zugehoerige BetonQuest-Tags und -Punkte
• Lokaler und Redis-Cache aller Online-Spieler

Unwiderrufliche Aktion

Dieser Befehl loescht Daten unwiderruflich. Sichern Sie Ihre Datenbank, bevor Sie diesen Befehl ausfuehren.

Taegliche Quests

Das Wildcard-Pattern ist nuetzlich fuer wiederkehrende Quests:

/kgquests purgepackage Daily-%

---

/kgquests refresh

Erzwingt das Neuladen der Spielerdaten aus der Datenbank.

/kgquests refresh <Spieler>

Invalidiert den lokalen und Redis-Cache fuer diesen Spieler, laedt die Daten aus der Datenbank neu und aktualisiert das Scoreboard. Nuetzlich, wenn die zwischengespeicherten Daten nicht der Realitaet entsprechen.

---

/kgquests scoreboard

Steuert das Quest-Scoreboard.

/kgquests scoreboard <on|off|toggle>

Option	Wirkung
on	Aktiviert das Scoreboard
off	Deaktiviert das Scoreboard
toggle	Schaltet den aktuellen Zustand um

Globales Scoreboard

Wenn das Scoreboard global deaktiviert ist (scoreboard.enabled: false in config.yml), hat dieser Befehl keine Wirkung.

---

/kgquests stats

Zeigt die Cache-Leistungsstatistiken an.

/kgquests stats

Angezeigte Informationen:

• Trefferquote pro Cache (QuestStatus, QuestProgress, QuestTracked, PlaceholderAPI)
• Anzahl der Treffer/Fehlschlaege und Ladevorgaenge
• Analyse der Trefferquote (ausgezeichnet: ueber 95%, gut: ueber 85%, zu pruefen: unter 85%)

---

/kgquests redis

Zeigt Redis-Diagnosen an.

/kgquests redis [Spieler]

Ohne Argument — Globale Uebersicht:

• Anzahl der Schluessel quest:progress:*, quest:tracked:*, quest:status:*
• Gesamtzahl der Schluessel im Cache

Mit Spieler — Spielerspezifische Ansicht:

• Existenz und TTL des Fortschrittsschluessels
• Existenz und TTL des Tracking-Schluessels
• Anzahl der Statusschluessel
• Warnung bei fehlenden Schluesseln

---

/kgquests health

Umfassende Systemzustandspruefung.

/kgquests health

Prueft alle Komponenten:

• Datenbank (Verbindung + Latenz)
• Redis (Verfuegbarkeit + Latenz)
• BetonQuest (geladen)
• PlaceholderAPI (aktiv)
• Virtual Threads (Anzahl)
• JVM-Speicher
• Gesamtergebnis des Systemzustands

---

/kgquests memory

Detaillierter Speichernutzungsbericht.

/kgquests memory

Angezeigte Informationen:

• Anzahl der Eintraege pro Cache und Schaetzung in KB
• Geoeffnete GUI-Menues
• JVM-Speicher (gesamt, verwendet, maximal)
• Optimierungsempfehlungen

---

/kgquests benchmark

Leistungstests mit Latenzmessungen.

/kgquests benchmark [Spieleranzahl]

Ausgefuehrte Tests:

• Cold Start: Lesen mit leerem Cache
• Warm Cache: Lesen mit geladenem Cache
• Datenbank-Stress: Sequentielle Abfragen
• Ergebnisse: Latenz, Durchsatz, Trefferquote
• Kapazitaetsempfehlungen

---

/kgquests analytics

Statistiken zur Akzeptanz und zum Abschluss von Quests.

/kgquests analytics [Paket]

Ohne Argument — Globale Uebersicht:

• Gesamtzahl der Spieler mit Daten
• Anzahl aktiver und abgeschlossener Quests
• Top 5 der aktiven Quests
• Top 5 der abgeschlossenen Quests (mit Abschlussrate)
• Top 5 der verfolgten Quests

Mit Paket — Paketspezifische Ansicht:

• Detaillierte Statistiken fuer ein Quest-Paket

---

/kgquests update

Prueft und laedt Plugin-Updates herunter.

/kgquests update

Prueft, ob eine neue Version verfuegbar ist, und laedt sie gegebenenfalls herunter. Die JAR wird in plugins/update/ abgelegt und beim naechsten Neustart angewendet.

---

/questsreload

Laedt die Plugin-Konfiguration neu.

/questsreload

Alias: /quetesreload

Erforderliche Berechtigung: kginfoservs_quetes.reload

Laedt neu:

• config.yml (Kategorien, Uebersetzungen, Scoreboard usw.)
• quests_config.yml (Texte und Quest-Schritte)

---

Befehlsuebersicht

Befehl	Beschreibung	Berechtigung
/quests	Oeffnet das Quest-Menue	Keine
/quests [Spieler]	Oeffnet das Menue eines anderen Spielers	kginfoservs_quetes.admin
/quests track <id>	Quest verfolgen	Keine
/kgquests purgepackage <pattern>	Paketdaten bereinigen	kginfoservs_quetes.admin
/kgquests refresh <Spieler>	Spielerdaten neu laden	kginfoservs_quetes.admin
/kgquests scoreboard	Scoreboard-Steuerung (on/off/toggle)	kginfoservs_quetes.admin
/kgquests stats	Cache-Statistiken	kginfoservs_quetes.admin
/kgquests redis [Spieler]	Redis-Diagnose	kginfoservs_quetes.admin
/kgquests health	Systemzustand	kginfoservs_quetes.admin
/kgquests memory	Speicherbericht	kginfoservs_quetes.admin
/kgquests benchmark [n]	Leistungstests	kginfoservs_quetes.admin
/kgquests analytics [Paket]	Quest-Statistiken	kginfoservs_quetes.admin
/kgquests update	Updates pruefen	kginfoservs_quetes.admin
/questsreload	Konfiguration neu laden	kginfoservs_quetes.reload

Tab-Vervollstaendigung

Die automatische Tab-Vervollstaendigung ist fuer alle Unterbefehle von /kgquests verfuegbar, einschliesslich Spielernamen und Quest-Paketen.