Ce système récompense automatiquement les membres actifs (💬 messages + 🎙️ vocal) avec des rangs spéciaux appelés paliers.
Plus un membre est actif, plus il monte 📈… s’il ralentit, il peut redescendre 📉 !

---

🎮 Fonctionnement général

1. 🔧 Tu configures les paliers et les rôles associés
2. 💬 Les messages et la présence vocale sont comptabilisés
3. 🔼 Les membres montent automatiquement de palier
4. 🔽 En cas d’inactivité, ils peuvent être rétrogradés

---

⚙️ Fonctions principales

📊 Suivi d’activité

• Messages : chaque message augmente la progression
• Vocal : toutes les minutes en vocal (non muet) sont comptées

🆙 Montée automatique

• Un rôle est attribué dès que le membre atteint les critères du palier supérieur
• Les anciens rôles sont retirés automatiquement

📉 Rétrogradation automatique

• Si un membre n’atteint pas un seuil d’activité minimum (ex : 40%) sur 7 jours, il redescend au palier inférieur (sauf exception)

---

🔧 Configuration admin

Associer un rôle à un palier

/param_paliers palier:2 role:@Membre++

Définir les critères (messages / vocal)

/config_palier_criteres palier:2 messages:100 vocal_minutes:60 level:0

Choisir le mode de progression

/config_mode_progression cumulatif:true

true ➜ activité globale cumulée
false ➜ progression uniquement entre deux paliers

Empêcher la rétrogradation d’un rôle

/ajouter_exception_downgrade role:@VIP

Définir le seuil d’inactivité

/config_seuil_downgrade pourcentage:40

En dessous de ce pourcentage, le membre est rétrogradé

Configurer les salons de logs

/config_logs_paliers salon_montée:#upgrades salon_downgrade:#downgrades

Forcer un palier manuellement

/forcer_palier membre:@Pseudo palier:3

Réinitialiser la progression

/reset_progression
ou
/reset_progression membre:@Pseudo

---

📋 Visualiser les données

📌 Voir son palier et sa progression

/carte

Affiche :

• Le palier actuel
• Le nombre de messages envoyés
• Le temps passé en vocal
• Une barre de progression vers le prochain palier
• Un indicateur de maintien du palier actuel

📄 Voir tous les paliers

/liste_paliers

Pour chaque palier :

• Messages requis
• Temps vocal requis
• Rôle associé

👥 Voir la progression de tous les membres

/progression_utilisateurs

Affiche un classement paginé avec :

• Nom du membre
• Messages
• Temps vocal

---

🎓 Exemple de configuration rapide

1. Crée tes rôles : @Nouveau, @Actif, @Pilier
2. Associe-les à un palier :
   • Palier 1 → @Nouveau (0 msg / 0 vocal)
   • Palier 2 → @Actif (100 msg / 60 min vocal)
   • Palier 3 → @Pilier (300 msg / 180 min vocal)
3. Active la progression cumulative :
   /config_mode_progression cumulatif:true
4. Ajoute un seuil :
   /config_seuil_downgrade pourcentage:40

Et c’est tout ! 🎉
Les membres montent, redescendent et reçoivent les bons rôles automatiquement.

---

🧠 Astuces utiles

• Tu peux activer un mode cumulatif (XP globale) ou progressif (étape par étape)
• Les montées et descentes sont loggées dans les salons que tu choisis
• Chaque membre peut suivre son évolution avec /carte (très apprécié des joueurs !)
• Les rôles spéciaux (admin, booster, etc.) peuvent être exclus des rétrogradations