Guide 04

Compteurs

Suivez tout ce qui arrive plus d'une fois: morts, câlins, échanges de récompenses. Choisissez comment ça se compte une seule fois, le bot se souvient pour toujours.

8 min de lecture

01Les compteurs: des nombres qui se souviennent

en bref Un seul jeton, {counter:name}, ajoute 1 et affiche le total. Le compte survit à chaque stream.

Un compteur est un nombre nommé dont le bot se souvient d'un stream à l'autre. Écrivez {counter:morts} dans la réponse d'une commande, et à chaque utilisation, le bot ajoute 1 à un compteur nommé «morts» et affiche le nouveau total directement dans sa réponse. Pas de tableur, pas de compte manuel, juste un jeton.

Deux utilisations de la même commande !mort, un seul compteur qui se souvient des deux.

Les compteurs demandent les Points de fidélité Les compteurs sont stockés par le module Points de fidélité. Activez-le d'abord, sinon {counter:…} reste du texte littéral dans le chat.

02Quatre façons de compter

en bref Toute la chaîne, par spectateur, par commande, ou les deux. Choisissez-en une à la création; elle reste fixée.

Chaque compteur a exactement une portée, choisie au moment de sa création, et elle reste la même toute sa vie. La portée répond à une seule question: à qui appartient ce nombre?

PortéeMot-cléCe qui est compté
Toute la chaîne(par défaut)Un seul total partagé, tout le monde ajoute au même nombre.
Par spectateuruserChaque spectateur a son propre nombre.
Par commande ou récompensecommandUn total partagé pour une seule commande ou récompense, tous les spectateurs réunis.
Par spectateur + commande ou récompenseuser+commandChaque spectateur a un nombre séparé pour chaque commande ou récompense.

Toute la chaîne

Tout le monde fait avancer le même nombre partagé. Parfait pour un décompte qui appartient au stream lui-même, pas à un spectateur en particulier, comme un compteur de morts.

Peu importe qui tape !mort, le total de la chaîne continue de grimper.

Par spectateur

Chaque spectateur a un nombre privé, que personne d'autre ne touche. Idéal pour les séries personnelles: combien de câlins quelqu'un a donnés, combien de fois il vous a battu à un jeu.

Même commande, deux spectateurs, deux comptes complètement séparés.

Par commande ou récompense

La portée la plus récente: un seul total partagé pour une commande ou une récompense de points de chaîne, où chaque spectateur ajoute au même nombre. Idéal pour «combien de fois cette récompense précise a-t-elle été échangée, au total?»

Deux spectateurs différents, le total de la récompense continue quand même.

Par spectateur + commande ou récompense

Combine les deux: chaque spectateur a un nombre séparé pour chaque commande ou récompense qui partage ce compteur. Liez un même compteur à deux commandes et chaque spectateur se retrouve avec un compte par commande, pas un seul compte partagé pour les deux.

Le compte d'alex pour !calin et son compte pour !highfive ne se mélangent pas, même avec le même compteur.

Fixée à la création La portée d'un compteur ne peut pas changer après coup. Mauvais choix? Supprimez-le (!counter delete nom, ou le tableau de bord) et recréez-le; les anciennes valeurs ne sont pas conservées.

03Gérer les compteurs depuis le chat

en bref Créer, ajouter, fixer, réinitialiser, supprimer ou simplement demander, sans quitter le chat.

Vous et vos modérateurs pouvez créer et gérer des compteurs sans quitter le chat, tout sous !counter:

CommandeCe qu'elle fait
!counter create <nom> [portée]Crée un compteur. Le mot de portée est user, command ou user+command; omettez-le pour toute la chaîne.
!counter add <nom> [montant]Ajoute 1, ou le montant donné. Les nombres négatifs soustraient.
!counter set <nom> <valeur>Fixe le total directement.
!counter reset <nom>Le remet à zéro. Pour un compteur par spectateur ou par commande, ceci efface tous les comptes stockés.
!counter delete <nom>Supprime le compteur complètement.
!counter listListe tous les compteurs de la chaîne et leur portée.
!counter <nom>Montre la valeur actuelle, comme la lire dans le chat.
Créer et faire avancer un compteur, du début à la fin, sans toucher au tableau de bord.

Portée «par commande», depuis le chat !counter create hydratations command crée un compteur groupé par commande en une ligne, prêt à glisser dans la réponse d'une commande, ou à lier à une récompense de points de chaîne, comme {counter:hydratations}.

04Le tableau de bord, et les récompenses de points de chaîne

en bref La page Compteurs pour un contrôle direct, et comment une récompense s’y lie.

La page Compteurs liste tous les compteurs de votre chaîne et permet de les créer, ajuster et supprimer en cliquant plutôt qu'en tapant.

  • Nom: la même chaîne que vous écririez dans {counter:…}.
  • Portée: fixée dès la création.
  • Un rappel en langage clair d'où les compteurs peuvent être avancés.
Panneau «nouveau compteur»: nommez-le, choisissez une portée, terminé. Les lignes existantes ont des boutons +/- pour les compteurs de toute la chaîne, ou un tableau de valeurs pour les autres.

Lier un compteur à une récompense de points de chaîne

Chaque récompense Points de chaîne peut garder son propre compteur, directement depuis l'éditeur de la récompense: tapez un nom de compteur (nouveau ou existant), choisissez sa portée, et chaque échange l'avance. Utilisez {counter} dans la réponse de chat de la récompense pour afficher le nouveau total.

  • Désactivé par défaut, la plupart des récompenses n'en ont pas besoin.
  • Par spectateur + récompense est souvent le bon choix: chaque spectateur bâtit son propre compte d'échanges pour cette récompense.
Le bloc compteur de l'éditeur de récompense: un interrupteur, un nom, et les mêmes quatre portées.

Essayez-le dans le constructeur Le constructeur de commandes peut vous guider pour nommer un compteur et choisir sa portée, puis vous remet le jeton {counter:…} terminé. Ouvrir le constructeur de commandes →