KGInfoServs QuestsTracker
QuestsTracker ist ein Premium-Addon für BetonQuest, das ein umfassendes Quest-Tracking- und Verwaltungssystem für Ihren Minecraft-Server bietet.
Entwickelt für Paper 1.21+-Server und optimiert mit Java 21, bietet es ein interaktives GUI-Menü, ein Echtzeit-Scoreboard und eine nahtlose Multi-Server-Synchronisierung.
Funktionen
Interaktives Quest-Menü (GUI)
- Dynamische Kategorien: bis zu 4 vollständig anpassbare Kategorien (Name, Symbol, Modell)
- Unterkategorien: unbegrenzte hierarchische Organisation (z.B.
Geschichte > Kapitel 1) - Fortschrittsbalken automatisch pro Unterkategorie
- Seitennavigation für eine große Anzahl von Quests
- Visuelle Status: gesperrt, aktiv, abgeschlossen — jeweils mit eigenem Symbol und eigener Farbe
- Abgeschlossene Quests umschalten: Der Spieler kann abgeschlossene Quests ein-/ausblenden (Einstellung wird gespeichert)
- Mehrsprachig: Französisch, Englisch, Deutsch, Polnisch, brasilianisches Portugiesisch (wird durch die BetonQuest-Konfiguration bestimmt)
Echtzeit-Tracking-Scoreboard
- Tracking von bis zu 3 gleichzeitigen Quests pro Spieler
- Titel und Trennlinie anpassbar im MiniMessage-Format (Farbverläufe, Farben usw.)
- Aktualisierungen ereignisgesteuert: kein Polling, keine unnötigen Ticks
- 95-98% weniger Netzwerkpakete als ein herkömmliches Scoreboard
- Global (Konfiguration) und pro Spieler (Befehl) aktivierbar/deaktivierbar
Native BetonQuest-Integration
5 benutzerdefinierte Events, die direkt in BetonQuest registriert werden:
| Event | Beschreibung |
|---|---|
activeQuest | Aktiviert eine Quest (macht sie im Menü sichtbar) |
lockQuest | Sperrt eine Quest (blendet sie im Menü aus) |
finishQuest | Schließt eine Quest ab |
nextStep | Geht zum nächsten Schritt über |
kgcomplete | Markiert ein Ziel als abgeschlossen |
Statussystem
| Status | Beschreibung | Auslöser |
|---|---|---|
| Gesperrt | Quest noch nicht verfügbar | Kein Tag (Standardzustand) |
| Aktiv | Quest verfügbar und verfolgbar | Event activeQuest |
| Abgeschlossen | Quest erledigt | Event finishQuest |
Multi-Server-Synchronisierung
- Synchronisierung über Redis Pub/Sub in Echtzeit
- Cache auf zwei Ebenen (L1 lokal + L2 Redis) für optimale Leistung
- Heartbeat-System beim Serverwechsel (2-Minuten-Fenster)
- Circuit Breaker: automatischer Fallback zur Datenbank, wenn Redis nicht verfügbar ist
- Rate Limiting: 100ms pro Spieler, um Redis-Überlastung zu vermeiden
Administrationswerkzeuge
- Umfassende Diagnose: Systemzustand, Cache-Statistiken, Speicherbericht
- Datenbereinigung: gezielte Löschung mit Wildcard-Patterns
- Automatische Updates: Prüfung und Download neuer Versionen
Leistung
- Virtual Threads (Java 21) für Parallelität ohne Blockierung des Hauptthreads
- HikariCP-Verbindungspool für die Datenbank
- Caffeine-Cache lokal mit intelligenter Invalidierung
- Asynchroner Start (Datenbank + Redis parallel)
Voraussetzungen
| Voraussetzung | Mindestversion | Empfohlen |
|---|---|---|
| Server | Paper 1.21+ | Paper neueste Version |
| Java | Java 21+ | Java 21 |
| BetonQuest | 3.0+ | Neueste Version |
| Datenbank | MySQL 8.0+ / MariaDB 10.5+ | MariaDB neueste Version |
| Redis | 6.0+ (optional) | Redis neueste Version |
| Lizenz | Gültiger KGInfoServs-Lizenzschlüssel | - |
Kompatibilität
Das Plugin funktioniert ausschließlich auf Paper oder dessen Forks (Purpur, Pufferfish). Spigot wird nicht unterstützt. Java 21 ist erforderlich für die Unterstützung von Virtual Threads.
Schnellübersicht
Quest-Menü öffnen
/quests
Eine Quest verfolgen
/quests track <quest_id>
Administrator-Diagnose
/kgquests health # Systemzustand
/kgquests stats # Cache-Statistiken
/questsreload # Konfiguration neu laden
Dokumentationsübersicht
| Seite | Beschreibung |
|---|---|
| Installation | Vollständige Schritt-für-Schritt-Installationsanleitung |
| Konfiguration | Vollständige Referenz für config.yml und quests_config.yml |
| Befehle | Alle Spieler- und Administratorbefehle |
| Berechtigungen | Berechtigungen und empfohlene Rollen |
| BetonQuest-Integration | Events, Templates, Tags und vollständige Beispiele |
| Multi-Server | Redis-Synchronisierung und verteilter Cache |
| Fehlerbehebung | Lösung häufiger Probleme |