Système XP et Niveaux

Vue d'ensemble

Le système XP et Niveaux permet à vos membres de progresser en gagnant de l'expérience. Chaque action contribue à l'accumulation d'XP, qui se transforme en niveaux avec des récompenses optionnelles.

Fonctionnement

Gains d'XP

Les membres gagnent de l'XP de deux façons:

1. Messages (1-5 XP par message)

Chaque message envoyé dans le serveur récompense du XP
La récompense est aléatoire entre min et max (par défaut 1-5)
Cooldown de 30 secondes par utilisateur
Les messages des bots ne comptent pas

2. Activité Vocale (3 XP par minute)

Chaque minute en canal vocal = 3 XP
L'XP est attribué quand vous quittez le vocal
Minimum 1 minute pour être récompensé
La présence en vocal inactif ne compte pas

Progression des niveaux

La formule de calcul:

Niveau = floor(√(XP / 100)) + 1

Exemples:

Niveau 1 = 0 XP
Niveau 2 = 100 XP
Niveau 5 = 1,600 XP
Niveau 10 = 8,100 XP

Commandes utilisateur

/level

Affiche votre niveau et votre progression.

/level [@utilisateur]

Affiche:

Votre niveau actuel
Votre total d'XP
Barre de progression vers le prochain niveau
Optional: niveau d'un autre utilisateur

/leaderboard

Affiche le classement des meilleurs membres.

/leaderboard [page]

Affichage:

Top 10 par défaut
Triable par niveau ou XP total
Pagination automatique

Commandes administrateur

Configuration initiale

Tous les paramètres XP peuvent être configurés via /xpsettings.

Commandes de gestion

/addxp

Ajouter de l'XP manuellement.

/addxp @utilisateur 500

/removexp

Retirer de l'XP.

/removexp @utilisateur 100

/setlevel

Définir directement un niveau.

/setlevel @utilisateur 10

/addlevelrole

Attribuer un rôle à un niveau (max 5).

/addlevelrole 5 @Niveau 5
/addlevelrole 10 @Niveau 10

/removelevelrole

Supprimer une récompense de niveau.

/removelevelrole 5

/levelroles

Afficher les récompenses configurées.

/levelroles

Configuration

Paramètres XP

Via /xpsettings set:

messageXpMin - XP minimum par message (défaut: 1)
messageXpMax - XP maximum par message (défaut: 5)
voiceXpPerMinute - XP par minute en vocal (défaut: 3)
cooldownSeconds - Délai entre gains de message (défaut: 30)

Messages de level-up

Personnalisez le message envoyé au level-up:

/xpsettings set levelUpMessage ![user] a atteint le niveau ![level]! 🎉

Placeholders disponibles:

![user] - Mention @utilisateur
![username] - Nom d'utilisateur
![level] - Nouveau niveau

Canal de level-up

Définissez où les notifications de level-up s'affichent:

/xpsettings set levelUpChannel #level-up

Récompenses et Rôles

Vous pouvez configurer des rôles automatiques basés sur les niveaux:

Créez des rôles Discord (ex: "Niveau 5", "Niveau 10")

Configurez les récompenses:

/addlevelrole 5 @Niveau 5
/addlevelrole 10 @Niveau 10

Les utilisateurs reçoivent automatiquement les rôles en montant de niveau
Maximum 5 rôles de récompense par serveur

Tableau de bord

Accédez au dashboard pour:

Configurer les paramètres XP
Ajouter/supprimer les rôles de récompense
Voir une vue d'ensemble
Personnaliser le message de level-up

✅ L'XP se gagne automatiquement en parlant
✅ Les niveaux se calculent à partir de l'XP total
✅ Les récompenses de rôles sont optionnelles
✅ Aucune donnée perdue lors des modifications
✅ Les statistiques sont en temps réel