Befehle

QuestsTracker bietet Spielerbefehle für das Menü und das Tracking sowie Administratorbefehle für Verwaltung, Diagnose und Wartung.

Spielerbefehle

/quests

Öffnet das Quest-Menü.

/quests

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

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

/quests [Spieler]

Öffnet das Quest-Menü eines anderen Spielers.

/quests Spielername

Erforderliche Berechtigung: kginfoservs_quetes.admin

Der Menütitel 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 hinzufügen kann.

---

Administratorbefehle

/kgquests

Hauptbefehl für die Administration.

/kgquests <Unterbefehl>

Aliase: /kgquetes, /kgq

Erforderliche Berechtigung: kginfoservs_quetes.admin

---

/kgquests purgepackage

Löscht alle Spielerdaten für ein Quest-Paket. Unterstützt 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 Bestätigung bereinigen (erzwungen)
/kgquests purgepackage MeinPaket --force

Ablauf:

1. Der Befehl zeigt eine Vorschau der zu löschenden Daten an
2. Führen Sie den Befehl erneut mit confirm aus, um zu bestätigen
3. Oder verwenden Sie --force, um die Bestätigung zu überspringen

Gelöschte Daten:

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

Unwiderrufliche Aktion

Dieser Befehl löscht Daten unwiderruflich. Sichern Sie Ihre Datenbank, bevor Sie diesen Befehl ausführen.

Tägliche Quests

Das Wildcard-Pattern ist nützlich für wiederkehrende Quests:

/kgquests purgepackage Daily-%

---

/kgquests refresh

Erzwingt das Neuladen der Spielerdaten aus der Datenbank.

/kgquests refresh <Spieler>

Invalidiert den lokalen und Redis-Cache für diesen Spieler, lädt die Daten aus der Datenbank neu und aktualisiert das Scoreboard. Nützlich, wenn die zwischengespeicherten Daten nicht der Realität 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/Fehlschläge und Ladevorgänge
• Analyse der Trefferquote (ausgezeichnet: über 95%, gut: über 85%, zu prüfen: unter 85%)

---

/kgquests redis

Zeigt Redis-Diagnosen an.

/kgquests redis [Spieler]

Ohne Argument — Globale Übersicht:

• Anzahl der Schlüssel quest:progress:*, quest:tracked:*, quest:status:*
• Gesamtzahl der Schlüssel im Cache

Mit Spieler — Spielerspezifische Ansicht:

• Existenz und TTL des Fortschrittsschlüssels
• Existenz und TTL des Tracking-Schlüssels
• Anzahl der Statusschlüssel
• Warnung bei fehlenden Schlüsseln

---

/kgquests health

Umfassende Systemzustandsprüfung.

/kgquests health

Prüft alle Komponenten:

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

---

/kgquests memory

Detaillierter Speichernutzungsbericht.

/kgquests memory

Angezeigte Informationen:

• Anzahl der Einträge pro Cache und Schätzung in KB
• Geöffnete GUI-Menüs
• JVM-Speicher (gesamt, verwendet, maximal)
• Optimierungsempfehlungen

---

/kgquests update

Prüft und lädt Plugin-Updates herunter.

/kgquests update

Prüft, ob eine neue Version verfügbar ist, und lädt sie gegebenenfalls herunter. Die JAR wird in plugins/update/ abgelegt und beim nächsten Neustart angewendet.

---

/questsreload

Lädt die Plugin-Konfiguration neu.

/questsreload

Alias: /quetesreload

Erforderliche Berechtigung: kginfoservs_quetes.reload

Lädt neu:

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

---

Befehlsübersicht

Befehl	Beschreibung	Berechtigung
/quests	Öffnet das Quest-Menü	Keine
/quests [Spieler]	Öffnet das Menü 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 update	Updates prüfen	kginfoservs_quetes.admin
/questsreload	Konfiguration neu laden	kginfoservs_quetes.reload

Tab-Vervollständigung

Die automatische Tab-Vervollständigung ist für alle Unterbefehle von /kgquests verfügbar, einschließlich Spielernamen und Quest-Paketen.