route de l'infini - mise à jour

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 \</route-infini>.
 
 - **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 \</config>, 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 \</route-infini> :
+
+| É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 \</route-infini> 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 \</config>, 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 \</route-infini>. 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 \</route-infini>
       - 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 \</route-infini> (voir [Récompenses mystères](#récompenses-mystères))
 
 ::tabs
   ::tab{ label="Depuis le panel" }