Fehlerbehebung

Umfassender Leitfaden zur Loesung haeufiger Plugin-Probleme.

Das Quest-Menue oeffnet sich nicht

Symptom: Der Befehl /quests bewirkt nichts oder zeigt einen Fehler an.

Ursache	Pruefung	Loesung
Plugin nicht geladen	/plugins im Spiel	Ueberpruefen Sie die Ladefehler in den Logs
BetonQuest fehlt	/plugins im Spiel	Installieren Sie BetonQuest 3.0+
Datenbank nicht erreichbar	/kgquests health	Ueberpruefen Sie, ob BetonQuest MySQL aktiviert hat
Lizenzfehler	Serverlogs	Ueberpruefen Sie die Datei license.key

Loesung:

1. Ueberpruefen Sie, ob das Plugin geladen ist (gruen in /plugins)
2. Konsultieren Sie die Logs beim Start auf Fehler
3. Ueberpruefen Sie die Datenbankverbindung: /kgquests health

Quests erscheinen als gesperrt

Symptom: Das Menue oeffnet sich, aber alle Quests haben den Status "Gesperrt".

Ursache	Loesung
Template trackedQuest fehlt	Fuegen Sie templates: [trackedQuest] im BQ-Paket hinzu
Event activeQuest nicht ausgeloest	Ueberpruefen Sie, ob das Event in der BQ-Logik korrekt aufgerufen wird
Tag .questTrackable fehlt	Testen Sie manuell: /bq tag add <Spieler> ma_quete.questTrackable

Loesung:

1. Ueberpruefen Sie das Template im BetonQuest-Paket:

   templates:
     - trackedQuest

2. Ueberpruefen Sie, ob das Aktivierungs-Event existiert:

   events:
     activer: "activeQuest ma_quete"

3. Testen Sie manuell, indem Sie den Tag hinzufuegen:

   /bq tag add <Spieler> ma_quete.questTrackable

Quests erscheinen nicht in der richtigen Kategorie

Symptom: Quests erscheinen in der falschen Kategorie oder in der Standardkategorie.

Hauptursache: Die questCategory in BetonQuest stimmt nicht mit dem displayName der Kategorie in config.yml ueberein.

Pruefungen:

1. Vergleichen Sie die Werte exakt (einschliesslich Gross-/Kleinschreibung und Akzente):

   # config.yml
   menuItems:
     categories:
       dailyQuests:
         displayName: "Daily"  # ← Dieser Wert zaehlt

   # BetonQuest package.yml
   questParameters:
     questCategory: "Daily"  # ← Muss identisch sein

2. Wenn kein displayName definiert ist, verwendet das Plugin den Konfigurationsschluessel (z.B. dailyQuests).

3. Fuer Unterkategorien:

   questCategory: "Daily.Monsters"  # Format: displayName.displayName_Unter

Akzente und Gross-/Kleinschreibung

"Taeglich" ≠ "taeglich" ≠ "TAEGLICH". Die Uebereinstimmung muss exakt sein.

Das Scoreboard wird nicht angezeigt

Symptom: Verfolgte Quests zeigen kein Scoreboard an.

Ursache	Loesung
Scoreboard global deaktiviert	Ueberpruefen Sie scoreboard.enabled: true in config.yml
Keine Quest verfolgt	Der Spieler muss mindestens eine Quest verfolgen
Quest ohne Schritte	Definieren Sie steps in quests_config.yml
Konflikt mit anderem Plugin	Ueberpruefen Sie Konflikte mit TAB, Featherboard usw.

Loesung:

1. Ueberpruefen Sie die globale Scoreboard-Konfiguration:

   scoreboard:
     enabled: true

2. Der Spieler muss eine Quest verfolgen:

   /quests track <quest_id>

3. Ueberpruefen Sie, ob die Quest Schritte in quests_config.yml hat

4. Testen Sie das Scoreboard:

   /kgquests scoreboard on

Der Cache wird nicht aktualisiert

Symptom: Quest-Aenderungen werden nicht sofort widergespiegelt.

Loesungen:

1. Erzwingen Sie ein Refresh fuer einen Spieler:

   /kgquests refresh <Spieler>

2. Laden Sie die Konfiguration neu:

   /questsreload

3. Ueberpruefen Sie die Trefferquoten:

   /kgquests stats

Cache-TTL

Der lokale Cache (L1) verfaellt nach 1-2 Minuten, der Redis-Cache (L2) nach 2 Minuten. Wenn Sie ein sofortiges Refresh benoetigen, verwenden Sie /kgquests refresh.

Multi-Server-Probleme (Redis)

Symptom: Daten werden nicht zwischen Servern synchronisiert.

Pruefungen:

1. Redis-Verbindung: /kgquests redis
2. Dasselbe Redis fuer alle Server (ueberpruefen Sie host:port in jeder config.yml)
3. Dieselbe BetonQuest-Datenbank fuer alle Server
4. Firewall: Redis-Port (6379) zwischen den Servern offen
5. Erzwingen Sie ein Refresh: /kgquests refresh <Spieler>

