La_Syl Studio
Guide des widgets

Récompenses d’activité

Lance vos propres actions Streamer.Bot et poste des messages dans le chat quand le chat atteint les nombres de messages que vous fixez, pour tout le chat et pour chaque spectateur.

Récompense un chat animé. Quand tout le chat atteint 100 messages, ou qu'un spectateur atteint son 500e, Stream UI lance votre propre action Streamer.Bot — un son, un changement de scène, une participation à un concours, tout ce que vous construisez — et peut poster un message dans le chat.

Il n'a rien de visible : rien à l'écran, pas de position, pas de style, pas d'aperçu.

Plateformes : Twitch, YouTube, Kick

Pack d'actions : Stream UI - Backend quand c'est ce widget qui compte, et pour la pause → Pause et reprise. Inutile pour compter quand les comptes viennent du tableau des scores ou des cartes de viewers. → Qui a besoin de quoi

Vous comptez déjà les messages avec une stat du tableau des scores ou un score des cartes de viewers ? Activez Compté par le Tableau des scores (tout le chat) ou Compté par les Cartes de viewers (chaque spectateur) et les récompenses suivent son compte.

Fonctionnement

  • Deux comptes. Tout le chat compte tous les messages de toutes les plateformes activées. Chaque viewer compte les messages de chaque spectateur. Chacun a son interrupteur et ses propres récompenses.
  • Une fois par franchissement. Une récompense se déclenche quand son compte passe d'en dessous de son nombre à ce nombre ou plus. Son action reçoit le chatteur qui l'a atteint (voir Action arguments).
  • Un rechargement ne redéclenche rien. Ce qui est déjà compté au chargement de la source navigateur sert de point de départ.
  • Tourne dans l'overlay qui lance les actions, tant que le widget est activé — il n'a pas d'URL à lui. → Quel overlay lance les actions
  • Laissés de côté : les utilisateurs ignorés et vos propres comptes diffuseur et bot ne sont jamais comptés ni récompensés.

Qui compte

Compté iciCompté par le tableau des scores / les cartes de viewers
Tout le chatLa variable globale streamUi.chatRewards.countSur chaque plateforme activée, la variable globale temporaire de la première stat du tableau des scores dont les déclencheurs comptent les messages du chat de cette plateforme, ss.<platform>.<name>.currentScore, additionnées
Chaque viewerLa variable utilisateur chatMessages de chaque spectateurSur chaque plateforme, la variable de spectateur du premier score des cartes de viewers dont les déclencheurs comptent ses messages du chat (la première colonne, Today par défaut)

Le widget trouve ces stats dans les réglages du tableau des scores et des cartes de viewers : une plateforme qui n'en a pas ne compte rien.

Comptés ici, les comptes sont temporaires — effacés au redémarrage de Streamer.Bot — sauf si Compter depuis toujours est activé. Ils sont écrits dans Streamer.Bot par lots, environ une fois par seconde.

La page

La page du widget fonctionne comme une petite application, sans aperçu (rien à afficher) :

  • Réglages et Commandes, les onglets au-dessus de l'éditeur, changent ce qu'il affiche. Dans l'onglet Commandes, Pause et Reprendre et leurs déclencheurs → Pause et reprise.
  • La colonne de gauche liste ses deux comptes, Tout le chat et Chaque viewer, chacun avec son interrupteur sur sa ligne (tout le chat : activé, chaque spectateur : désactivé par défaut). Ils suivent l'interrupteur du widget, à côté du titre de la page : désactiver le widget les désactive tous les deux, l'activer les active tous les deux, et réactiver un compte réactive le widget. Les deux comptes désactivés, le widget est désactivé.
  • Tout le chat et Chaque viewer ouvrent chacun une colonne à eux : Variable, les réglages de ce compte, et Récompenses, qui ouvre la Liste des récompenses. Vous y ajoutez, réordonnez, dupliquez ou supprimez des récompenses ; celle choisie se modifie dans la zone principale.

Mise en place

Créez votre action dans Streamer.Bot

Créez l'action que la récompense lance. Pas besoin de déclencheur : Stream UI l'appelle par son nom.

Activez le widget

Il est dans le groupe Chat et activé par défaut, mais sa récompense par défaut n'a pas d'action : rien ne se passe tant que vous n'en choisissez pas une. L'interrupteur Ajouter à l’overlay à côté du titre de sa page l'active ou le désactive.

Ajoutez des récompenses

Dans Tout le chat ou Chaque viewer › Récompenses, choisissez une récompense dans la Liste des récompenses (ou Ajouter une récompense), réglez ses Messages et choisissez son Action Streamer.bot. Tester lance l'action tout de suite, avec un chatteur Twitch de démonstration.

Mettez à jour votre source navigateur

Recopiez l'URL de l'overlay qui lance les actions dans sa source navigateur → Disposition et source navigateur.

Réglages

Tout le chat et Chaque viewer

Les deux ont les mêmes lignes.

Variable :

