Commandes

QuestsTracker propose des commandes joueur pour le menu et le suivi, et des commandes administrateur pour la gestion, le diagnostic et la maintenance.

Commandes joueur

/quests

Ouvre le menu de quetes.

/quests

Alias : /quetes, /quete, /quest, /q

Affiche le menu GUI avec les categories de quetes. Le joueur peut naviguer entre les categories, voir le statut de ses quetes et suivre/arreter de suivre des quetes.

/quests [joueur]

Ouvre le menu de quetes d'un autre joueur.

/quests NomDuJoueur

Permission requise : kginfoservs_quetes.admin

Le titre du menu affiche "Quetes - NomDuJoueur".

/quests track

Commence a suivre une quete dans le scoreboard.

/quests track <quest_id>

Le joueur peut suivre jusqu'a 3 quetes simultanees. Les quetes suivies s'affichent dans le scoreboard en jeu avec leurs objectifs en temps reel.

Limite de suivi

Si le joueur suit deja 3 quetes, il doit en retirer une avant d'en ajouter une nouvelle.

---

Commandes administrateur

/kgquests

Commande principale d'administration.

/kgquests <sous-commande>

Alias : /kgquetes, /kgq

Permission requise : kginfoservs_quetes.admin

---

/kgquests purgepackage

Supprime toutes les donnees joueur pour un package de quetes. Supporte les patterns avec wildcard (%).

/kgquests purgepackage <pattern> [confirm|--force]

Exemples :

# Purger un package specifique
/kgquests purgepackage MonPackage

# Purger tous les packages commencant par "Daily-" (wildcard)
/kgquests purgepackage Daily-%

# Purger sans confirmation (force)
/kgquests purgepackage MonPackage --force

Processus :

1. La commande affiche un apercu des donnees qui seront supprimees
2. Executez a nouveau avec confirm pour valider
3. Ou utilisez --force pour sauter la confirmation

Donnees supprimees :

• Progression des quetes (player_quest_progress)
• Quetes suivies (player_tracked_quest)
• Tags et points BetonQuest associes
• Cache local et Redis de tous les joueurs en ligne

Action irreversible

Cette commande supprime definitivement les donnees. Sauvegardez votre base de donnees avant d'executer cette commande.

Quetes journalieres

Le pattern wildcard est utile pour les quetes recurrentes :

/kgquests purgepackage Daily-%

---

/kgquests refresh

Force le rechargement des donnees d'un joueur depuis la base de donnees.

/kgquests refresh <joueur>

Invalide le cache local et Redis pour ce joueur, recharge les donnees depuis la BDD et met a jour le scoreboard. Utile si les donnees en cache ne correspondent pas a la realite.

---

/kgquests scoreboard

Controle le scoreboard de quetes.

/kgquests scoreboard <on|off|toggle>

Option	Effet
on	Active le scoreboard
off	Desactive le scoreboard
toggle	Bascule l'etat actuel

Scoreboard global

Si le scoreboard est desactive globalement (scoreboard.enabled: false dans config.yml), cette commande est sans effet.

---

/kgquests stats

Affiche les statistiques de performance du cache.

/kgquests stats

Informations affichees :

• Taux de hit par cache (QuestStatus, QuestProgress, QuestTracked, PlaceholderAPI)
• Nombre de hits/miss et chargements
• Analyse du taux de hit (excellent : plus de 95%, bon : plus de 85%, a verifier : moins de 85%)

---

/kgquests redis

Affiche les diagnostics Redis.

/kgquests redis [joueur]

Sans argument — Vue globale :

• Nombre de cles quest:progress:*, quest:tracked:*, quest:status:*
• Total des cles en cache

Avec joueur — Vue specifique :

• Existence et TTL de la cle de progression
• Existence et TTL de la cle de tracking
• Nombre de cles de statut
• Alerte si des cles sont manquantes

---

/kgquests health

Verification de sante complete du systeme.

/kgquests health

Verifie tous les composants :

• Base de donnees (connexion + latence)
• Redis (disponibilite + latence)
• BetonQuest (charge)
• PlaceholderAPI (actif)
• Virtual Threads (nombre)
• Memoire JVM
• Verdict global de sante

---

/kgquests memory

Rapport detaille d'utilisation memoire.

/kgquests memory

Informations affichees :

• Nombre d'entrees par cache et estimation en Ko
• Menus GUI ouverts
• Memoire JVM (totale, utilisee, max)
• Recommandations d'optimisation

---

/kgquests benchmark

Tests de performance avec mesures de latence.

/kgquests benchmark [nombre_joueurs]

Tests executes :

• Cold start : lecture avec cache vide
• Warm cache : lecture avec cache charge
• Stress BDD : requetes sequentielles
• Resultats : latence, debit, taux de hit
• Recommandations de capacite

---

/kgquests analytics

Statistiques d'adoption et de completion des quetes.

/kgquests analytics [package]

Sans argument — Vue globale :

• Total de joueurs avec des donnees
• Nombre de quetes actives et terminees
• Top 5 des quetes actives
• Top 5 des quetes terminees (avec taux de completion)
• Top 5 des quetes suivies

Avec package — Vue specifique :

• Statistiques detaillees pour un package de quetes

---

/kgquests update

Verifie et telecharge les mises a jour du plugin.

/kgquests update

Verifie si une nouvelle version est disponible et la telecharge si c'est le cas. Le JAR est place dans plugins/update/ et sera applique au prochain redemarrage.

---

/questsreload

Recharge la configuration du plugin.

/questsreload

Alias : /quetesreload

Permission requise : kginfoservs_quetes.reload

Recharge :

• config.yml (categories, traductions, scoreboard, etc.)
• quests_config.yml (textes et etapes des quetes)

---

Resume des commandes

Commande	Description	Permission
/quests	Ouvre le menu de quetes	Aucune
/quests [joueur]	Ouvre le menu d'un autre joueur	kginfoservs_quetes.admin
/quests track <id>	Suivre une quete	Aucune
/kgquests purgepackage <pattern>	Purger les donnees d'un package	kginfoservs_quetes.admin
/kgquests refresh <joueur>	Recharger les donnees d'un joueur	kginfoservs_quetes.admin
/kgquests scoreboard	Controle du scoreboard (on/off/toggle)	kginfoservs_quetes.admin
/kgquests stats	Statistiques du cache	kginfoservs_quetes.admin
/kgquests redis [joueur]	Diagnostics Redis	kginfoservs_quetes.admin
/kgquests health	Sante du systeme	kginfoservs_quetes.admin
/kgquests memory	Rapport memoire	kginfoservs_quetes.admin
/kgquests benchmark [n]	Tests de performance	kginfoservs_quetes.admin
/kgquests analytics [pkg]	Statistiques des quetes	kginfoservs_quetes.admin
/kgquests update	Verifier les mises a jour	kginfoservs_quetes.admin
/questsreload	Recharger la configuration	kginfoservs_quetes.reload

Tab completion

La completion automatique par Tab est disponible pour toutes les sous-commandes de /kgquests, incluant les noms de joueurs et les packages de quetes.