Siehe Multi-Server fuer den detaillierten Leitfaden.

Datenbankfehler

Symptom: Fehler SQLException oder HikariPool in den Logs.

Ursache	Loesung
MySQL in BQ deaktiviert	Aktivieren Sie mysql.enabled: true in der BetonQuest-config.yml
Falsche Zugangsdaten	Ueberpruefen Sie die MySQL-Konfiguration von BetonQuest
MySQL-Server gestoppt	Starten Sie MySQL/MariaDB neu
Verbindungspool erschoepft	Starten Sie das Plugin neu
Netzwerk-Timeout	Ueberpruefen Sie die Verbindung zwischen MC-Server und Datenbank

Loesung:

1. Ueberpruefen Sie die Verbindung: /kgquests health
2. Ueberpruefen Sie, ob BetonQuest MySQL aktiviert hat:

   # plugins/BetonQuest/config.yml
   mysql:
     enabled: true

3. Testen Sie die Verbindung manuell:

   mysql -h localhost -u betonquest -p betonquest

Lizenzfehler beim Start

Symptom: Das Plugin wird nicht geladen und zeigt einen Lizenzfehler an.

Loesungen:

1. Ueberpruefen Sie die Lizenzdatei:

   plugins/kginfoservs_queststrack/license.key

2. Dateiinhalt: eine einzelne Zeile, keine Leerzeichen davor/danach

3. Internetzugang: Der Server muss den Lizenzserver kontaktieren koennen. Ueberpruefen Sie:

   • Ausgehende Firewall
   • Internetverbindung des Servers
   • Proxy, falls zutreffend

4. Support kontaktieren: Falls das Problem weiterhin besteht, kontaktieren Sie KGInfoServs auf Discord

Leistungseinbussen

Symptom: Das Menue oeffnet sich langsam, das Scoreboard ruckelt.

Diagnose:

/kgquests stats      # Cache-Trefferquote
/kgquests benchmark  # Detaillierte Latenzen
/kgquests memory     # JVM-Speicher
/kgquests health     # Gesamtzustand

Indikatoren:

Indikator	Problem	Loesung
Cache-Hit < 85%	Cache ineffizient	Ueberpruefen Sie die Spieleranzahl im Verhaeltnis zur Cache-Groesse
Datenbank-Latenz > 50ms	Datenbank langsam	Optimieren Sie MySQL, platzieren Sie die Datenbank naeher am MC-Server
Redis-Latenz > 10ms	Redis entfernt	Platzieren Sie Redis im selben Netzwerk
Speicher > 80%	Unzureichender Speicher	Erhoehen Sie den JVM-Heap (-Xmx)

Diagnosewerkzeuge

Diagnosebefehle

/kgquests health      # Globale Pruefung aller Komponenten
/kgquests stats       # Cache-Statistiken (Treffer, Fehlschlaege)
/kgquests redis       # Status der Redis-Verbindung
/kgquests redis <S>   # Redis-Cache eines bestimmten Spielers
/kgquests memory      # JVM-Speicher und Caches
/kgquests benchmark   # Latenztests (Datenbank, Redis, Cache)
/kgquests analytics   # Quest-Abschlussstatistiken

Logs in Echtzeit anzeigen

Linux:

tail -f logs/latest.log | grep -i queststrack

Windows (PowerShell):

Get-Content logs/latest.log -Wait | Select-String -Pattern "queststrack"

Schnell-Checkliste zur Fehlerbehebung

Bevor Sie um Hilfe bitten, ueberpruefen Sie:

• Plugin geladen (gruen in /plugins)
• BetonQuest installiert und funktionsfaehig
• MySQL in BetonQuest aktiviert (mysql.enabled: true)
• Datenbank erreichbar (/kgquests health)
• Konfiguration gueltig (/questsreload ohne Fehler)
• Template trackedQuest auf den Quests
• questCategory stimmt mit dem displayName ueberein (Gross-/Kleinschreibung und Akzente)
• BetonQuest-Events konfiguriert (activeQuest usw.)
• quests_config.yml ausgefuellt (title, steps)
• Serverlogs auf Fehler ueberprueft

Hilfe anfordern

Falls das Problem weiterhin besteht:

1. Sammeln Sie die Informationen:

   • Version von Minecraft, Paper, Java
   • Version von BetonQuest und QuestsTracker
   • Ergebnis von /kgquests health
   • Serverlogs (Zeilen mit Fehlern)
   • Ihre config.yml (ohne Passwoerter)

2. Kontaktieren Sie den Support:

   • Discord KGInfoServs: https://discord.gg/SZhD9AGUXW

Siehe auch

• Konfiguration — Referenz der Konfigurationsschluessel
• BetonQuest-Integration — Events und Templates
• Multi-Server — Redis-Konfiguration
• Installation — Installationsanleitung