KGInfoServs QuestsTracker
QuestsTracker ist ein Premium-Addon fuer BetonQuest, das ein umfassendes Quest-Tracking- und Verwaltungssystem fuer Ihren Minecraft-Server bietet.
Entwickelt fuer Paper 1.21+-Server und optimiert mit Java 21, bietet es ein interaktives GUI-Menue, ein Echtzeit-Scoreboard und eine nahtlose Multi-Server-Synchronisierung.
Funktionen
Interaktives Quest-Menue (GUI)
- Dynamische Kategorien: bis zu 4 vollstaendig anpassbare Kategorien (Name, Symbol, Modell)
- Unterkategorien: unbegrenzte hierarchische Organisation (z.B.
Geschichte > Kapitel 1) - Fortschrittsbalken automatisch pro Unterkategorie
- Seitennavigation fuer eine grosse 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: Franzoesisch, Englisch, Polnisch (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 (Farbverlaeufe, Farben usw.)
- Aktualisierungen ereignisgesteuert: kein Polling, keine unnuetigen Ticks
- 95-98% weniger Netzwerkpakete als ein herkoemmliches 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 Menue sichtbar) |
lockQuest | Sperrt eine Quest (blendet sie im Menue aus) |
finishQuest | Schliesst eine Quest ab |
nextStep | Geht zum naechsten Schritt ueber |
kgcomplete | Markiert ein Ziel als abgeschlossen |
Statussystem
| Status | Beschreibung | Ausloeser |
|---|---|---|
| Gesperrt | Quest noch nicht verfuegbar | Kein Tag (Standardzustand) |
| Aktiv | Quest verfuegbar und verfolgbar | Event activeQuest |
| Abgeschlossen | Quest erledigt | Event finishQuest |
Multi-Server-Synchronisierung
- Synchronisierung ueber Redis Pub/Sub in Echtzeit
- Cache auf zwei Ebenen (L1 lokal + L2 Redis) fuer optimale Leistung
- Heartbeat-System beim Serverwechsel (2-Minuten-Fenster)
- Circuit Breaker: automatischer Fallback zur Datenbank, wenn Redis nicht verfuegbar ist
- Rate Limiting: 100ms pro Spieler, um Redis-Ueberlastung zu vermeiden
Administrationswerkzeuge
- Umfassende Diagnose: Systemzustand, Cache-Statistiken, Speicherbericht, Benchmarks
- Analytics: Abschlussraten, beliebte Quests, Spielerakzeptanz
- Datenbereinigung: gezielte Loeschung mit Wildcard-Patterns
- Automatische Updates: Pruefung und Download neuer Versionen
Leistung
- Virtual Threads (Java 21) fuer Parallelitaet ohne Blockierung des Hauptthreads
- HikariCP-Verbindungspool fuer 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 | Gueltiger KGInfoServs-Lizenzschluessel | - |
Kompatibilitaet
Das Plugin funktioniert ausschliesslich auf Paper oder dessen Forks (Purpur, Pufferfish). Spigot wird nicht unterstuetzt. Java 21 ist erforderlich fuer die Unterstuetzung von Virtual Threads.
Schnelluebersicht
Quest-Menue oeffnen
/quests
Eine Quest verfolgen
/quests track <quest_id>
Administrator-Diagnose
/kgquests health # Systemzustand
/kgquests stats # Cache-Statistiken
/kgquests analytics # Quest-Abschlussraten
/questsreload # Konfiguration neu laden
Dokumentationsuebersicht
| Seite | Beschreibung |
|---|---|
| Installation | Vollstaendige Schritt-fuer-Schritt-Installationsanleitung |
| Konfiguration | Vollstaendige Referenz fuer config.yml und quests_config.yml |
| Befehle | Alle Spieler- und Administratorbefehle |
| Berechtigungen | Berechtigungen und empfohlene Rollen |
| BetonQuest-Integration | Events, Templates, Tags und vollstaendige Beispiele |
| Multi-Server | Redis-Synchronisierung und verteilter Cache |
| Fehlerbehebung | Loesung haeufiger Probleme |