RéglageDéfautDétail
Compté par le Tableau des scores (tout le chat), Compté par les Cartes de viewers (chaque spectateur)désactivéSuit le compte de messages du chat de ce widget au lieu de compter ici → Qui compte.
Compter depuis toujoursdésactivéGarde le compte de ce widget d'un redémarrage de Streamer.Bot à l'autre. Masqué quand le compte vient d'un autre widget.

Récompenses — sa Liste des récompenses, une récompense à 100 messages par défaut. Ajouter un palier en ajoute une ; chaque ligne se lit comme 100 messages → My action + chat message.

Chaque récompense, en deux parties : Réglages de la récompense (Messages et Action Streamer.bot, côte à côte) et Message dans le chat.

ChampDétail
MessagesLe compte qui la déclenche, à partir de 1.
Action Streamer.botL'action à lancer, choisie dans votre Streamer.Bot. Tester la lance tout de suite.
Message dans le chatEnvoyer un message dans le chat, puis Envoyer avec le bot et le message. Tout le chat : Publier sur choisit les plateformes. Chaque spectateur : il est posté dans le chat où le spectateur a écrit. Exemple affiché : GG {user}, {messageCount} messages!

Action arguments

Le widget n'envoie aucun événement à lui : quand une récompense se déclenche, Stream UI lance son action par son nom, comme le fait Run Action, avec ces arguments. Utilisez-les comme %variables% dans les sous-actions de l'action, par exemple un message Merci %user% pour tes %messageCount% messages !. Dans le message de chat d'une récompense, écrivez-les entre accolades : {user}, {messageCount}…

ArgumentExempleDétail
userPixelPandaLe pseudo affiché du chatteur.
userLoginpixelpandaSon login.
userId123456789Son identifiant sur la plateforme.
platformtwitchtwitch, youtube ou kick.
messageHello chat!Son dernier message.
messageCount100Le compte qui a atteint la récompense.
threshold100Le nombre de messages de la récompense.
scopechatchat (tout le chat) ou viewer (chaque spectateur).

Le chatteur est celui qui a atteint la récompense :

  • Tout le chat, compté ici — le spectateur dont le message l'a atteinte.
  • Tout le chat, compté par le tableau des scores — le dernier spectateur à avoir écrit sur la plateforme dont le compte a augmenté, sinon le dernier à avoir écrit, toutes plateformes confondues.
  • Chaque spectateur — ce spectateur. Compté par les cartes de viewers, message est son dernier message depuis le chargement de la source navigateur, vide s'il n'a pas écrit depuis.

Les arguments du chatteur sont vides quand personne n'a écrit depuis le chargement de la source navigateur. messageCount peut dépasser threshold quand un compte saute au-delà (l'autre widget en ajoutant plusieurs d'un coup). Tester envoie un chatteur Twitch de démonstration : un nom au hasard, userId demo, message Hello chat!, et messageCount égal à threshold.

Pause et reprise

En pause, aucune récompense ne se lance et aucun message n'est envoyé. Les messages ne sont pas comptés ici ; les comptes tenus par le tableau des scores ou les cartes de viewers continuent, et la reprise ne lance jamais les récompenses qu'ils ont passées entre-temps.

Dans l'onglet Commandes de la page du widget :

  • Commandes, la colonne de gauche, liste Pause et Reprendre, chacune avec les noms de ses déclencheurs. Choisissez-en une pour voir ses déclencheurs dans Liste des déclencheurs, à côté.
  • Liste des déclencheurs : les déclencheurs Streamer.Bot qui la lancent. Ajouter un déclencheur en ajoute un, conditions comprises → Déclencheurs et conditions.
    • Pause — par défaut : Stream Offline de Twitch.
    • Reprendre — par défaut : Stream Online de Twitch.
  • La zone principale indique Récompenses d’activité : En cours ou En pause, avec les boutons Reprendre et Pause, aussi dans la fenêtre de contrôles.

L'état est gardé dans Streamer.Bot, dans la variable globale persistante streamUi.off.chatrewards (1 : en pause ; 0 ou absente : actif) : la pause dure jusqu'à la reprise, même si la source navigateur se recharge. Vos propres actions peuvent aussi mettre en pause ou relancer le widget, avec une sous-action Global (Set) sur cette variable. Les boutons et les déclencheurs demandent l'action Stream UI - Backend.

Événements Streamer.Bot écoutés

ÉvénementCe qu'il déclenche
Vos déclencheurs Pause / ReprendreMet en pause ou relance le widget
Twitch.ChatMessage, YouTube.Message, Kick.ChatMessageUn message — compté, et retenu comme dernier chatteur
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreatedLe widget mis en pause ou relancé ailleurs (la page, la fenêtre de contrôles, vos actions) ; le compte de tout le chat du tableau des scores a changé, avec Compté par le Tableau des scores
Misc.UserGlobalVariableUpdatedLe compte d'un spectateur dans les cartes de viewers a changé. Seulement avec Compté par les Cartes de viewers

Seules les plateformes activées sur la page Réglages sont écoutées.