🏆Classements d’activité

Le module TopStats permet de générer automatiquement ou manuellement un classement des membres les plus actifs d’un serveur Discord, basé sur le temps passé en vocal ou le nombre de messages envoyés.

---

⚙️ Configuration

📌 Commande à utiliser :

/config_top

🔧 Paramètres disponibles

Paramètre	Description
interval	⏱️ Nombre de jours entre chaque publication automatique
mode	🎙️ Type de classement : Messages, Vocal, Les deux
salon	📝 Salon dans lequel le classement sera envoyé
reset	♻️ Réinitialiser les données après chaque top ?
limit	🔟 Nombre de membres à afficher dans le classement
whitelist	🛡️ Facultatif — seul ce rôle est autorisé à apparaître dans le classement

💡 Les bots sont toujours exclus du classement, même sans whitelist.

---

💡 Exemple

/config_top interval:7 mode:"Les deux" salon:#classements reset:"Oui" limit:10 whitelist:@Membres actifs

---

⚡ Générer le classement à la demande

📎 Commande :

/top_now

🪄 Génére instantanément le classement configuré et le publie dans le salon désigné.

---

♻️ Réinitialiser manuellement les données

🧹 Commande :

/reset_top

Efface toutes les données enregistrées (messages et vocal).

---

🔍 Voir la configuration actuelle

🔎 Commande :

/show_config_top

Affiche un embed contenant :

• la fréquence d’annonce automatique

• le type de top activé

• le salon cible

• la limite d’affichage

• le rôle whitelist (s’il est défini)

• l’état du reset automatique

---

📈 Fonctionnement

Événement	Conséquence
Message envoyé	➕ Compteur message_count incrémenté
Connexion/déconnexion vocale	⏱️ Temps vocal calculé et cumulé
Tâche quotidienne	⏲️ Vérifie si un top doit être publié
Après top (si reset activé)	♻️ Les données sont automatiquement effacées

---

📊 Affichage

• Classement messages :

  1. @Membre — 123 messages

• Classement vocal :

  1. @Membre — 2h 45m

• Chaque top (vocal/messages) est envoyé dans un embed dédié.

• Seuls les membres humains et ayant le rôle whitelist (s’il est défini) sont inclus.