diff --git a/docs/2.modules/29.route-infini.md b/docs/2.modules/29.route-infini.md index d8cb1b887..b909775f7 100644 --- a/docs/2.modules/29.route-infini.md +++ b/docs/2.modules/29.route-infini.md @@ -3,7 +3,7 @@ title: Route de l'Infini description: Créez un défi de comptage collaboratif sur votre serveur ! Les membres comptent ensemble jusqu'à l'infini, en respectant les règles que vous définissez. navigation.icon: 'twemoji:infinity' redactors: ['draftproducts'] -contributors: ['imroxxor', 'rababio4579', 'lyvendev'] +contributors: ['imroxxor', 'rababio4579', 'deluccaromuald-ops', 'lyvendev'] updatedAt: '2025-11-14' --- @@ -22,7 +22,7 @@ La gestion du comptage est entièrement assurée par **DraftBot**, qui analyse c La Route de l'Infini est un jeu de comptage collaboratif où les membres de votre serveur comptent ensemble de **1 jusqu'à l'infini**. Le principe est simple : chaque membre envoie le nombre suivant dans le salon dédié. - **Comptage séquentiel** : Envoyez le nombre qui suit immédiatement le précédent (1, 2, 3, 4...) -- **Alternance obligatoire** : Vous ne pouvez pas envoyer deux nombres consécutifs. Un autre membre doit compter entre vos deux messages +- **Alternance obligatoire** : Vous ne pouvez pas envoyer deux nombres consécutifs. Un autre membre doit compter entre vos deux messages, sauf si votre serveur autorise les [messages consécutifs](#messages-consécutifs) - **Format du message** : Envoyez uniquement le nombre attendu (sauf si les discussions sont autorisées) ::hint{ type="info" } @@ -61,6 +61,8 @@ La commande affiche : ## Récompenses +### Types de récompenses + Motivez vos membres en leur offrant des récompenses lorsqu'ils atteignent certains nombres ! Les récompenses sont visibles dans la commande \. - **Nombre spécifique** : La récompense est donnée une seule fois à un nombre précis (exemple : au nombre 1000) @@ -78,13 +80,74 @@ Motivez vos membres en leur offrant des récompenses lorsqu'ils atteignent certa ::hint{ type="info" } Lorsqu'une récompense est basée sur [l'argent du système d'économie](/docs/modules/economie) du serveur, celle-ci peut provenir : - **De la création** : L'argent est créé pour l'occasion - - **De la banque du serveur** : L'argent provient de l'argent collecté via les erreurs (voir [Gestion des erreurs](#gestion-des-erreurs)) + - **De la banque du serveur** : L'argent provient de l'argent collecté via les erreurs (voir [Actions d'erreurs](#actions-derreurs)) :: ::hint{ type="info" } Vous pouvez créer jusqu'à **3 récompenses**. Les serveurs [premium](/premium) <:icon_premium:1096140508625125417> peuvent créer jusqu'à **10 récompenses** ! :: +### Limiter les gains répétés + +Sur une récompense dont l'objectif est un **multiple**, vous pouvez éviter qu'un même membre accapare tous les paliers : + +| Option | Description | +|--------|-------------| +| **Pas deux fois de suite** | Si le même membre déclenche le palier deux fois d'affilée, la récompense ne lui est pas redonnée. Il pourra de nouveau la gagner au palier suivant | +| **Limiter le nombre de gains** | Un membre ne peut remporter cette récompense qu'un nombre de fois défini, de **1 à 1000** | + +Dans les deux cas, le membre concerné est prévenu par un message dans le [salon d'annonces des récompenses](#annonces-de-récompenses), s'il est configuré. + +::hint{ type="info" } + Dans la commande \, ces deux options s'appellent respectivement **"Gains consécutifs"** et **"Limite de gains"**. +:: + +::hint{ type="info" } + Ces options sont réservées aux serveurs [premium](/premium) <:icon_premium:1096140508625125417>, et ne sont proposées **que sur les récompenses de type "Multiple"**. +:: + +### Récompenses mystères + +Pour garder un effet de surprise, vous pouvez masquer une partie d'une récompense dans la commande \ : + +| Élément masqué | Effet | +|----------------|-------| +| **Masquer la récompense** | Le contenu de la récompense est remplacé par "🎁 Récompense mystère", mais le palier reste visible | +| **Masquer le nombre cible** | Le palier devient "À un certain nombre" ou "À intervalles réguliers", mais la récompense reste visible | + +Vous pouvez masquer l'un des deux éléments, ou les deux. + +![Affichage d'une récompense mystère via la commande /route-infini](../assets/route-infini/bot_mystery_gift.png) + +::hint{ type="info" } + Contrairement aux options ci-dessus, le masquage est disponible sur **tous les serveurs**, et pour les deux types d'objectif (nombre spécifique ou multiple). +:: + +::tabs + ::tab{ label="Depuis le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/infinite-road) + + Lors de la création ou de la modification d'une récompense, la partie **"Masquer dans /route-infini"** apparaît dès que vous avez choisi le type de récompense. Activez les éléments que vous souhaitez cacher à vos membres. + + ![Options de masquage dans la configuration d'une récompense sur le panel](../assets/route-infini/panel_hide_elements.png) + + ::hint{ type="warning" } + N'oubliez pas de valider avec le bouton "Créer" (ou "Modifier"), puis d'enregistrer vos modifications avec le bouton "Enregistrer" situé en bas de page ! + :: + :: + + ::tab{ label="Via la commande /route-infini" } + Si vous êtes animateur de la Route de l'Infini ou administrateur, la commande \ affiche un bouton **"Gérer les récompenses"**. Il vous permet de : + + - Créer, modifier ou supprimer une récompense + - Réinitialiser **toutes** les récompenses + + En modifiant une récompense, le bouton **"Éléments masqués"** vous permet de sélectionner ce que vous souhaitez cacher. + + ![Bouton "Éléments masqués" lors de la modification d'une récompense](../assets/route-infini/config_hide_elements.png) + :: +:: + ## Déclencheurs Les déclencheurs permettent d'automatiser des actions spéciales lorsque certains nombres sont atteints. Contrairement aux récompenses, les déclencheurs ne donnent rien aux membres mais créent des événements dans le salon. @@ -127,7 +190,7 @@ Le système détecte automatiquement quatre types d'erreurs. Vous choisissez ens |---------------|-------------| | **Nombre invalide** | Le membre envoie un nombre incorrect (par exemple 43 au lieu de 42) | | **Message invalide** | Le message ne contient aucun nombre, ou ne respecte pas les règles de discussion | -| **Messages consécutifs** | Le membre envoie deux nombres d'affilée sans qu'un autre membre compte entre-temps | +| **Messages consécutifs** | Le membre envoie plus de nombres d'affilée que ne l'autorise l'option [Messages consécutifs](#messages-consécutifs), sans qu'un autre membre compte entre-temps | | **Commande envoyée** | Le membre exécute une commande dans le salon de comptage | ### Réinitialisation du compteur @@ -138,6 +201,39 @@ Si activée, le compteur repart de **1** et un message explique qui a causé la Par défaut, la réinitialisation en cas d'erreur est **désactivée**. Même si vous l'activez, elle ne s'appliquera que pour les types d'erreurs que vous aurez sélectionnés dans la configuration. :: +#### Message de réinitialisation + +Le message envoyé lors de la réinitialisation est personnalisable (**1000 caractères maximum**) avec les variables suivantes : + +| Variable | Description | Exemple | +|----------|-------------|---------| +| `{infiniteroad.number}` | Le prochain nombre attendu après la réinitialisation | 1 | +| `{infiniteroad.error_type}` | Le type d'erreur ayant provoqué la réinitialisation | un **nombre incorrect** | + +*En plus des [autres variables](/docs/autres/variables) déjà disponibles globalement !* + +**Message par défaut** : `❌ {user} a ruiné la Route de l'Infini en envoyant {infiniteroad.error_type} ! Le compteur a été réinitialisé, le prochain nombre est **{infiniteroad.number}**.` + +::tabs + ::tab{ label="Depuis le panel" } + [⫸ Accéder au panel de **DraftBot**](/dashboard/first/infinite-road) + + Activez l'option "Réinitialiser la route de l'infini en cas d'erreur" : la partie "Message de réinitialisation personnalisé" apparaît alors juste en dessous. + + ![Configuration du message de réinitialisation sur le panel](../assets/route-infini/panel_reset_message.png) + :: + + ::tab{ label="Via la commande /config" } + Rendez-vous dans la commande \, puis dans l'onglet "Route de l'Infini". Appuyez ensuite sur le bouton "Erreurs", puis sur "Message de réinitialisation". + + ![Réponse de DraftBot après avoir appuyé sur le bouton "Message de réinitialisation"](../assets/route-infini/bot_reset_message.png) + :: +:: + +::hint{ type="info" } + Le markdown est autorisé dans ce message. +:: + ### Retrait d'argent Si le [système d'économie](/docs/modules/economie) est activé, vous pouvez retirer de l'argent aux membres qui font certaines erreurs (désactivé par défaut). Deux modes sont disponibles : @@ -188,11 +284,15 @@ Le format des messages est entièrement personnalisable avec des variables dynam **Format par défaut** : `{user} : {number} {discussion}` ::hint{ type="info" } - La couleur par défaut des embeds est **#CD6E57** (orange). Les serveurs premium peuvent personnaliser cette couleur ou retirer la couleur. + La personnalisation du format est réservée aux serveurs [premium](/premium) <:icon_premium:1096140508625125417>. :: +### Couleur du système + +La couleur du système s'applique aussi bien aux messages renvoyés au format **Embed** qu'à l'affichage de la commande \. Par défaut, il s'agit du **#CD6E57** (orange). + ::hint{ type="info" } - La personnalisation du format et de la couleur des embeds est réservée aux serveurs [premium](/premium) <:icon_premium:1096140508625125417>. + La personnalisation de la couleur est réservée aux serveurs [premium](/premium) <:icon_premium:1096140508625125417>. :: ### Réaction de validation @@ -211,6 +311,15 @@ Vous pouvez autoriser les membres à ajouter du texte après le nombre : - **Autoriser les sauts de ligne** : Permet d'utiliser des retours à la ligne dans les discussions (désactivé par défaut) - **Ignorer les messages sans nombres** : Si activé, les messages ne contenant aucun nombre sont simplement ignorés au lieu de déclencher une erreur (désactivé par défaut) +### Messages consécutifs + +Par défaut, un même membre ne peut pas envoyer deux nombres d'affilée : un autre membre doit compter entre ses deux messages. Vous pouvez lever cette règle depuis cette même partie **Discussions** : + +- **Autoriser plusieurs messages à la suite** : Permet à un même membre d'envoyer plusieurs nombres d'affilée (désactivé par défaut) +- **Nombre de messages consécutifs autorisés** : Combien de nombres un même membre peut envoyer d'affilée, **de 2 à 20** + +Au-delà de cette limite, l'erreur **Messages consécutifs** est déclenchée comme d'habitude. + ## Configurer la Route de l'Infini ::tabs @@ -258,6 +367,7 @@ Vous pouvez autoriser les membres à ajouter du texte après le nombre : - Autoriser/interdire les discussions après le nombre - Autoriser/interdire les retours à la ligne dans les discussions - Ignorer ou sanctionner les messages sans nombres + - Autoriser plusieurs messages consécutifs d'un même membre, et définir combien ![Menu "Discussions" via la commande /config](../assets/route-infini/config_discussions.png) :: @@ -266,6 +376,7 @@ Vous pouvez autoriser les membres à ajouter du texte après le nombre : Configurez la gestion des erreurs : - **Types d'erreurs** : Choisissez quelles erreurs déclencher des actions - **Réinitialisation** : Remettre le compteur à 1 en cas d'erreur + - Message de réinitialisation personnalisé - **Retrait d'argent** : Retirer de l'argent aux membres fautifs - Type de retrait : Définitif ou Collecte - Montant retiré par erreur @@ -286,6 +397,7 @@ Vous pouvez autoriser les membres à ajouter du texte après le nombre : ::collapse{ label="Récompenses" } Gérez les récompenses de la Route de l'Infini : - Créer, modifier ou supprimer des récompenses + - Masquer le palier ou la récompense dans \ - Configurer les annonces de récompenses - Personnaliser le message d'annonce @@ -303,7 +415,7 @@ Vous pouvez autoriser les membres à ajouter du texte après le nombre : Configurez où et comment annoncer l'obtention d'une récompense (désactivé par défaut) : - **Salon dédié** : Choisissez un salon spécifique pour les annonces -- **Message personnalisé** : Personnalisez le message d'annonce avec les [variables disponibles](#variables-de-personnalisation), ainsi que `{reward}` pour afficher la récompense obtenue +- **Message personnalisé** : Personnalisez le message d'annonce avec `{number}`, `{reward}` pour afficher la récompense obtenue, ainsi que les [autres variables](/docs/autres/variables) disponibles globalement **Message par défaut** : `{user}, voici votre récompense pour avoir envoyé le nombre **{number}** dans la Route de l'Infini !` @@ -321,6 +433,7 @@ Configurez où et comment annoncer l'obtention d'une récompense (désactivé pa 2. **Valeur de l'objectif** : Le nombre ou multiple déclencheur 3. **Type de récompense** : Rôle, argent, XP, objet, ou personnalisée 4. **Paramètres spécifiques** selon le type choisi +5. **Éléments à masquer** dans \ (voir [Récompenses mystères](#récompenses-mystères)) ::tabs ::tab{ label="Depuis le panel" } diff --git a/docs/assets/route-infini/bot_mystery_gift.png b/docs/assets/route-infini/bot_mystery_gift.png new file mode 100644 index 000000000..8d0b0a32e Binary files /dev/null and b/docs/assets/route-infini/bot_mystery_gift.png differ diff --git a/docs/assets/route-infini/bot_reset_message.png b/docs/assets/route-infini/bot_reset_message.png new file mode 100644 index 000000000..55cfee410 Binary files /dev/null and b/docs/assets/route-infini/bot_reset_message.png differ diff --git a/docs/assets/route-infini/config_hide_elements.png b/docs/assets/route-infini/config_hide_elements.png new file mode 100644 index 000000000..18ff0c9dc Binary files /dev/null and b/docs/assets/route-infini/config_hide_elements.png differ diff --git a/docs/assets/route-infini/panel_hide_elements.png b/docs/assets/route-infini/panel_hide_elements.png new file mode 100644 index 000000000..40748da97 Binary files /dev/null and b/docs/assets/route-infini/panel_hide_elements.png differ diff --git a/docs/assets/route-infini/panel_reset_message.png b/docs/assets/route-infini/panel_reset_message.png new file mode 100644 index 000000000..69f994932 Binary files /dev/null and b/docs/assets/route-infini/panel_reset_message.png differ