KGInfoServs QuestsTracker
QuestsTracker est un addon premium pour BetonQuest qui offre un systeme complet de suivi et de gestion de quetes pour votre serveur Minecraft.
Concu pour les serveurs Paper 1.21+ et optimise avec Java 21, il propose un menu GUI interactif, un scoreboard en temps reel, et une synchronisation multi-serveur transparente.
Fonctionnalites
Menu de quetes interactif (GUI)
- Categories dynamiques : jusqu'a 4 categories entierement personnalisables (nom, icone, modele)
- Sous-categories : organisation hierarchique illimitee (ex:
Histoire > Chapitre 1) - Barre de progression automatique par sous-categorie
- Pagination pour gerer un grand nombre de quetes
- Statuts visuels : verrouille, actif, termine — chacun avec son icone et sa couleur
- Bascule des quetes terminees : le joueur peut masquer/afficher les quetes completees (preference sauvegardee)
- Multilingue : francais, anglais, polonais (determine par la config BetonQuest)
Scoreboard de suivi en temps reel
- Suivi jusqu'a 3 quetes simultanees par joueur
- Titre et separateur personnalisables en format MiniMessage (gradients, couleurs, etc.)
- Mises a jour declenchees par evenement : aucun polling, aucun tick inutile
- 95-98% moins de paquets reseau qu'un scoreboard classique
- Activable/desactivable globalement (config) et par joueur (commande)
Integration BetonQuest native
5 events personnalises enregistres directement dans BetonQuest :
| Event | Description |
|---|---|
activeQuest | Active une quete (la rend visible dans le menu) |
lockQuest | Verrouille une quete (la masque du menu) |
finishQuest | Termine une quete |
nextStep | Passe a l'etape suivante |
kgcomplete | Marque un objectif comme complete |
Systeme de statuts
| Statut | Description | Declencheur |
|---|---|---|
| Verrouille | Quete pas encore disponible | Aucun tag (etat par defaut) |
| Actif | Quete disponible et suivable | Event activeQuest |
| Termine | Quete completee | Event finishQuest |
Synchronisation multi-serveur
- Synchronisation via Redis Pub/Sub en temps reel
- Cache a deux niveaux (L1 local + L2 Redis) pour des performances optimales
- Systeme de heartbeat lors des changements de serveur (fenetre de 2 minutes)
- Circuit breaker : fallback automatique vers la base de donnees si Redis est indisponible
- Rate limiting : 100ms par joueur pour eviter la surcharge Redis
Outils d'administration
- Diagnostics complets : sante systeme, statistiques cache, rapport memoire, benchmarks
- Analytics : taux de completion, quetes populaires, adoption par joueur
- Purge de donnees : suppression ciblée avec patterns wildcard
- Mise a jour automatique : verification et telechargement de nouvelles versions
Performances
- Virtual Threads (Java 21) pour le parallelisme sans bloquer le thread principal
- Pool de connexions HikariCP pour la base de donnees
- Cache Caffeine local avec invalidation intelligente
- Demarrage asynchrone (BDD + Redis en parallele)
Prerequis
| Prerequis | Version minimale | Recommande |
|---|---|---|
| Serveur | Paper 1.21+ | Paper derniere version |
| Java | Java 21+ | Java 21 |
| BetonQuest | 3.0+ | Derniere version |
| Base de donnees | MySQL 8.0+ / MariaDB 10.5+ | MariaDB derniere version |
| Redis | 6.0+ (optionnel) | Redis derniere version |
| Licence | Cle de licence valide KGInfoServs | - |
Compatibilite
Le plugin ne fonctionne que sur Paper ou ses forks (Purpur, Pufferfish). Spigot n'est pas supporte. Java 21 est obligatoire pour le support des Virtual Threads.
Apercu rapide
Ouvrir le menu de quetes
/quests
Suivre une quete
/quests track <quest_id>
Diagnostics administrateur
/kgquests health # Sante du systeme
/kgquests stats # Statistiques du cache
/kgquests analytics # Taux de completion des quetes
/questsreload # Recharger la configuration
Sommaire de la documentation
| Page | Description |
|---|---|
| Installation | Guide d'installation complet etape par etape |
| Configuration | Reference complete de config.yml et quests_config.yml |
| Commandes | Toutes les commandes joueur et administrateur |
| Permissions | Permissions et roles recommandes |
| Integration BetonQuest | Events, templates, tags et exemples complets |
| Multi-serveur | Synchronisation Redis et cache distribue |
| Depannage | Resolution des problemes courants |