diff --git a/docs/2.modules/1.reglement.md b/docs/2.modules/1.reglement.md index 47404e5ac..f58bcb889 100644 --- a/docs/2.modules/1.reglement.md +++ b/docs/2.modules/1.reglement.md @@ -2,7 +2,7 @@ title: 'Règlement' description: Le système de règlement avec validation permet de donner un rôle aux nouveaux arrivants une fois qu'ils ont pris connaissance et accepté des règles du serveur. navigation.icon: 'twemoji:memo' -contributors: ['iibey', 'theorik', 'ls62'] +contributors: ['iibey', 'theorik', 'ls62', 'draftproducts'] updatedAt: '2023-12-15' --- diff --git a/docs/2.modules/2.niveaux.md b/docs/2.modules/2.niveaux.md index d449506b2..90cb059f5 100644 --- a/docs/2.modules/2.niveaux.md +++ b/docs/2.modules/2.niveaux.md @@ -2,15 +2,16 @@ title: Niveaux description: Découvrez comment suivre la progression des membres de votre serveur avec la fonctionnalité de niveaux. navigation.icon: 'twemoji:chart-increasing' +redactors: ['clement669', 'draftproducts'] contributors: ['hugo-broc', 'wernouxe', 'rababio4579', 'clement669', 'draftproducts', 'theorik', 'ls62', 'imroxxor'] -updatedAt: '2025-03-09' +updatedAt: '2026-01-08' --- ## Consulter votre niveau Pour consulter votre progression personnelle, utilisez la commande \. -![Carte renvoyée par la commande /niveau](../assets/niveaux/niveau_carte.png) +![Carte renvoyée par la commande /niveau](../assets/niveaux/bot_level_card.png) ::hint{ type="info" } Pour consulter la progression d'un autre membre, ajoutez simplement sa mention en argument de la commande \. @@ -18,11 +19,21 @@ Pour consulter votre progression personnelle, utilisez la commande \. ## Récompenses de niveau -Pour consulter les récompenses mises à disposition par le serveur lors du passage de certains niveaux, utilisez la commande \. +Motivez vos membres en leur offrant des récompenses lorsqu'ils atteignent certains niveaux ! Pour consulter les récompenses disponibles sur votre serveur, utilisez la commande \. -Il peut s'agir de rôles (temporaires ou non), d'argent du [système d'économie](/docs/modules/economie), d'[objets d'inventaire](/docs/modules/inventaire), et même de récompenses personnalisées ! +| Type | Description | Exemple | +|------|-------------|---------| +| **Rôle permanent** | Attribution d'un rôle Discord définitif | Rôle "Actif" au niveau 10 | +| **Rôle temporaire** | Attribution d'un rôle pour une durée limitée | Rôle "VIP 7 jours" au niveau 20 | +| **Argent** | De l'argent du [système d'économie](/docs/modules/economie) | 5000 pièces au niveau 15 | +| **Objet d'inventaire** | Un ou plusieurs [objets d'inventaire](/docs/modules/inventaire) | 3x "Potion de boost" au niveau 25 | +| **Récompense personnalisée** | Une récompense que vous remettez manuellement | Code promo, goodies, etc. | -![Récompenses de niveau](../assets/niveaux/reward.png) +![Récompenses de niveau](../assets/niveaux/bot_rewards.png) + +::hint{ type="info" } + Vous pouvez créer jusqu'à **10 récompenses** gratuitement. Les serveurs [premium](/premium) n'ont **aucune limite** ! +:: ## Classement des membres @@ -32,17 +43,21 @@ Vous pouvez afficher le classement des membres, du plus haut au plus bas niveau, Vous pouvez afficher le classement via la commande \. -![Résultat de la commande /topniveau](../assets/niveaux/topniveau.png) +![Résultat de la commande /topniveau](../assets/niveaux/bot_toplevel.png) ::hint{ type="success" } Si vous souhaitez afficher un nombre spécifique de lignes (seulement le top 3 par exemple), vous pouvez ajouter ce nombre en argument de la commande \. :: +::hint{ type="info" } + Si l'option **"Voir les XP des autres utilisateurs"** est désactivée, les membres ne peuvent consulter que leur propre progression avec \, mais les classements (\ et le classement en ligne) **restent accessibles** à tous. +:: + ### Classement en ligne Si vous avez activé le [**classement en ligne**](#fonctionnalités-disponibles), vous pouvez le consulter depuis le bouton **"Voir l'ensemble du classement"** de la commande \. -![Classement en ligne](../assets/niveaux/classement_web.png) +![Classement en ligne](../assets/niveaux/panel_leaderboard.png) ::hint{ type="info" } Si vous êtes administrateur du serveur, vous pouvez également y accéder depuis le [**panel**](/dashboard/first/levels) dans le module **Niveaux** via le bouton **"Accéder au classement"**. @@ -50,9 +65,9 @@ Si vous avez activé le [**classement en ligne**](#fonctionnalités-disponibles) ### Classement en temps réel -Pour les serveurs [premium <:icon_premium_:1096140508625125417>](/premium), il est possible de mettre un place dans un salon dédié un classement des membres en temps réel et mis à jour automatiquement. +Pour les serveurs [premium](/premium) <:icon_premium_:1096140508625125417>, il est possible de mettre en place dans un salon dédié un classement des membres en temps réel et mis à jour automatiquement. -![Classement Discord automatique](../assets/niveaux/classement_discord_auto.png) +![Classement Discord automatique](../assets/niveaux/bot_leaderboard_auto.png) ::hint{ type="success" } L'avantage de cette fonctionnalité est que le message affichant le classement peut afficher jusqu'à 25 membres et sera réactualisé toutes les 10 minutes automatiquement, sauf s'il n'y a pas de changements ! @@ -60,77 +75,203 @@ Pour les serveurs [premium <:icon_premium_:1096140508625125417>](/premium), il e ## Gérer les niveaux des membres -- \ : Crée un message qui offre de l'expérience au premier qui clique sur le bouton. -- \ : Ajouter de l'expérience à un membre. -- \ : Retirer de l'expérience à un membre. -- \ : Réinitialiser les niveaux de tout le serveur. -- \ : Définir l'expérience d'un membre. -- \ : Transférer de l'expérience d'un membre à un autre. +En tant qu'administrateur, vous disposez de plusieurs commandes pour gérer l'expérience des membres : + +| Commande | Description | +|----------|-------------| +| \ | Crée un message avec un bouton : le **premier membre** à cliquer gagne l'expérience. Vous pouvez définir une durée limite (maximum **10 minutes**). | +| \ | Ajouter de l'expérience à un membre spécifique. | +| \ | Retirer de l'expérience à un membre. **Attention** : cela peut entraîner la perte de niveaux et de récompenses. | +| \ | Définir exactement le montant d'XP d'un membre (remplace son XP actuelle). | +| \ | Transférer de l'expérience d'un membre à un autre (le donneur perd l'XP transférée). | +| \ | **Réinitialiser tous les niveaux du serveur**. Cette action est irréversible ! | ::hint{ type="info" } - Les commandes admin ne peuvent être utilisées que par les membres de votre serveur possédant les permissions administrateur. + Les commandes admin ne peuvent être utilisées que par les membres de votre serveur possédant la **permission administrateur**. +:: + +::hint{ type="warning" } + Lorsque vous **retirez de l'XP** ou **définissez** une XP plus basse, les membres peuvent perdre des niveaux. Dans ce cas, leurs **rôles de récompense** seront automatiquement retirés. :: ## Gain d'expérience -L'expérience peut être gagnée de diverses manières, la plus répandue étant la **participation écrite** dans le serveur. Chaque message dans une fenêtre de 30 secondes rapporte une quantité d'expérience comprise entre deux valeurs configurées (15 à 25xp par défaut). +### Expérience par message + +La méthode principale pour gagner de l'expérience est la **participation écrite** dans le serveur. Chaque message rapporte une quantité d'expérience **aléatoire** comprise entre deux valeurs que vous configurez (par défaut entre **15 et 25 XP**). + +::hint{ type="info" } + Un **cooldown de 30 secondes** s'applique entre chaque gain d'XP pour un même membre. Cela évite le spam et encourage les conversations de qualité. +:: + +### Expérience en vocal + +Les serveurs [premium](/premium) <:icon_premium_:1096140508625125417> peuvent activer le gain d'expérience en fonction de l'**activité vocale**. Chaque membre actif en vocal gagne une quantité d'expérience aléatoire (15 à 25 XP par défaut, configurable) **toutes les 2 minutes**. + +::hint{ type="info" } + **Conditions requises** pour gagner de l'XP en vocal : + - L'utilisateur ne doit **pas être muet** ou **en sourdine** (ni auto-sourdine, ni sourdine serveur). + - Le salon ne doit **pas être un salon de conférence** (stage) ou configuré comme **salon AFK** (dans les paramètres Discord). + - **Au moins 2 utilisateurs humains** doivent être présents et actifs (non muets/sourdine) dans le même salon. + + Si ces conditions ne sont plus remplies, le membre cesse de gagner de l'XP jusqu'à ce qu'elles soient à nouveau respectées. +:: + +::hint{ type="info" } + Cette fonctionnalité est réservée aux serveurs [premium](/premium) <:icon_premium_:1096140508625125417>. +:: + +### Autres gains d'expérience + +Grâce à l'**écosystème** de DraftBot, vous pouvez offrir de l'expérience via d'autres fonctionnalités : +- **Giveaways** : Offrez de l'XP en récompense +- **Boutique d'économie** : Vendez de l'XP contre de l'argent de serveur +- **Cadeaux d'anniversaires** : Offrez de l'XP automatiquement +- **Drop d'expérience** (\) : Créez des événements interactifs +- **Calendrier de l'avent** : Récompenses quotidiennes en décembre + +### Fils de discussion et forums -Grâce à l'**écosystème** de DraftBot, il vous sera possible de faire gagner de l'expérience aux membres de plusieurs autres manières : Giveaways, Boutique, Cadeaux d'anniversaires, Drop d'expérience dans les salons et Calendrier de l'avent. +Le système de niveaux distingue deux types d'espaces de discussion : -Les serveurs [premium <:icon_premium_:1096140508625125417>](/premium) pourront profiter d'un gain d'expérience en fonction de l'**activité vocale** : Chaque membre en vocal considéré comme actif, gagnera une quantité d'expérience comprise entre deux valeurs configurées (15 à 25xp par défaut) toutes les 2 minutes. +- **Les fils de discussion (threads)** : créés dans les salons textuels ou d'annonces. Leur gain d'XP peut être activé/désactivé via l'option **"Gain d'expérience dans les fils de discussions"**. +- **Les posts de forums** : messages publiés dans les salons de type Forum. Leur gain d'XP est contrôlé par l'option **"Gain d'XP dans les posts"**. ::hint{ type="info" } - Le gain d'**expérience en vocal** est soumis à plusieurs conditions : - - L'utilisateur ne doit pas être muet ou en sourdine (ni auto-sourdine, ni sourdine serveur). - - Le salon ne doit pas être un salon de conférence ou un salon configuré comme AFK (configuration Discord). - - Au moins 2 utilisateurs humains doivent être présents (non muet ou en sourdine) dans le même salon vocal. + Les fils de discussion et posts de forums **héritent automatiquement** des paramètres de leur salon parent concernant les listes blanches/noires et les multiplicateurs. :: -Afin de gérer votre serveur avec granularité, il vous sera possible de bloquer/booster le gain d'expérience en fonction de conditions et dans d'autres cas plus avancés de le réinitialiser. Retrouvez l'ensemble des options avancées ci-dessous : +Afin de gérer votre serveur avec granularité, il vous sera possible de bloquer/booster le gain d'expérience en fonction de conditions et dans d'autres cas plus avancés de le réinitialiser. + +### Listes blanches et noires + +Les listes de **rôles** et **salons** vous permettent de contrôler finement qui peut gagner de l'XP et où : + +- **Mode "avec" (whitelist)** : Seuls les membres/salons listés peuvent gagner de l'XP. Pour les rôles, il suffit qu'un membre possède **au moins un** rôle autorisé pour gagner de l'XP, même s'il possède d'autres rôles non listés. +- **Mode "sans" (blacklist)** : Les membres/salons listés ne peuvent **pas** gagner d'XP. Si un membre possède au moins un rôle interdit, il ne gagnera pas d'XP. -| **NOM** | **EXPLICATION** | | -|---------|-----------------|--| -| **Rôles avec/sans gain d'expérience** | Restreindre le gain d'expérience à certains rôles | | -| **Salons avec/sans gain d'expérience** | Restreindre le gain d'expérience à certains salons | | -| **Rôles boosters** | Régler des multiplicateurs d'XP pour certains rôles | | -| **Salons boosters** | Régler des multiplicateurs de gains pour certains salons | | -| **Niveau Maximum** | Définir un niveau maximum | <:icon_premium:1096140508625125417> | -| **Gain d'expérience dans les fils de discussions** | Autoriser ou non les membres à gagner de l'expérience dans les fils | | -| **Réinitialisation de l'expérience** | Définir si le niveau des membres est réinitialisé lorsqu'ils quittent le serveur | | -| **Gain d'expérience par message en vocal** | Définir si les messages textuels envoyés dans les salons vocaux rapportent de l'expérience ou non | | -| **Longs messages comptent double** | Définir si les longs messages donnent le double de points (250 caractères par défaut) | | +### Multiplicateurs d'expérience + +Vous pouvez appliquer des **multiplicateurs** (x1.5, x2, x2.5, x3) à certains rôles ou salons pour booster le gain d'XP. + +- Si un membre cumule plusieurs rôles avec boosts, **seul le boost le plus élevé** sera appliqué. +- Si un salon cumule les boosts d'une catégorie et d'un salon, **seul le boost du salon** sera appliqué. ::hint{ type="info" } - Vous trouverez ci-dessous le nombre exact d’expériences nécessaires pour passer au niveau supérieur. + Les boosts de rôles et de salons se cumulent entre eux. +:: + +### Options supplémentaires + +D'autres options avancées sont disponibles pour affiner le système : + +| Option | Description | +|--------|-------------| +| **Gain d'XP par message en vocal** | Lorsque cette option est activée, les messages textuels envoyés dans les salons vocaux rapportent de l'XP **uniquement si le membre est connecté en vocal** dans ce même salon. Si elle est désactivée, aucun message textuel dans les salons vocaux ne rapporte d'XP | +| **Longs messages comptent double** | Les messages de 250+ caractères (configurable 100-1500) donnent le double d'XP | +| **Voir les XP des autres utilisateurs** | Si désactivé, les membres ne voient que leur propre niveau via \. Dans ce cas, la commande devient éphémère (visible uniquement par l'utilisateur qui l'utilise). Les administrateurs peuvent toujours consulter les niveaux de tous les membres | +| **Réinitialiser l'XP au départ du serveur** | Si activé, les membres qui quittent le serveur perdent définitivement leur progression. S'ils reviennent, ils repartent de zéro | +| **Réinitialiser l'XP au bannissement** | Si activé, les membres bannis perdent définitivement leur progression | +| **Personnalisation de la couleur** | Changez la couleur des embeds et cartes de niveau (option premium <:icon_premium:1096140508625125417>) | + +::hint{ type="info" } + Vous trouverez ci-dessous le nombre d'XP nécessaire pour passer au niveau supérieur avec la courbe par défaut. + + ![Tableau des niveaux](../assets/niveaux/bot_experience_table.png) +:: + +### Courbe d'expérience personnalisable + +Vous pouvez modifier la **courbe d'expérience** pour ajuster la difficulté de progression des niveaux. Quatre courbes prédéfinies sont disponibles : + +| Courbe | Difficulté | Description | +|--------|------------|-------------| +| **Constant** | Fixe | Chaque niveau nécessite exactement la même quantité d'XP | +| **Linéaire** | Croissante modérée | Chaque niveau nécessite progressivement plus d'XP de manière linéaire | +| **Exponentielle** | Croissante rapide | La difficulté augmente de manière exponentielle, les hauts niveaux sont beaucoup plus difficiles à atteindre | +| **Custom** <:icon_premium:1096140508625125417> | Personnalisée | Définissez votre propre formule (réservé aux serveurs premium) | + +::hint{ type="success" } + **Multiplicateur de courbe** : Vous pouvez appliquer un multiplicateur global (x0.5, x1, x2, etc.) à la courbe sélectionnée pour ajuster la difficulté sans changer le style de progression. +:: + +::hint{ type="warning" } + **Important** : Lorsque vous modifiez la courbe d'XP, tous les niveaux des membres sont **automatiquement recalculés** en fonction de leur XP totale. Si vous rendez les niveaux plus difficiles à atteindre, certains membres peuvent perdre des niveaux et leurs récompenses associées ! +:: + +### Niveau maximum - ![Tableau des niveaux](../assets/niveaux/tableau_des_niveaux.png) +Les serveurs [premium](/premium) peuvent définir un **niveau maximum** pour plafonner la progression. Une fois ce niveau atteint, les membres **ne gagnent plus aucune expérience** jusqu'à ce que le plafond soit relevé ou supprimé. + +::hint{ type="info" } + L'XP gagnée pendant cette période n'est pas comptabilisée rétroactivement. :: ## Annonces de niveaux Chaque palier ne devrait pas passer inaperçu, c'est pour cela qu'il vous est possible de configurer des annonces lorsqu'un utilisateur passe un niveau. -Conditionnées par un niveau minimum, les annonces seront envoyées dans un salon spécifique pour ne pas déranger la conversation ou directement dans le salon actif afin de donner de permettre à tout le monde de fêter ce gain de niveau. +### Annonces de passage de niveau + +Vous pouvez configurer les annonces de montée de niveau avec **trois options** : -![Annonce d'un nouveau niveau](../assets/niveaux/annonces_niveaux.png) +- **Désactivées** : Aucune annonce n'est envoyée +- **Dans le salon actuel** : L'annonce apparaît dans le salon où le membre a gagné le niveau +- **Dans un salon dédié** : L'annonce est envoyée dans un salon spécifique que vous choisissez -## Configurer le système d'expérience +::hint{ type="info" } + **Niveau minimum** : Définissez un seuil (ex: niveau 10) pour éviter de spammer les petits niveaux. + + **Couleur personnalisée** <:icon_premium:1096140508625125417> : Les serveurs premium peuvent changer la couleur de l'embed d'annonce. +:: + +::hint{ type="warning" } + **Permissions requises** : Pour envoyer les annonces, DraftBot doit disposer des permissions suivantes dans le salon choisi : **Voir le salon**, **Envoyer des messages**, **Intégrer des liens** et **Joindre des fichiers**. Si ces permissions sont retirées, les annonces seront automatiquement désactivées. +:: + +#### Personnalisation du message + +Le message d'annonce est **entièrement personnalisable** avec des variables dynamiques : + +| Variable | Description | Exemple | +|----------|-------------|---------| +| `{user}` | Mention du membre | @DraftBot | +| `{user.id}` | ID du membre | 689210436019716137 | +| `{user.username}` | Nom d'utilisateur | DraftBot | +| `{user.nickname}` | Pseudo sur le serveur | Draft | +| `{user.globalname}` | Nom global Discord | DraftBot Official | +| `{level}` | Niveau atteint | 25 | +| `{server}` / `{server.name}` | Nom du serveur | Mon Super Serveur | +| `{server.id}` | ID du serveur | 382341865001844737 | +| `{server.membercount}` | Nombre de membres | 15000 | +| `{channel}` | Mention du salon | #général | +| `{channel.id}` | ID du salon | 923456789012345678 | +| `{channel.name}` | Nom du salon | général | +| `{date}`, `{time}`, `{timestamp}` | Date et heure actuelles | 15/01/2025 | + +### Annonces de récompenses + +Configurez des annonces **séparées** pour les récompenses de niveau. Elles utilisent les mêmes options et variables, avec en plus `{reward}` pour afficher la récompense obtenue. + +![Annonce d'un nouveau niveau](../assets/niveaux/bot_new_level_notif.png) + +## Configurer le système de niveaux ::tabs ::tab{ label="Depuis le panel" } [⫸ Accéder au panel de **DraftBot**](/dashboard/first/levels) - Pour activer le module, la première étape est de cliquer sur ce bouton : + Pour activer le module, la première étape est de cliquer sur le bouton en haut à droite : - ![Activation du système de niveaux depuis le Panel](../assets/niveaux/panel_activer_lvl.png) + ![Activation du système de niveaux depuis le Panel](../assets/niveaux/panel_enable.png) - Ensuite, l'ensemble des [fonctionnalités](#fonctionnalités-disponibles) apparaît : + Ensuite, l'ensemble des fonctionnalités apparaît : - ![Module économie activé sur le Panel](../assets/niveaux/panel_vue_d_ensemble.png) + ![Module économie activé sur le Panel](../assets/niveaux/panel_home.png) ::hint{type="warning"} - Une fois vos modifications terminées, n'oubliez pas d'enregistrer vos modifications avec le bouton "Enregistrer" situé en bas de page ! + Une fois vos modifications terminées, n'oubliez pas de les enregistrer avec le bouton "Enregistrer" situé en bas de page ! :: :: @@ -138,17 +279,17 @@ Conditionnées par un niveau minimum, les annonces seront envoyées dans un salo Si vous souhaitez effectuer toute la configuration directement depuis Discord, vous pouvez le faire via la commande \, puis en vous rendant dans l'onglet "Niveaux". Le menu ressemble alors à ceci : - ![Module Niveaux via la commande /config](../assets/niveaux/config_lvl_root.png) + ![Module Niveaux via la commande /config](../assets/niveaux/config_home.png) Le corps du **message** vous permet de consulter en un coup d'œil l'**état actuel** de votre système de niveaux, tandis que les **boutons** situés au-dessous vous permettent d'en **modifier la configuration**. ::collapse{ label="Statut" } Ce menu vous permet de : - - Activer / Désactiver le système de niveaux ; - - Activer / Désactiver le classement en ligne ; - - Activer / Désactiver le classement sur Discord (<:icon_premium:1096140508625125417>). + - Activer / Désactiver le système de niveaux + - Activer / Désactiver le classement en ligne + - Activer / Désactiver le classement sur Discord (<:icon_premium:1096140508625125417>) - ![Menu "Statut" via la commande /config](../assets/niveaux/config_lvl_statut.png) + ![Menu "Statut" via la commande /config](../assets/niveaux/config_status.png) ::hint{ type="success" } Lorsque vous activez le classement sur Discord, vous avez le choix entre utiliser un salon existant ou laisser DraftBot en créer un pour vous. Vous pouvez même définir le nombre de lignes du classement à afficher ! @@ -157,37 +298,37 @@ Conditionnées par un niveau minimum, les annonces seront envoyées dans un salo ::collapse{ label="Expérience" } Ce menu vous permet de : - - Activer / Désactiver / Régler l'expérience reçue à chaque message ; - - Activer / Désactiver / Régler l'expérience reçue en vocal (<:icon_premium:1096140508625125417>) ; - - Activer / Désactiver le gain d'expérience dans les fils ; - - Activer / Désactiver le gain d'expérience par message en vocal ; - - Activer / Désactiver/ Régler le double xp pour les messages longs ; - - Choisir si le niveau des membres quittant le serveur est remis à 0. - - ![Menu "Expérience" via la commande /config](../assets/niveaux/config_lvl_exp.png) + - Activer / Désactiver / Régler l'expérience reçue à chaque message + - Activer / Désactiver / Régler l'expérience reçue en vocal (<:icon_premium:1096140508625125417>) + - Activer / Désactiver le gain d'expérience dans les fils + - Activer / Désactiver le gain d'expérience par message en vocal + - Activer / Désactiver/ Régler le double xp pour les messages longs + - Choisir si le niveau des membres quittant le serveur est remis à 0 + + ![Menu "Expérience" via la commande /config](../assets/niveaux/config_experience.png) :: ::collapse{ label="Récompenses de niveaux" } Ce menu vous permet de configurer les récompenses de niveau, vous pouvez ainsi : - - Créer / Modifier / Supprimer une [récompense](#recompenses) ; + - Créer / Modifier / Supprimer une [récompense](#recompenses) - Réinitialiser les récompenses. - ![Menu "Récompenses de niveau" via la commande /config](../assets/niveaux/config_lvl_recompenses.png) + ![Menu "Récompenses de niveau" via la commande /config](../assets/niveaux/config_rewards.png) :: ::collapse{ label="Annonces" } Ce menu sert à configurer les annonces de changement de niveau et de récompenses. Vous pouvez : - Configurer les annonces de changement de niveau : - - Activer / Désactiver les annonces ; - - Choisir le salon où faire les annonces ; - - Configurer un niveau minimum pour les annonces ; - - Personnaliser le message d'annonce. + - Activer / Désactiver les annonces + - Choisir le salon où faire les annonces + - Configurer un niveau minimum pour les annonces + - Personnaliser le message d'annonce - Configurer les annonces d'obtention de récompenses : - - Activer / Désactiver les annonces ; - - Choisir le salon où faire les annonces ; - - Personnaliser le message d'annonce. + - Activer / Désactiver les annonces + - Choisir le salon où faire les annonces + - Personnaliser le message d'annonce - ![Menu "Annonces" via la commande /config](../assets/niveaux/config_lvl_annonces.png) + ![Menu "Annonces" via la commande /config](../assets/niveaux/config_notifs.png) :: ::collapse{ label="Limitations & Boosts" } @@ -197,15 +338,15 @@ Conditionnées par un niveau minimum, les annonces seront envoyées dans un salo - à quels rôles appliquer un multiplicateur (de x1.5 à x3), - à quels salons appliquer un multiplicateur (de x1.5 à x3). - ![Menu "Limitations & Boosts" via la commande /config](../assets/niveaux/config_lvl_limit_boost.png) + ![Menu "Limitations & Boosts" via la commande /config](../assets/niveaux/config_limits_boosts.png) :: ::collapse{ label="Personnalisation" } - Ce menu propose des personnalisations exclusives réservées aux serveurs (<:icon_premium:1096140508625125417>) : - - Définir un niveau maximum, - - personnaliser la couleur de l'interface des niveaux (par défaut : orange). + Ce menu propose des personnalisations exclusives réservées aux [serveurs premium](/premium) <:icon_premium:1096140508625125417> : + - Définir un niveau maximum + - Personnaliser la couleur de l'interface des niveaux (par défaut : orange) - ![Menu "Personnalisation" via la commande /config](../assets/niveaux/config_lvl_personnalisation.png) + ![Menu "Personnalisation" via la commande /config](../assets/niveaux/config_customization.png) :: ::hint{ type="info" } @@ -225,11 +366,11 @@ La configuration de base des récompenses se fait comme ceci : Pour activer les récompenses depuis le [**Panel**](/dashboard/first/levels), il faut tout d'abord activer l'interrupteur situé en face de "Configuration des récompenses" : - ![Bouton d'activation des récompenses depuis le panel](../assets/niveaux/bouton_recompenses.png) + ![Bouton d'activation des récompenses depuis le panel](../assets/niveaux/panel_rewards_button.png) Ensuite, deux options s'offrent à vous : - ![Menu des récompenses depuis le Panel DraftBot](../assets/niveaux/panel_recompenses.png) + ![Menu des récompenses depuis le Panel DraftBot](../assets/niveaux/panel_rewards.png) 1. **Créer une récompense** : cette option permet de créer et assigner des récompenses aux passages de niveaux de votre choix. *(Apprenez à [créer une récompense](#creer_une_recompense) ! )* @@ -237,11 +378,11 @@ La configuration de base des récompenses se fait comme ceci : ::collapse{ label="Voir comment configurer les annonces :" } Vous pouvez : - - Choisir si l'annonce doit être envoyée dans le salon actif, ou dans un salon dédié ; - - Créer ou sélectionner un salon dédié ; - - Personnaliser le message d'annonce. + - Choisir si l'annonce doit être envoyée dans le salon actif, ou dans un salon dédié + - Créer ou sélectionner un salon dédié + - Personnaliser le message d'annonce - ![Configuration des annonces depuis le Panel](../assets/niveaux/annonces_recompenses.png) + ![Configuration des annonces depuis le Panel](../assets/niveaux/panel_rewards_notifs.png) :: ::hint{ type="success" } @@ -252,10 +393,10 @@ La configuration de base des récompenses se fait comme ceci : ::tab{ label="Via la commande /config" } Via la commande \, cliquez sur le bouton "Récompenses de niveaux". Un menu permettant de configurer les récompenses s'affiche alors, il permet de : - - Créer / Modifier / Supprimer une [récompense](#creer_une_recompense) ; - - Réinitialiser les récompenses. + - Créer / Modifier / Supprimer une [récompense](#creer_une_recompense) + - Réinitialiser les récompenses - ![Menu "Récompenses" via la commande /config](../assets/niveaux/config_lvl_recompenses.png) + ![Menu "Récompenses" via la commande /config](../assets/niveaux/config_bot_rewards.png) :: :: @@ -263,54 +404,80 @@ La configuration de base des récompenses se fait comme ceci : DraftBot vous permet de récompenser l'activité de vos membres à travers des items de types variables : -![Menu de création de récompenses, depuis le panel](../assets/niveaux/creation_recompense.png) +![Menu de création de récompenses, depuis le panel](../assets/niveaux/panel_creation_recompense.png) ::tabs ::tab{ label="Rôle" } Vous pouvez permettre à vos membres d'acquérir des rôles (temporaires ou permanents) lorsqu'ils atteignent un niveau défini. Pour ajouter un rôle aux récompenses, sélectionnez le type de récompense **"rôle"** ou **"rôle temporaire"**. Choisissez ensuite : - - Le niveau requis ; - - Le rôle à attribuer ; - - La durée du rôle *(dans le cas d'un rôle temporaire)*. + - Le niveau requis + - Le rôle à attribuer + - Le mode de cumul : **Cumulatif** ou **Évolutif** + - La durée du rôle *(dans le cas d'un rôle temporaire)* + + ::hint{ type="info" } + **Rôle Cumulatif** : Le membre conserve tous les rôles de récompense obtenus (niveau 5, 10, 15, etc.). + + **Rôle Évolutif** : Seul le rôle du dernier niveau atteint est conservé. Les anciens rôles de récompense évolutifs sont automatiquement retirés lors du prochain gain d'XP. + :: + + ::hint{ type="success" } + Dans la commande \, un indicateur **🔹** s'affiche à côté des récompenses de rôle configurées en mode **Évolutif**, permettant de les repérer facilement. + :: ::hint{ type="warning" } Le rôle sélectionné doit avoir été créé au préalable sur votre serveur, et être accessible à DraftBot (donc ne pas être situé plus haut que le rôle le plus élevé de DraftBot). :: + + **Comportements particuliers :** + + - **Saut de niveaux** : Si un membre saute plusieurs niveaux d'un coup (via \), il reçoit **toutes les récompenses** des niveaux intermédiaires qu'il n'a pas encore obtenues. Par exemple, si un membre passe directement du niveau 5 au niveau 25, il recevra les récompenses des niveaux 10, 15, 20 et 25. Pour les rôles **évolutifs**, seul le rôle du niveau le plus élevé sera conservé. + - **Perte de niveaux** : Si un membre descend en dessous du niveau requis (via \ ou modification de la courbe d'XP), les rôles de récompense sont **automatiquement retirés**. Les récompenses d'argent, d'objets et personnalisées ne seront pas retirées. :: ::tab{ label="Argent" } - Si le [système d'économie](/docs/modules/economie) est activé, vous pouvez permettre à vos membres d'obtenir de l'argent de serveur pour récompenser leur montée de niveau. Pour ajouter une somme d'argent à la boutique, sélectionnez le type de récompense **"De l'argent"**. + Si le [système d'économie](/docs/modules/economie) est activé, vous pouvez récompenser vos membres avec de l'argent virtuel du serveur. - Choisissez ensuite : - - Le niveau requis ; - - La somme d'argent à accorder. + Choisissez : + - Le niveau requis + - La somme d'argent à accorder + + ::hint{ type="warning" } + Le système d'économie doit être **activé** sur votre serveur pour utiliser ce type de récompense. Si vous le désactivez, un avertissement s'affichera lors de la configuration. + :: + + ::hint{ type="info" } + Contrairement aux rôles, l'argent donné **ne peut pas être retiré automatiquement** si le membre perd son niveau. + :: :: ::tab{ label="Objet Inventaire" } - Vous pouvez créer des objets fictifs à ajouter à l'inventaire. Pour offrir des objets d'inventaire en récompense au passage d'un niveau, sélectionnez le type de récompense **"Un objet d'inventaire"**. + Récompensez vos membres avec des [objets d'inventaire](/docs/modules/inventaire) personnalisés et fictifs. - Choisissez ensuite : - - Le niveau requis ; - - L'objet à accorder ; - - Le nombre de cet objet devant être donné. + Choisissez : + - Le niveau requis + - L'objet à accorder (parmi ceux existant ou en créer un nouveau) + - La quantité de cet objet (jusqu'à 1 million) ::hint{ type="info" } - Si vous n'avez pas encore d'objets en boutique, vous pouvez en [créer directement](#creer-des-objets-d-inventaire) ! + Comme l'argent, les objets donnés **ne peuvent pas être retirés automatiquement** si le membre perd son niveau. :: :: ::tab{ label="Article Personnalisé" } - Si vous souhaitez permettre à vos membres d'acquérir d'autres articles, comme par exemple des codes promotionnels, des clés d'activation numériques, ou bien des objets "réels", DraftBot a la solution ! - - Pour ajouter un article personnalisé aux récompenses, sélectionnez le type d'article **"Un article personnalisé"**. + Offrez des récompenses **en dehors de Discord** : codes promotionnels, clés de jeux, goodies physiques, abonnements, etc. - Choisissez ensuite : - - Le niveau requis ; - - Le nom de l'article. + Choisissez : + - Le niveau requis + - Le nom/description de l'article (jusqu'à 250 caractères) ::hint{ type="success" } - Lorsqu'un membre gagnera cet item, vous serez notifié par DraftBot dans vos messages privés, et vous pourrez ainsi lui remettre "en main propre". + **Comment ça fonctionne ?** Lorsqu'un membre obtient cette récompense, **vous recevez une notification par message privé de DraftBot** avec les informations du membre. Vous pouvez alors lui remettre la récompense "en main propre" comme vous le souhaitez. + :: + + ::hint{ type="info" } + Idéal pour des récompenses uniques : accès à un salon privé, session de coaching, goodies personnalisés, etc. :: :: :: @@ -323,15 +490,10 @@ DraftBot vous permet de récompenser l'activité de vos membres à travers des i Si vous utilisiez déjà un système de niveaux via MEE6, vous avez la possibilité d'importer la progression de vos membres au système de niveaux de DraftBot ! -![Bouton d'importation des niveaux](../assets/niveaux/import_levels.png) +![Bouton d'importation des niveaux](../assets/niveaux/config_import.png) Après avoir cliqué sur **Importer MEE6**, et confirmé que vous souhaitez procéder à l'importation, DraftBot récupèrera automatiquement toutes les informations de niveaux des membres. ::hint{ type="warning" } Assurez-vous que MEE6 est présent sur votre serveur et que son classement est accessible publiquement ! :: - - - - - diff --git a/docs/2.modules/3.economie.md b/docs/2.modules/3.economie.md index f92197ed3..f211e630b 100644 --- a/docs/2.modules/3.economie.md +++ b/docs/2.modules/3.economie.md @@ -1,57 +1,247 @@ --- title: Économie -description: Envie d'égayer davantage la vie sur votre serveur ? Alors, activez le système d'économie et laissez-vous guider par DraftBot ! +description: Créez une économie virtuelle sur votre serveur Discord avec DraftBot ! Permettez à vos membres de gagner de l'argent, d'acheter des objets dans des boutiques personnalisées et de consulter leur richesse dans les classements. navigation.icon: 'twemoji:money-bag' -contributors: ['bariboo', 'clement669', 'theorik', 'ls62', 'rababio4579', 'imroxxor'] -updatedAt: '2025-03-04' +redactors: ['clement669', 'draftproducts'] +contributors: ['bariboo', 'clement669', 'theorik', 'ls62', 'rababio4579', 'draftproducts'] +updatedAt: '2025-11-11' --- -## Introduction +## Consulter votre argent -Le module d'économie de DraftBot comprend deux parties : +Pour consulter votre solde personnel, utilisez la commande \. -1. Le système d'économie -2. La boutique +![Carte renvoyée par la commande /argent](../assets/economie/bot_money.png) -Ces deux systèmes peuvent être configurés depuis le [**panel** de DraftBot](/dashboard/first/economy), ou depuis Discord via la commande \. +::hint{ type="info" } + Pour consulter le solde d'un autre membre, ajoutez simplement sa mention en argument de la commande \. +:: + +## Commandes + +Il existe plusieurs commandes pratiques pour rendre l'intégration du système d'économie aussi fluide que possible pour vous. + +| Commande | Description | +|----------|-------------| +| \ (ou \) | Permet de récolter sa somme quotidienne. | +| \ | Crée un message qui offre une somme d'argent au premier qui clique sur le bouton. | +| \ | Permet d'afficher la quantité d'argent que vous, ou un autre membre, possédez. | +| \ | Permet de donner de son argent au membre ciblé. | +| \ | Permet d'afficher la [boutique du serveur](#les-boutiques). | +| \ | Permet d'afficher le [classement](#classement) des membres. | + +::hint{ type="info" } + Lors de l'utilisation de \, vous pouvez définir la durée du drop (maximum 10 minutes) ! + + ![Utilisation de la commande /dropargent](../assets/economie/bot_dropmoney.png) +:: + +## Boutique + +La boutique accessible depuis le \ permet à vos membres d'acheter des articles mis en place par vos soins ! + +![Interface de la boutique](../assets/economie/bot_shops.png) + +- **Pagination** : Les articles sont affichés par page de 5 articles maximum +- **Tri des articles** : 6 options de tri disponibles (date de création, prix croissant/décroissant, nom alphabétique, type) +- **Sélection de boutique** : Si plusieurs boutiques existent, un menu de sélection s'affiche automatiquement +- **Achat sécurisé** : Confirmation requise avant chaque achat + +| Type | Description | Exemple | +|------|-------------|---------| +| **Rôle** | Attribution d'un rôle Discord | Rôle "VIP" pour 5000 💰 | +| **Rôle temporaire** | Attribution d'un rôle pour une durée limitée | Rôle "Boost 7 jours" pour 2000 💰 | +| **Expérience** | Points d'XP du [système de niveaux](/docs/modules/niveaux) | 1000 XP pour 500 💰 | +| **Objet d'inventaire** | Un ou plusieurs [objets d'inventaire](/docs/modules/inventaire) | 3x "Potion de chance" pour 1500 💰 | +| **Article personnalisé** | Une récompense que vous remettez manuellement | Code promo, goodies physiques, etc. | + +::hint{ type="info" } + Vous pouvez créer jusqu'à **10 articles**. Les serveurs [premium](/premium) n'ont pas de limite et peuvent créer jusqu'à **5 boutiques** ! +:: + +::hint{ type="success" } + Si vous avez configuré plusieurs boutiques, vos membres peuvent facilement basculer entre elles via le menu déroulant en bas de l'interface ! +:: + +## Gain d'argent + +L'argent peut être gagné de diverses manières sur votre serveur. Vous contrôlez entièrement comment et où vos membres accumulent leur richesse. + +### Argent par message + +La méthode principale pour gagner de l'argent est la **participation écrite** dans le serveur. Chaque message rapporte une quantité d'argent **aléatoire** comprise entre deux valeurs que vous configurez (par défaut entre **15 et 25 💰**). + +::hint{ type="info" } + Un **cooldown de 30 secondes** s'applique entre chaque gain d'argent pour un même membre. Cela évite le spam et encourage les conversations de qualité. +:: + +### Argent en vocal + +Les serveurs [premium](/premium) <:icon_premium:1096140508625125417> peuvent activer le gain d'argent en fonction de l'**activité vocale**. Chaque membre actif en vocal gagne une quantité d'argent aléatoire (15 à 25 💰 par défaut, configurable) **toutes les 2 minutes**. + +::hint{ type="info" } + **Conditions requises** pour gagner de l'argent en vocal : + - L'utilisateur ne doit **pas être muet** ou **en sourdine** (ni auto-sourdine, ni sourdine serveur). + - Le salon ne doit **pas être un salon de conférence** (stage) ou configuré comme **salon AFK** (dans les paramètres Discord). + - **Au moins 2 membres humains** doivent être présents et actifs (non muets/sourdine) dans le même salon. + + Si ces conditions ne sont plus remplies, le membre cesse de gagner de l'argent jusqu'à ce qu'elles soient à nouveau respectées. +:: + +::hint{ type="info" } + Cette fonctionnalité est réservée aux serveurs [premium](/premium) <:icon_premium:1096140508625125417>. +:: + +### Autres gains d'argent + +Grâce à l'**écosystème** de DraftBot, vous pouvez offrir de l'argent via d'autres fonctionnalités : +- **Giveaways** : Offrez de l'argent en récompense +- **Argent de départ** : Définissez une somme donnée aux nouveaux membres +- **Daily/Journalier** : Récompense quotidienne réclamable via \ +- **Cadeaux d'anniversaires** : Offrez de l'argent automatiquement +- **Drop d'argent** (\) : Créez des événements interactifs où le premier à cliquer gagne +- **Calendrier de l'avent** : Récompenses quotidiennes en décembre +- **Commandes personnalisées** : Créez toutes sortes de commandes en lien avec l'économie + +### Fils de discussion et forums + +Le système d'économie distingue deux types d'espaces de discussion : + +- **Les fils de discussion (threads)** : créés dans les salons textuels ou d'annonces. Leur gain d'argent peut être activé/désactivé via l'option **"Gain d'argent dans les fils de discussions"**. +- **Les posts de forums** : messages publiés dans les salons de type Forum. Leur gain d'argent est contrôlé par l'option **"Gain d'argent dans les posts"**. + +::hint{ type="info" } + Les fils de discussion et posts de forums **héritent automatiquement** des paramètres de leur salon parent concernant les listes blanches/noires et les multiplicateurs. +:: + +### Listes blanches et noires + +Les listes de **rôles** et **salons** vous permettent de contrôler finement qui peut gagner de l'argent et où : -## Configurer l'économie +- **Mode "avec" (whitelist)** : Seuls les membres/salons listés peuvent gagner de l'argent. Pour les rôles, il suffit qu'un membre possède **au moins un** rôle autorisé pour gagner de l'argent, même s'il possède d'autres rôles non listés. +- **Mode "sans" (blacklist)** : Les membres/salons listés ne peuvent **pas** gagner d'argent. Si un membre possède au moins un rôle interdit, il ne gagnera pas d'argent. + +### Multiplicateurs d'argent + +Vous pouvez appliquer des **multiplicateurs** (x1.5, x2, x2.5, x3) à certains rôles ou salons pour booster le gain d'argent. + +- Si un membre cumule plusieurs rôles avec boosts, **seul le boost le plus élevé** sera appliqué. +- Si un salon cumule les boosts d'une catégorie et d'un salon, **seul le boost du salon** sera appliqué. + +::hint{ type="info" } + Les boosts de rôles et de salons se cumulent entre eux. +:: + +### Options supplémentaires + +D'autres options avancées sont disponibles pour affiner le système : + +| Option | Description | +|--------|-------------| +| **Gain d'argent par message en vocal** | Lorsque cette option est activée, les messages textuels envoyés dans les salons vocaux rapportent de l'argent **uniquement si le membre est connecté en vocal** dans ce même salon. Si elle est désactivée, aucun message textuel dans les salons vocaux ne rapporte d'argent. | +| **Longs messages comptent double** | Les messages de 250+ caractères (configurable 100-1500) donnent le double d'argent. | +| **Voir l'argent des autres utilisateurs** | Si désactivé, les membres ne voient que leur propre solde via \ et la commande \ devient inaccessible. Dans ce cas, la commande devient éphémère (visible seulement par l'utilisateur qui l'utilise). Les administrateurs peuvent toujours consulter l'argent de tous les membres. | +| **Réinitialiser l'argent au départ du serveur** | Si activé, les membres qui quittent le serveur perdent définitivement leur argent. S'ils reviennent, ils repartent de zéro. | +| **Réinitialiser l'argent au bannissement** | Si activé, les membres bannis perdent définitivement leur argent. | +| **Argent de départ** | Définissez une somme d'argent donnée automatiquement aux nouveaux membres rejoignant le serveur. | +| **Argent quotidien (Daily)** | Configurez la somme réclamable quotidiennement via la commande \ ou \. | +| **Personnalisation de la devise** | Changez l'émoji de votre monnaie (option premium <:icon_premium:1096140508625125417>). | +| **Personnalisation de la couleur** | Changez la couleur des embeds et cartes d'économie (option premium <:icon_premium:1096140508625125417>). | + +## Classement + +Vous pouvez afficher le classement des membres, du plus riche au moins riche, de trois façons : + +### Commande /topargent + +Vous pouvez afficher le classement via la commande \. + +![Résultat de la commande /topargent](../assets/economie/bot_topargent.png) + +::hint{ type="success" } + Si vous souhaitez afficher un nombre spécifique de lignes (seulement le top 3 par exemple), vous pouvez ajouter ce nombre en argument de la commande \. +:: + +::hint{ type="info" } + Si l'option **"Voir l'argent des autres utilisateurs"** est désactivée, les membres ne peuvent consulter que leur propre solde avec \ ou accéder au \. Pour désactiver le classement en ligne, rendez-vous dans la section [classement en ligne](#classement-en-ligne). +:: + +### Classement en ligne + +Vous pouvez le consulter depuis le bouton **"Voir l'ensemble du classement"** de la commande \. + +![Classement en ligne](../assets/economie/panel_classement_web.png) + +::hint{ type="info" } + Si vous êtes administrateur du serveur, vous pouvez également y accéder depuis le [**panel**](/dashboard/first/economy) dans le module **Économie** via le bouton **"Accéder au classement"**. +:: + +::hint{ type="info" } + Si vous souhaitez désactiver le classement en ligne, une option est prévu à cet effet depuis [le panel](/dashboard/first/economy#economy_leaderboards) ou depuis le \. +:: + +### Classement en temps réel + +Pour les serveurs [premium](/premium) <:icon_premium:1096140508625125417>, il est possible de mettre en place dans un salon dédié un classement des membres en temps réel et mis à jour automatiquement. + +![Classement Discord automatique](../assets/economie/bot_classement_discord_auto.png) + +::hint{ type="success" } + L'avantage de cette fonctionnalité est que le message affichant le classement peut afficher jusqu'à 25 membres et sera réactualisé toutes les 10 minutes automatiquement, sauf s'il n'y a pas de changements ! +:: + +## Gérer l'argent des membres + +En tant qu'administrateur, vous disposez de plusieurs commandes pour gérer l'argent des membres : + +| Commande | Description | +|----------|-------------| +| \ | Crée un message avec un bouton : le **premier membre** à cliquer gagne l'argent. Vous pouvez définir une durée limite (maximum **10 minutes**). | +| \ | Ajouter de l'argent à un membre spécifique. | +| \ | Retirer de l'argent à un membre. | +| \ | Définir exactement le montant d'argent d'un membre (remplace son argent actuel). | +| \ | Transférer de l'argent d'un membre à un autre (le donneur perd l'argent transféré). | +| \ | **Réinitialiser tout l'argent du serveur**. Cette action est irréversible ! | + +::hint{ type="info" } + Les commandes admin ne peuvent être utilisées que par les membres de votre serveur possédant la **permission administrateur**. +:: + +## Configurer le système d'économie ::tabs ::tab{ label="Depuis le panel" } [⫸ Accéder au panel de **DraftBot**](/dashboard/first/economy) - La première étape pour activer le système est de cliquer sur ce bouton : + Pour activer le module, la première étape est de cliquer sur le bouton en haut à droite : - ![Activation du système d'économie](../assets/economie/dashboard_activate_system.png) + ![Activation du système d'économie depuis le panel](../assets/economie/panel_economy_enable.png) - Ensuite, l'ensemble des [fonctionnalités](#fonctionnalités-disponibles) apparaît : + Ensuite, l'ensemble des fonctionnalités apparaît : - ![Module économie activé sur le Panel](../assets/economie/panel_vue_d_ensemble.png) + ![Module économie activé sur le Panel](../assets/economie/panel_all.png) ::hint{type="warning"} - Une fois vos modifications terminées, n'oubliez pas d'enregistrer vos modifications avec le bouton "Enregistrer" situé en bas de page ! + Une fois vos modifications terminées, n'oubliez pas de les enregistrer avec le bouton "Enregistrer" situé en bas de page ! :: :: ::tab{ label="Via la commande /config" } - Si vous souhaitez effectuer toute la configuration directement depuis [Discord](https://discord.com/), vous pouvez le faire via la commande \, puis en vous rendant dans l'onglet "Économie". Le menu ressemble alors à ceci : + Si vous souhaitez effectuer toute la configuration directement depuis Discord, vous pouvez le faire via la commande \, puis en vous rendant dans l'onglet "Économie". Le menu ressemble alors à ceci : - ![Module économie via la commande /config](../assets/economie/config_eco_root.png) + ![Module économie via la commande /config](../assets/economie/config_home.png) Le corps du **message** vous permet de consulter en un coup d'œil l'**état actuel** de votre système économique, tandis que les **boutons** situés au-dessous vous permettent d'en **modifier la configuration**. - Voici le détail de chaque bouton : - ::collapse{ label="Statut" } Ce menu vous permet de : - - Activer / Désactiver le système d'économie, - - Activer / Désactiver le classement en ligne, - - Activer / Désactiver le classement sur Discord (<:icon_premium:1096140508625125417>). + - Activer / Désactiver le système d'économie + - Activer / Désactiver le classement en ligne + - Activer / Désactiver le classement sur Discord (<:icon_premium:1096140508625125417>) - ![Menu "Statut" via la commande /config](../assets/economie/config_eco_statut.png) + ![Menu "Statut" via la commande /config](../assets/economie/config_status.png) ::hint{ type="success" } Lorsque vous activez le classement sur Discord, vous avez le choix entre utiliser un salon existant ou laisser DraftBot en créer un pour vous. Vous pouvez même définir le nombre de lignes du classement à afficher ! @@ -60,172 +250,127 @@ Ces deux systèmes peuvent être configurés depuis le [**panel** de DraftBot](/ ::collapse{ label="Argent" } Ce menu vous permet de : - - Activer / Désactiver / Régler la somme reçue à chaque message, - - Activer / Désactiver / Régler la somme reçue en vocal (<:icon_premium:1096140508625125417>), - - Configurer la somme réclamable quotidiennement via la commande \ (ou \), - - Activer / Désactiver le gain d'argent *(du serveur)* dans les fils, - - Activer / Désactiver le gain d'argent par message en vocal, - - Activer / Désactiver/ Régler les gains x2 pour les messages longs, - - Choisir si l'argent des membres quittant le serveur est remis à 0. - - ![Menu "Argent" via la commande /config](../assets/economie/config_eco_argent.png) - :: - - ::collapse{ label="Boutique" } - Ce menu vous permet de configurer la boutique de votre serveur, vous pouvez ainsi : - - Créer / Modifier / Supprimer un [article de la boutique](#articles-de-boutique), - - Modifier le [type de boutique](#type-de-boutique), - - Réinitialiser la boutique. - - ![Menu "Boutique" via la commande /config](../assets/economie/config_eco_boutique.png) + - Activer / Désactiver / Régler la somme reçue à chaque message + - Activer / Désactiver / Régler la somme reçue en vocal (<:icon_premium:1096140508625125417>) + - Configurer la somme réclamable quotidiennement via la commande \ (ou \) + - Configurer l'argent de départ donné aux nouveaux membres + - Activer / Désactiver le gain d'argent dans les fils + - Activer / Désactiver le gain d'argent dans les posts de forums + - Activer / Désactiver le gain d'argent par message en vocal + - Activer / Désactiver / Régler les gains x2 pour les messages longs + - Choisir si l'argent des membres quittant le serveur est remis à 0 + - Choisir si l'argent des membres bannis est remis à 0 + + ![Menu "Argent" via la commande /config](../assets/economie/config_money.png) :: ::collapse{ label="Limitations & Boosts" } - Ce menu sert à configurer des gains différents en fonction du rôle d'un membre ou du salon dans lequel il poste un message. Vous pouvez : - - Définir quels rôles ne sont pas autorisés à gagner d'argent, - - Définir quels salons ne sont pas autorisés à gagner d'argent, - - Définir à quels rôles appliquer un multiplicateur (de x1.5 à x3), - - Définir à quels salons appliquer un multiplicateur (de x1.5 à x3). + Ce menu sert à configurer des gains différents en fonction du rôle d'un membre ou du salon dans lequel il poste un message. Vous pouvez définir : + - Pour quels rôles activer/désactiver le gain d'argent, + - dans quels salons activer/désactiver le gain d'argent, + - à quels rôles appliquer un multiplicateur (de x1.5 à x3), + - à quels salons appliquer un multiplicateur (de x1.5 à x3). - ![Menu "Limitations & Boosts" via la commande /config](../assets/economie/config_eco_limit_boost.png) + ![Menu "Limitations & Boosts" via la commande /config](../assets/economie/config_limits_boosts.png) :: ::collapse{ label="Personnalisation" } - Ce menu propose des personnalisations exclusives réservées aux serveurs [premium](/premium) <:icon_premium_:1096140508625125417> : - - Personnaliser l'émoji de votre monnaie, - - Personnaliser la couleur de l'interface d'économie (vert par défaut). + Ce menu propose des personnalisations exclusives réservées aux serveurs [<:icon_premium:1096140508625125417> Premium](/premium) : + - Personnaliser l'émoji de votre monnaie + - Personnaliser la couleur de l'interface d'économie (vert par défaut) - ![Menu "Personnalisation" via la commande /config](../assets/economie/config_eco_personnalisation.png) + ![Menu "Personnalisation" via la commande /config](../assets/economie/config_custom.png) ::hint{ type="success" } Lorsque vous personnalisez la devise, vous pouvez même utiliser les émojis personnalisés de votre serveur ! - ![Exemple de devise personnalisée](../assets/economie/exemple_devise_perso.png) + ![Exemple de devise personnalisée](../assets/economie/panel_custom_currency.png) :: :: ::hint{ type="info" } - Les fonctionnalités accompagnées du symbole <:icon_premium:1096140508625125417> sont réservées aux serveurs [premium](/premium) <:icon_premium_:1096140508625125417>. + Les fonctionnalités accompagnées du symbole <:icon_premium:1096140508625125417> sont réservées aux <:icon_premium:1096140508625125417>[serveurs premium](/premium) ! :: :: :: -::hint{ type="success" } - Pour consulter votre solde personnel, utilisez la commande \. Pour consulter le solde d'un autre membre, ajoutez simplement sa mention en argument de la fonction \. - - ::collapse{ label="Afficher un exemple :" } - ![Carte renvoyée par la commande /argent](../assets/economie/money.png) - :: -:: - -## Gain d'argent - -L'argent peut être gagné de diverses manières, la plus répandue étant la **participation écrite** dans le serveur. - -Chaque message dans une fenêtre de 30 secondes rapporte une quantité d'argent comprise entre deux valeurs configurées (15 à 25 💰 par défaut). +## Configurer les boutiques -Grâce à l'**écosystème** de DraftBot, il vous sera possible de faire gagner de l'argent aux membres de plusieurs autres manières : Giveaways, Cadeaux d'anniversaires, Drop d'argent dans les salons et Calendrier de l'avent. - -Les serveurs [premium](/premium) <:icon_premium_:1096140508625125417> pourront profiter d'un gain d'argent en fonction de l'**activité vocale** : Chaque membre en vocal considéré comme actif, gagnera une quantité d'argent comprise entre deux valeurs configurées (15 à 25 💰 par défaut) toutes les 2 minutes. - -::hint{ type="info" } - Le gain d'**argent en vocal** est soumis à plusieurs conditions : - - L'utilisateur ne doit pas être muet ou en sourdine (ni auto-sourdine, ni sourdine serveur). - - Le salon ne doit pas être un salon de conférence ou un salon configuré comme AFK (configuration Discord). - - Au moins 2 utilisateurs humains doivent être présents (non muet ou en sourdine) dans le même salon vocal. -:: +::tabs + ::tab{ label="Depuis le panel" } -Afin de gérer votre serveur avec granularité, il vous sera possible de bloquer/booster le gain d'argent en fonction de conditions et dans d'autres cas plus avancés de le réinitialiser. + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/economy) -## Fonctionnalités disponibles + Pour créer une boutique depuis le [**Panel**](/dashboard/first/economy), cliquez sur le bouton **"Créer une boutique"** dans la section "Configuration des boutiques" : -Avec DraftBot, *vous* êtes aux commandes ! Le système d'économie permet un très grand niveau de personnalisation pour s'adapter à vos besoins. Voici les fonctionnalités configurables : + ![Bouton de création de boutique depuis le panel](../assets/economie/panel_shop_enable.png) -::collapse{ label="Afficher / masquer la liste de fonctionnalités" } + Une fenêtre s'ouvre pour configurer votre nouvelle boutique : - | **NOM** | **EXPLICATION** | | - |---------|-----------------|--| - | **Argent par message** | Modifier ou désactiver la somme gagnée à chaque message envoyé | | - | **Argent de départ** | Modifier la somme de base reçue en rejoignant le serveur | | - | **Rôles avec/sans gain d'argent** | Restreindre le gain d'argent à certains rôles | | - | **Rôles boosters** | Régler des multiplicateurs de gains pour certains rôles | | - | **Devise personnalisée** | Personnaliser l'icône de votre devise | <:icon_premium:1096140508625125417> | - | **Argent pour 2 minutes en vocal** | Définir la somme gagnée en vocal | <:icon_premium:1096140508625125417> | - | **Argent quotidien** | Régler la somme réclamable chaque jour via \ | | - | **Salons avec/sans gain d'argent** | Restreindre le gain d'argent à certains salons | | - | **Salons boosters** | Régler des multiplicateurs de gains pour certains salons | | - | **Couleur de l'économie** | Personnaliser la couleur de l'interface économie | <:icon_premium:1096140508625125417> | -:: + ![Menu de création de boutique](../assets/economie/panel_shops.png) -En plus de ces fonctionnalités, 6 options à activer/désactiver vous permettent d'aller encore plus loin dans la configuration de votre économie : + **Paramètres de la boutique :** + - **Nom** : Le nom de votre boutique (50 caractères maximum) + - **Description** : Une description de la boutique (500 caractères maximum) + - **Style** : Choisissez entre "Classique" ou "Marché noir" -::collapse{ label="Afficher / masquer la liste des options" } + ::hint{ type="info" } + Si votre serveur possède déjà des boutiques, elles apparaîtront en bas de l'écran, et vous pourrez les modifier / supprimer. + :: + :: - | **NOM** | **EXPLICATION** | | - |---------|-----------------|--| - | **Gain d'argent dans les fils de discussions** | Autoriser ou non les membres à gagner de l'argent dans les fils | | - | **Classement en ligne** | Activer ou non l'affichage du classement sur le web | | - | **Classement sur Discord** | Activer ou non l'affichage dynamique du classement sur le serveur | <:icon_premium:1096140508625125417> | - | **Réinitialisation argent** | Définir si les membres perdent leur argent en quittant le serveur | | - | **Gain d'argent par message en vocal** | Définir si les messages textuels envoyés dans les salons vocaux rapportent de l'argent ou non | | - | **Longs messages comptent double** | Définir si les longs messages donnent le double de points | | + ::tab{ label="Via la commande /config" } + Via la commande \, accédez au menu "Économie" puis "Boutique". Vous pourrez alors créer, modifier ou supprimer des boutiques. - ::hint{ type="success" } - Pour la configuration "Longs messages comptent double", vous pouvez même spécifier à partir de combien de caractères un message est considéré comme "long" (250 par défaut) ! - :: + ![Menu de sélection d'une boutique](../assets/economie/config_shops.png) - ::hint{ type="info" } - Lorsque vous activez le Classement sur Discord, vous avez le choix entre utiliser un salon existant ou laisser DraftBot en créer un pour vous. Vous pouvez aussi choisir combien de lignes du classement doivent être affichées (10 par défaut). + ![Menu "Boutique" via la commande /config](../assets/economie/config_shop.png) :: :: ::hint{ type="info" } - Les fonctionnalités ou options accompagnées du symbole <:icon_premium:1096140508625125417> sont réservées aux serveurs [premium](/premium) <:icon_premium_:1096140508625125417>. - . + Les serveurs [premium](/premium) <:icon_premium:1096140508625125417> peuvent créer jusqu'à 5 boutiques. :: +### Personnaliser votre boutique + +Une fois votre boutique créée, vous pouvez la personnaliser davantage : -## La boutique -Une fois configurée, la boutique permettra aux membres de votre serveur d'échanger leurs devises contre des items de votre choix. Il peut s'agir de rôles (temporaires ou non), de points d'expérience, d'objets d'inventaire, et même d'articles personnalisés ! +| Paramètre | Description | Premium | +|-----------|-------------|---------| +| **Emoji** | Ajoutez un emoji qui s'affichera à côté du nom de la boutique | | +| **Description** | Choisissez une description pour créer l'histoire de votre boutique | | +| **Style** | Choisissez entre "Classique" ou "Marché noir" | | +| **Tri par défaut** | Définissez l'ordre de tri par défaut des articles | | +| **Conditions d'accès** | Restreignez l'accès à la boutique selon des conditions (rôles, niveaux, etc.) | | +| **Couleur** | Personnalisez la couleur de l'interface de la boutique | <:icon_premium:1096140508625125417> | +| **Bannière** | Ajoutez une image de bannière en haut de la boutique (800x137px recommandé) (10Mo max) | <:icon_premium:1096140508625125417> | +### Créer un article de boutique -### Configurer la boutique -La configuration de base de la boutique se fait comme ceci : +Pour ajouter des articles à votre boutique : ::tabs ::tab{ label="Depuis le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/economy#shops) - [⫸ Accéder au panel de **DraftBot**](/dashboard/first/economy) - - Pour activer la boutique depuis le [**Panel**](/dashboard/first/economy), il faut tout d'abord activer l'interrupteur situé en face de "Configuration de la boutique" : - - ![Bouton d'activation de la boutique depuis le panel](../assets/economie/bouton_boutique.png) - - Ensuite, deux options s'offrent à vous : + 1. Cliquez sur le bouton **"Modifier"** de la boutique concernée + 2. Cliquez sur **"Créer un article"** - - Créer un [article](#articles-de-boutique) - - Configurer le [type de boutique](#type-de-boutique) - - ![Menu de la boutique depuis le panel](../assets/economie/accueil_boutique_panel.png) - - ::hint{ type="info" } - Si votre boutique comporte déjà des articles, ils apparaîtront en bas de l'écran, et vous pourrez les modifier / supprimer. - :: + ![Menu de création d'article](../assets/economie/panel_create_article.png) :: ::tab{ label="Via la commande /config" } - Via la commande \, un menu permettant de configurer la boutique s'affiche, il permet de : - - - Créer / Modifier / Supprimer un [article de boutique](#articles-de-boutique) - - Modifier le [type de boutique](#type-de-boutique) - - Réinitialiser la boutique + Via la commande \, accédez au menu "Économie" > "Boutique" > "Créer / Modifier / Supprimer un article". - ![Menu "Boutique" via la commande /config](../assets/economie/config_eco_boutique.png) + ![Décrivez l'image](../assets/economie/config_articles.png) :: :: - -### Articles de boutique -DraftBot vous permet d'intégrer à votre boutique des items de types variables : +**Informations communes à tous les types d'articles :** +- **Type** : Le type d'article (rôle, rôle temporaire, expérience, objet, personnalisé) +- **Prix** : Le coût de l'article en argent du serveur +- **Description** : Une description de l'article (1000 caractères maximum) +- **Stock** : Quantité disponible (voir la section [Stock d'un article](#stock-dun-article)) ::tabs ::tab{ label="Rôle" } @@ -237,22 +382,35 @@ DraftBot vous permet d'intégrer à votre boutique des items de types variables - La description de l'article - La durée du rôle *(dans le cas d'un rôle temporaire)* - ![Menu de vente de rôles, temporaire (à gauche) et classique (à droite)](../assets/economie/vente_roles.png) + ![Menu de vente de rôles, temporaire (à gauche) et classique (à droite)](../assets/economie/panel_article_roles.png) ::hint{ type="warning" } Le rôle sélectionné doit avoir été créé au préalable sur votre serveur, et être accessible à DraftBot (donc ne pas être situé plus haut que le rôle le plus élevé de DraftBot). :: + + ::hint{ type="info" } + Si un membre tente d'acheter un rôle qu'il possède déjà, l'achat sera refusé avec un message d'erreur explicite. + :: :: ::tab{ label="Expérience" } - Si le [système de niveaux](/docs/modules/niveaux) est activé, vous pouvez permettre à vos membres d'acheter des points d'expérience en échange de devises. Pour ajouter une somme d'xp à la boutique, sélectionnez le type d'article **"De l'expérience"** dans le menu de création d'article. + Si le [système de niveaux](/docs/modules/niveaux) est activé, vous pouvez permettre à vos membres d'acheter des points d'expérience en échange de devises. Pour ajouter une somme d'XP à la boutique, sélectionnez le type d'article **"De l'expérience"** dans le menu de création d'article. Choisissez ensuite : - Le prix de l'article - La quantité d'expérience à attribuer - La description de l'article - ![Menu de vente de points d'expérience](../assets/economie/vente_xp.png) + ![Menu de vente de points d'expérience](../assets/economie/panel_article_xp.png) + + ::hint{ type="warning" } + Le système de niveaux doit être **activé** sur votre serveur pour utiliser ce type d'article. Si vous le désactivez, un avertissement s'affichera lors de l'achat. + :: + + **Comportements particuliers :** + + - **Montée de niveau** : Si l'achat d'XP fait monter le membre de niveau, il recevra automatiquement les récompenses de niveau configurées et une annonce sera envoyée (si activée). + - **Limite de niveau** : Si un niveau maximum est défini (serveurs premium), les membres ayant atteint ce niveau ne pourront plus acheter d'XP. :: ::tab{ label="Objet Inventaire" } @@ -264,10 +422,10 @@ DraftBot vous permet d'intégrer à votre boutique des items de types variables - Le nombre d'objets à attribuer par achat - La description de l'article - ![Menu de vente d'objet d'inventaire](../assets/economie/vente_objet.png) + ![Menu de vente d'objet d'inventaire](../assets/economie/panel_article_item.png) ::hint{ type="info" } - Si vous n'avez pas encore d'objets en boutique, vous pouvez en [créer directement](#creer-des-objets-d-inventaire) ! + Si vous n'utilisez pas encore l'inventaire, découvrez la fonctionnalité depuis la [documentation de l'inventaire](/docs/modules/inventaire). :: :: @@ -281,134 +439,41 @@ DraftBot vous permet d'intégrer à votre boutique des items de types variables - Le nom de l'article - La description de l'article - ![Menu de vente d'article personnalisé](../assets/economie/vente_article_perso.png) - - Lorsqu'un membre achètera cet item, vous serez notifié par DraftBot dans vos messages privés, et vous pourrez ainsi le remettre "en main propre" au membre qui l'a acheté. - :: -:: - -::hint{ type="info" } - En déroulant le menu "avancé" lors de la création d'un article de boutique, l'option "stock" apparaît. - - - Par défaut, le stock est réglé sur "Illimité" - - Si le serveur est [premium](/premium) <:icon_premium_:1096140508625125417>, vous pouvez le modifier pour créer des articles en quantité limitée ! + ![Menu de vente d'article personnalisé](../assets/economie/panel_article_custom.png) - ![Option de stock depuis le panel](../assets/economie/stock.png) -:: - -### Créer des objets d'inventaire - -Il est possible de créer des objets d'inventaire depuis le menu de création d'article. - -Pour cela, il faut : -- Cliquer sur "Créer un objet" dans le menu de sélection d'objet. -- Entrer le nom de l'objet - -![Menu de création d'objet depuis le panel](../assets/economie/creation_obj.png) - -::hint{ type="info" } - Il est également possible d'entrer dans le menu de création d'objet depuis la section [**Niveaux** du panel de DraftBot](/dashboard/first/levels) ! -:: - -::hint{ type="success" } - Vous pouvez intégrer des émojis Discord au nom de votre objet ! -:: - - -### Type de boutique -DraftBot vous permet de choisir entre deux modes pour votre boutique : - -1. **Marché noir** : Le message d'accès à la boutique disparaît après 60 secondes. -2. **Classique** : Le message d'accès à la boutique ne disparaît pas. - -::hint{ type="success" } - Vous n'êtes pas certain du mode que vous souhaitez ? Pas de souci, vous pouvez revenir sur votre décision à n'importe quel moment ! -:: - -## Classement - -Vous pouvez afficher le classement des membres, du plus riche au moins riche, de trois façons : - -::collapse{ label="En entrant la commande /topargent sur Discord" } - Vous pouvez afficher le classement économique via la commande \ : - - ![Résultat de la commande /topargent](../assets/economie/commande_topargent.png) - - ::hint{ type="success" } - Si vous souhaitez afficher un nombre spécifique de lignes (seulement le top 3 par exemple), vous pouvez ajouter ce nombre en argument de la commande \ : - - ![Résultat de la commande /topargent top 10](../assets/economie/topargent10.png) - :: -:: - -::collapse{ label="En ligne, depuis le Panel" } - Si vous avez activé le [**classement en ligne**](#fonctionnalites-disponibles), vous pouvez le consulter : - - en vous rendant sur le [**panel**](/dashboard/first/economy) et en cliquant sur le bouton **"Accéder au classement"**. - - En utilisant la commande \ puis en cliquant sur le bouton **"Voir l'ensemble du classement"** - - ![Classement en ligne - généré depuis le serveur DraftBot Support](../assets/economie/classement_web.png) -:: - -::collapse{ label="Via un salon dédié (premium)" } - Si vous avez [activé le classement sur Discord](#fonctionnalites-disponibles), vous pouvez le consulter en vous rendant dans le salon dédié sur votre serveur. + ::hint{ type="success" } + **Comment ça fonctionne ?** Lorsqu'un membre achète cet article, **vous recevez une notification par message privé de DraftBot** avec les informations du membre. Vous pouvez alors lui remettre la récompense "en main propre" comme vous le souhaitez. + :: - ::hint{ type="success" } - L'avantage de cette méthode est que le message affichant le classement sera réactualisé toutes les 10 minutes automatiquement, sauf s'il n'y a pas de changements ! + ::hint{ type="warning" } + Assurez-vous que vos messages privés sont ouverts pour recevoir les notifications d'achat ! Si vos MP sont fermés, le membre recevra un message d'erreur lors de l'achat. + :: :: - - ![Classement automatique sur Discord](../assets/economie/classement_discord_auto.png) :: -## Commandes économie - -Il existe plusieurs commandes pratiques pour rendre l'intégration du système d'économie aussi fluide que possible pour vous. +### Stock d'un article -### Commandes générales +Un article est par défaut en quantité illimité. En déroulant le menu "Avancé", les serveurs [premium](/premium) <:icon_premium:1096140508625125417> peuvent définir un **stock limité** pour chaque article. Une fois épuisé, l'article ne peut plus être acheté jusqu'à ce que vous réapprovisionniez le stock manuellement. ::hint{ type="info" } - Les commandes générales sont celles qui peuvent être utilisées par tout membre, sauf restriction spécifique : + Le stock est géré article par article. Vous pouvez avoir certains articles en stock illimité et d'autres en quantité limitée dans la même boutique. :: -- \ (ou \) : Permet de récolter sa somme quotidienne. -- \ : Crée un message qui offre une somme d'argent au premier qui clique sur le bouton. -- \ : Permet d'afficher la quantité d'argent que vous, ou un autre membre, possédez. -- \ : Donner de son argent au membre ciblé. -- \ : Permet d'afficher la [boutique du serveur](#la-boutique). -- \ : Permet d'afficher le [classement](#classement) des membres. +![Option de configuration du stock](../assets/economie/panel_stock.png) -::hint{ type="info" } - Lors de l'utilisation de \, vous pouvez définir la durée du drop ! +## Migration depuis UnbelievaBoat - ![Utilisation de la commande /dropargent](../assets/economie/dropargent_timer.png) -:: +Si vous utilisiez déjà un système d'économie via UnbelievaBoat, vous avez la possibilité d'importer l'argent de vos membres dans le système d'économie de DraftBot ! -::hint{ type="info" } - Les commandes admin ne peuvent être utilisées que par les membres de votre serveur possédant les permissions administrateur. -:: +![Bouton d'importation de l'économie](../assets/economie/config_import.png) -### Commandes Admin +Après avoir cliqué sur **Importer UnbelievaBoat**, et confirmé que vous souhaitez procéder à l'importation, DraftBot récupèrera automatiquement toutes les informations d'argent des membres. -::hint{ type="info" } - Les commandes admin ne peuvent être utilisées que par les membres de votre serveur possédant la permission administrateur. +::hint{ type="warning" } + Assurez-vous que UnbelievaBoat est présent sur votre serveur au moment de l'importation ! :: -- \ : Ajouter de l'argent à un membre. -- \ : Retirer de l'argent à un membre. -- \ : Réinitialiser l'argent de tout le serveur. -- \ : Définir l'argent d'un membre. -- \ : Transférer de l'argent d'un membre à un autre. - -## Migration -Si vous utilisiez **UnbelievaBoat** auparavant, il est possible d'importer l'économie de vos membres directement sur DraftBot afin qu'ils ne perdent pas leur progression ! - -Pour migrer vers le système de DraftBot, utilisez la commande \. - -![Importer l'économie](../assets/economie/import_economy.png) - -::hint{ type="info" } - Il faut impérativement que le bot UnbelievaBoat soit sur votre serveur lors de la migration. -:: diff --git a/docs/assets/economie/bot_classement_discord_auto.png b/docs/assets/economie/bot_classement_discord_auto.png new file mode 100644 index 000000000..393535fc6 Binary files /dev/null and b/docs/assets/economie/bot_classement_discord_auto.png differ diff --git a/docs/assets/economie/dropargent_timer.png b/docs/assets/economie/bot_dropmoney.png similarity index 100% rename from docs/assets/economie/dropargent_timer.png rename to docs/assets/economie/bot_dropmoney.png diff --git a/docs/assets/economie/money.png b/docs/assets/economie/bot_money.png similarity index 100% rename from docs/assets/economie/money.png rename to docs/assets/economie/bot_money.png diff --git a/docs/assets/economie/bot_shops.png b/docs/assets/economie/bot_shops.png new file mode 100644 index 000000000..16c92352b Binary files /dev/null and b/docs/assets/economie/bot_shops.png differ diff --git a/docs/assets/economie/bot_topargent.png b/docs/assets/economie/bot_topargent.png new file mode 100644 index 000000000..bd8505803 Binary files /dev/null and b/docs/assets/economie/bot_topargent.png differ diff --git a/docs/assets/economie/classement_discord_auto.png b/docs/assets/economie/classement_discord_auto.png deleted file mode 100644 index 4930593fa..000000000 Binary files a/docs/assets/economie/classement_discord_auto.png and /dev/null differ diff --git a/docs/assets/economie/commande_topargent.png b/docs/assets/economie/commande_topargent.png deleted file mode 100644 index 0d0416089..000000000 Binary files a/docs/assets/economie/commande_topargent.png and /dev/null differ diff --git a/docs/assets/economie/config_articles.png b/docs/assets/economie/config_articles.png new file mode 100644 index 000000000..4a9a84a15 Binary files /dev/null and b/docs/assets/economie/config_articles.png differ diff --git a/docs/assets/economie/config_custom.png b/docs/assets/economie/config_custom.png new file mode 100644 index 000000000..b087989d2 Binary files /dev/null and b/docs/assets/economie/config_custom.png differ diff --git a/docs/assets/economie/config_eco_argent.png b/docs/assets/economie/config_eco_argent.png deleted file mode 100644 index 9a396e229..000000000 Binary files a/docs/assets/economie/config_eco_argent.png and /dev/null differ diff --git a/docs/assets/economie/config_eco_boutique.png b/docs/assets/economie/config_eco_boutique.png deleted file mode 100644 index 3c3095a77..000000000 Binary files a/docs/assets/economie/config_eco_boutique.png and /dev/null differ diff --git a/docs/assets/economie/config_eco_limit_boost.png b/docs/assets/economie/config_eco_limit_boost.png deleted file mode 100644 index 586696a35..000000000 Binary files a/docs/assets/economie/config_eco_limit_boost.png and /dev/null differ diff --git a/docs/assets/economie/config_eco_personnalisation.png b/docs/assets/economie/config_eco_personnalisation.png deleted file mode 100644 index 91eaafdf3..000000000 Binary files a/docs/assets/economie/config_eco_personnalisation.png and /dev/null differ diff --git a/docs/assets/economie/config_eco_root.png b/docs/assets/economie/config_eco_root.png deleted file mode 100644 index bf7c0cb85..000000000 Binary files a/docs/assets/economie/config_eco_root.png and /dev/null differ diff --git a/docs/assets/economie/config_eco_statut.png b/docs/assets/economie/config_eco_statut.png deleted file mode 100644 index 479e56686..000000000 Binary files a/docs/assets/economie/config_eco_statut.png and /dev/null differ diff --git a/docs/assets/economie/config_home.png b/docs/assets/economie/config_home.png new file mode 100644 index 000000000..5946c5750 Binary files /dev/null and b/docs/assets/economie/config_home.png differ diff --git a/docs/assets/economie/config_import.png b/docs/assets/economie/config_import.png new file mode 100644 index 000000000..145d24e5d Binary files /dev/null and b/docs/assets/economie/config_import.png differ diff --git a/docs/assets/economie/config_limits_boosts.png b/docs/assets/economie/config_limits_boosts.png new file mode 100644 index 000000000..9ba57d95e Binary files /dev/null and b/docs/assets/economie/config_limits_boosts.png differ diff --git a/docs/assets/economie/config_money.png b/docs/assets/economie/config_money.png new file mode 100644 index 000000000..948e3f1bb Binary files /dev/null and b/docs/assets/economie/config_money.png differ diff --git a/docs/assets/economie/config_shop.png b/docs/assets/economie/config_shop.png new file mode 100644 index 000000000..e9d2eacfa Binary files /dev/null and b/docs/assets/economie/config_shop.png differ diff --git a/docs/assets/economie/config_shops.png b/docs/assets/economie/config_shops.png new file mode 100644 index 000000000..d85ec752b Binary files /dev/null and b/docs/assets/economie/config_shops.png differ diff --git a/docs/assets/economie/config_status.png b/docs/assets/economie/config_status.png new file mode 100644 index 000000000..59ef740fe Binary files /dev/null and b/docs/assets/economie/config_status.png differ diff --git a/docs/assets/economie/creation_obj.png b/docs/assets/economie/creation_obj.png deleted file mode 100644 index 8fb450560..000000000 Binary files a/docs/assets/economie/creation_obj.png and /dev/null differ diff --git a/docs/assets/economie/import_economy.png b/docs/assets/economie/import_economy.png deleted file mode 100644 index 43ae1419c..000000000 Binary files a/docs/assets/economie/import_economy.png and /dev/null differ diff --git a/docs/assets/economie/panel_vue_d_ensemble.png b/docs/assets/economie/panel_all.png similarity index 100% rename from docs/assets/economie/panel_vue_d_ensemble.png rename to docs/assets/economie/panel_all.png diff --git a/docs/assets/economie/vente_article_perso.png b/docs/assets/economie/panel_article_custom.png similarity index 100% rename from docs/assets/economie/vente_article_perso.png rename to docs/assets/economie/panel_article_custom.png diff --git a/docs/assets/economie/vente_objet.png b/docs/assets/economie/panel_article_item.png similarity index 100% rename from docs/assets/economie/vente_objet.png rename to docs/assets/economie/panel_article_item.png diff --git a/docs/assets/economie/vente_roles.png b/docs/assets/economie/panel_article_roles.png similarity index 100% rename from docs/assets/economie/vente_roles.png rename to docs/assets/economie/panel_article_roles.png diff --git a/docs/assets/economie/vente_xp.png b/docs/assets/economie/panel_article_xp.png similarity index 100% rename from docs/assets/economie/vente_xp.png rename to docs/assets/economie/panel_article_xp.png diff --git a/docs/assets/economie/classement_web.png b/docs/assets/economie/panel_classement_web.png similarity index 100% rename from docs/assets/economie/classement_web.png rename to docs/assets/economie/panel_classement_web.png diff --git a/docs/assets/economie/panel_create_article.png b/docs/assets/economie/panel_create_article.png new file mode 100644 index 000000000..47e4331fa Binary files /dev/null and b/docs/assets/economie/panel_create_article.png differ diff --git a/docs/assets/economie/exemple_devise_perso.png b/docs/assets/economie/panel_custom_currency.png similarity index 100% rename from docs/assets/economie/exemple_devise_perso.png rename to docs/assets/economie/panel_custom_currency.png diff --git a/docs/assets/economie/dashboard_activate_system.png b/docs/assets/economie/panel_economy_enable.png similarity index 100% rename from docs/assets/economie/dashboard_activate_system.png rename to docs/assets/economie/panel_economy_enable.png diff --git a/docs/assets/economie/bouton_boutique.png b/docs/assets/economie/panel_shop_enable.png similarity index 100% rename from docs/assets/economie/bouton_boutique.png rename to docs/assets/economie/panel_shop_enable.png diff --git a/docs/assets/economie/accueil_boutique_panel.png b/docs/assets/economie/panel_shops.png similarity index 100% rename from docs/assets/economie/accueil_boutique_panel.png rename to docs/assets/economie/panel_shops.png diff --git a/docs/assets/economie/panel_stock.png b/docs/assets/economie/panel_stock.png new file mode 100644 index 000000000..c4b985e37 Binary files /dev/null and b/docs/assets/economie/panel_stock.png differ diff --git a/docs/assets/economie/stock.png b/docs/assets/economie/stock.png deleted file mode 100644 index 7eb630bde..000000000 Binary files a/docs/assets/economie/stock.png and /dev/null differ diff --git a/docs/assets/economie/topargent10.png b/docs/assets/economie/topargent10.png deleted file mode 100644 index 9a543754f..000000000 Binary files a/docs/assets/economie/topargent10.png and /dev/null differ diff --git a/docs/assets/niveaux/tableau_des_niveaux.png b/docs/assets/niveaux/bot_experience_table.png similarity index 100% rename from docs/assets/niveaux/tableau_des_niveaux.png rename to docs/assets/niveaux/bot_experience_table.png diff --git a/docs/assets/niveaux/bot_leaderboard_auto.png b/docs/assets/niveaux/bot_leaderboard_auto.png new file mode 100644 index 000000000..9d28fcb08 Binary files /dev/null and b/docs/assets/niveaux/bot_leaderboard_auto.png differ diff --git a/docs/assets/niveaux/niveau_carte.png b/docs/assets/niveaux/bot_level_card.png similarity index 100% rename from docs/assets/niveaux/niveau_carte.png rename to docs/assets/niveaux/bot_level_card.png diff --git a/docs/assets/niveaux/annonces_niveaux.png b/docs/assets/niveaux/bot_new_level_notif.png similarity index 100% rename from docs/assets/niveaux/annonces_niveaux.png rename to docs/assets/niveaux/bot_new_level_notif.png diff --git a/docs/assets/niveaux/bot_rewards.png b/docs/assets/niveaux/bot_rewards.png new file mode 100644 index 000000000..ab90fc19a Binary files /dev/null and b/docs/assets/niveaux/bot_rewards.png differ diff --git a/docs/assets/niveaux/bot_toplevel.png b/docs/assets/niveaux/bot_toplevel.png new file mode 100644 index 000000000..58373d6a7 Binary files /dev/null and b/docs/assets/niveaux/bot_toplevel.png differ diff --git a/docs/assets/niveaux/classement_discord_auto.png b/docs/assets/niveaux/classement_discord_auto.png deleted file mode 100644 index 76e1cbdfd..000000000 Binary files a/docs/assets/niveaux/classement_discord_auto.png and /dev/null differ diff --git a/docs/assets/niveaux/config_customization.png b/docs/assets/niveaux/config_customization.png new file mode 100644 index 000000000..cbd13fef1 Binary files /dev/null and b/docs/assets/niveaux/config_customization.png differ diff --git a/docs/assets/niveaux/config_experience.png b/docs/assets/niveaux/config_experience.png new file mode 100644 index 000000000..3cd428d0f Binary files /dev/null and b/docs/assets/niveaux/config_experience.png differ diff --git a/docs/assets/niveaux/config_home.png b/docs/assets/niveaux/config_home.png new file mode 100644 index 000000000..ea2967572 Binary files /dev/null and b/docs/assets/niveaux/config_home.png differ diff --git a/docs/assets/niveaux/config_import.png b/docs/assets/niveaux/config_import.png new file mode 100644 index 000000000..ea13df121 Binary files /dev/null and b/docs/assets/niveaux/config_import.png differ diff --git a/docs/assets/niveaux/config_limits_boosts.png b/docs/assets/niveaux/config_limits_boosts.png new file mode 100644 index 000000000..9b291f688 Binary files /dev/null and b/docs/assets/niveaux/config_limits_boosts.png differ diff --git a/docs/assets/niveaux/config_lvl_annonces.png b/docs/assets/niveaux/config_lvl_annonces.png deleted file mode 100644 index 439e9c9ea..000000000 Binary files a/docs/assets/niveaux/config_lvl_annonces.png and /dev/null differ diff --git a/docs/assets/niveaux/config_lvl_exp.png b/docs/assets/niveaux/config_lvl_exp.png deleted file mode 100644 index 2dce7fdd2..000000000 Binary files a/docs/assets/niveaux/config_lvl_exp.png and /dev/null differ diff --git a/docs/assets/niveaux/config_lvl_limit_boost.png b/docs/assets/niveaux/config_lvl_limit_boost.png deleted file mode 100644 index ab9ffd2f5..000000000 Binary files a/docs/assets/niveaux/config_lvl_limit_boost.png and /dev/null differ diff --git a/docs/assets/niveaux/config_lvl_personnalisation.png b/docs/assets/niveaux/config_lvl_personnalisation.png deleted file mode 100644 index 0f00f1738..000000000 Binary files a/docs/assets/niveaux/config_lvl_personnalisation.png and /dev/null differ diff --git a/docs/assets/niveaux/config_lvl_recompenses.png b/docs/assets/niveaux/config_lvl_recompenses.png deleted file mode 100644 index e35579810..000000000 Binary files a/docs/assets/niveaux/config_lvl_recompenses.png and /dev/null differ diff --git a/docs/assets/niveaux/config_lvl_root.png b/docs/assets/niveaux/config_lvl_root.png deleted file mode 100644 index af55964ed..000000000 Binary files a/docs/assets/niveaux/config_lvl_root.png and /dev/null differ diff --git a/docs/assets/niveaux/config_lvl_statut.png b/docs/assets/niveaux/config_lvl_statut.png deleted file mode 100644 index 0cf89cb54..000000000 Binary files a/docs/assets/niveaux/config_lvl_statut.png and /dev/null differ diff --git a/docs/assets/niveaux/config_notifs.png b/docs/assets/niveaux/config_notifs.png new file mode 100644 index 000000000..a46863365 Binary files /dev/null and b/docs/assets/niveaux/config_notifs.png differ diff --git a/docs/assets/niveaux/config_rewards.png b/docs/assets/niveaux/config_rewards.png new file mode 100644 index 000000000..8943e0a86 Binary files /dev/null and b/docs/assets/niveaux/config_rewards.png differ diff --git a/docs/assets/niveaux/config_status.png b/docs/assets/niveaux/config_status.png new file mode 100644 index 000000000..6edbe868e Binary files /dev/null and b/docs/assets/niveaux/config_status.png differ diff --git a/docs/assets/niveaux/import_levels.png b/docs/assets/niveaux/import_levels.png deleted file mode 100644 index 6a82302b8..000000000 Binary files a/docs/assets/niveaux/import_levels.png and /dev/null differ diff --git a/docs/assets/niveaux/niveau.png b/docs/assets/niveaux/niveau.png deleted file mode 100644 index c729c6312..000000000 Binary files a/docs/assets/niveaux/niveau.png and /dev/null differ diff --git a/docs/assets/niveaux/panel_activer_lvl.png b/docs/assets/niveaux/panel_activer_lvl.png deleted file mode 100644 index a15a38d6d..000000000 Binary files a/docs/assets/niveaux/panel_activer_lvl.png and /dev/null differ diff --git a/docs/assets/niveaux/creation_recompense.png b/docs/assets/niveaux/panel_creation_recompense.png similarity index 100% rename from docs/assets/niveaux/creation_recompense.png rename to docs/assets/niveaux/panel_creation_recompense.png diff --git a/docs/assets/niveaux/panel_enable.png b/docs/assets/niveaux/panel_enable.png new file mode 100644 index 000000000..98741a68d Binary files /dev/null and b/docs/assets/niveaux/panel_enable.png differ diff --git a/docs/assets/niveaux/panel_home.png b/docs/assets/niveaux/panel_home.png new file mode 100644 index 000000000..d41811bd5 Binary files /dev/null and b/docs/assets/niveaux/panel_home.png differ diff --git a/docs/assets/niveaux/classement_web.png b/docs/assets/niveaux/panel_leaderboard.png similarity index 100% rename from docs/assets/niveaux/classement_web.png rename to docs/assets/niveaux/panel_leaderboard.png diff --git a/docs/assets/niveaux/panel_recompenses.png b/docs/assets/niveaux/panel_rewards.png similarity index 100% rename from docs/assets/niveaux/panel_recompenses.png rename to docs/assets/niveaux/panel_rewards.png diff --git a/docs/assets/niveaux/bouton_recompenses.png b/docs/assets/niveaux/panel_rewards_button.png similarity index 100% rename from docs/assets/niveaux/bouton_recompenses.png rename to docs/assets/niveaux/panel_rewards_button.png diff --git a/docs/assets/niveaux/annonces_recompenses.png b/docs/assets/niveaux/panel_rewards_notifs.png similarity index 100% rename from docs/assets/niveaux/annonces_recompenses.png rename to docs/assets/niveaux/panel_rewards_notifs.png diff --git a/docs/assets/niveaux/panel_vue_d_ensemble.png b/docs/assets/niveaux/panel_vue_d_ensemble.png deleted file mode 100644 index fb8e4eb97..000000000 Binary files a/docs/assets/niveaux/panel_vue_d_ensemble.png and /dev/null differ diff --git a/docs/assets/niveaux/recompenses.png b/docs/assets/niveaux/recompenses.png deleted file mode 100644 index 107754acb..000000000 Binary files a/docs/assets/niveaux/recompenses.png and /dev/null differ diff --git a/docs/assets/niveaux/reward.png b/docs/assets/niveaux/reward.png deleted file mode 100644 index 5ff6bf942..000000000 Binary files a/docs/assets/niveaux/reward.png and /dev/null differ diff --git a/docs/assets/niveaux/topniveau.png b/docs/assets/niveaux/topniveau.png deleted file mode 100644 index ac4c3df5a..000000000 Binary files a/docs/assets/niveaux/topniveau.png and /dev/null differ