01L'anatomie d'une commande
en bref Deux champs obligatoires, cinq réglages optionnels. Apprenez-les une fois, réutilisez-les toujours.
Une commande personnalisée, c'est une question que vos spectateurs peuvent poser
(!calin) et la réponse que votre bot donne. L'éditeur compte sept champs;
seuls le nom et la réponse sont obligatoires.
sesame_sam!calin ferret_king
ItsBagelBotsesame_sam donne à ferret_king un gros câlin bagel 🥯
4- 1Nom: ce que les spectateurs tapent après le «!». Minuscules, un seul mot.
- 2Noms alternatifs: des déclencheurs supplémentaires pour la même commande (!calin et !calins peuvent ne faire qu’un).
- 3Réponse: ce que le bot dit. Jusqu’à 5 lignes; chaque ligne est son propre message de chat.
- 4La répétition du chat joue votre réponse avec des valeurs d’exemple avant d’enregistrer. Le constructeur de commandes a la même.
- 5Accès et délai: qui peut l’utiliser, et combien de secondes de silence suivent chaque utilisation.
- 6Uniquement pendant le direct met la commande en pause hors ligne; Active est l’interrupteur général.
02Deux façons d’en créer une
en bref L'éditeur du tableau de bord, ou une seule ligne dans le chat. Les deux arrivent au même endroit.
Depuis le tableau de bord
Commandes → Nouvelle commande → remplissez nom et réponse → Créer. Elle répond dans le chat généralement en quelques secondes. La modification fonctionne pareil: cliquez une commande, changez-la, enregistrez.
Depuis le chat, avec !cmd
Vous et vos modérateurs pouvez aussi gérer les commandes sans quitter le chat, en plein stream:
mod_sam !cmd add hype ON LÂCHE PAS 🎉
ItsBagelBot @mod_sam la commande hype a été ajoutée
maya_live !hype
ItsBagelBot ON LÂCHE PAS 🎉
!cmd add <nom> <réponse>crée une commande.!cmd edit <nom> <réponse>remplace sa réponse.!cmd remove <nom>la supprime.
Astuce Le chat est rapide pour les petites phrases; le tableau de bord montre les réglages supplémentaires (accès, délai, autres noms) et un aperçu en direct. Utilisez ce qui est le plus près de vos mains.
03Les variables: les parties intelligentes
en bref Les accolades sont des espaces réservés. Le bot les remplit au moment de répondre.
Écrivez {user} dans une réponse et le bot le remplace par le nom
de la personne qui a lancé la commande. Cette seule idée alimente tout ce qui suit.
Voici les variables de personnes et de lieux que toute commande personnalisée comprend:
| Variable | Devient | Exemple |
|---|---|---|
{user} | La personne qui a utilisé la commande. {sender} est un ancien alias, même valeur. | maya_live |
{touser} | Le premier mot tapé après la commande, sans le «@». Si rien n'est tapé, le nom du spectateur lui-même. {target} est identique. | alex |
{args} | Tout le texte tapé après la commande, en une seule chaîne. Vide si rien n'a été tapé. | bonne chance! |
{channel} | Le nom d'affichage de votre chaîne. | votre_chaine |
maya_live !calin
ItsBagelBot maya_live donne à maya_live un gros câlin bagel 🥯
maya_live !calin alex
ItsBagelBot maya_live donne à alex un gros câlin bagel 🥯
Attention
Une variable que le bot ne reconnaît pas reste telle quelle, accolades comprises. Si le
chat affiche un {quelquechose} littéral, vérifiez l'orthographe
dans le tableau ci-dessus (ou composez la commande dans le
constructeur, qui ne propose que de vraies variables).
04Dés, choix et compteurs
en bref Trois variables qui changent à chaque fois: nombres aléatoires, choix aléatoires et compteurs qui se souviennent.
{random}: les dés
{random} devient un nombre entier de 1 à 100. Choisissez votre
propre plage avec {random:1-6} (les deux bornes comptent).
{choice:…}: une pièce à autant de faces que vous voulez
{choice:oui,non,redemande plus tard} choisit une option de votre
liste séparée par des virgules, différente à chaque fois.
{counter:…}: un nombre qui se souvient
{counter:chutes} ajoute 1 au compteur nommé «chutes» et affiche
le nouveau total. Le compte survit aux streams: !chute peut suivre vos
dégringolades toute l'année. Chaque compteur a une portée, choisie à sa création, qui
détermine à qui appartient ce nombre: un seul total pour la chaîne, un par spectateur,
un groupé par commande ou récompense, ou un par spectateur et par commande. Le
guide des compteurs présente les quatre avec des
exemples.
maya_live !roll
ItsBagelBot maya_live lance un 73 sur 100 🎲
alex !chute
ItsBagelBot votre_chaine est tombé 128 fois. Un nouveau record de grâce.
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 le {counter:…} reste du texte littéral.
Vos modérateurs gèrent les comptes dans le chat avec !counter set,
!counter reset et compagnie.
05Plusieurs lignes et actions de chat
en bref Chaque ligne devient son propre message. Une ligne peut aussi annoncer, faire un shoutout ou épingler.
Une réponse peut contenir jusqu'à 5 lignes, et chaque ligne est envoyée comme son propre message, de haut en bas. Et une ligne qui commence par un de ces verbes devient une action Twitch native au lieu d'un message ordinaire:
| La ligne commence par | Ce qui se passe |
|---|---|
/me | Message «action» en italique, style IRC classique. |
/announce | Une annonce Twitch mise en évidence. Variantes de couleur: /announceblue, /announcegreen, /announceorange, /announcepurple. |
/shoutout | Un shoutout Twitch natif vers le premier nom de la ligne. |
/pin | Envoie le message et l'épingle jusqu'à la fin du stream. |
maya_live !concours
annonce · Le concours est LANCÉ! Tapez !enter pour participer.
ItsBagelBot Gagnant tiré à l'heure pile. Bonne chance! 🍀
Sécurité intégrée
Le texte fourni par les spectateurs ({args},
{touser}) est nettoyé avant d'atterrir dans le message: personne
ne peut glisser un /ban ou un /timeout dans la sortie de votre
commande.
06Les règles du jeu
en bref Noms, limites, délais et niveaux d'accès. Tout ce que l'éditeur accepte et refuse.
L'éditeur vérifie tout cela pour vous et dit ce qui cloche en mots simples. Pour référence:
| Champ | La règle |
|---|---|
| Nom | 1 à 64 caractères, sans espaces, et sans le «!» (le chat l'ajoute). Stocké en minuscules: !Calin et !calin sont la même commande. |
| Noms alternatifs | Jusqu'à 25, chacun suivant les mêmes règles que le nom. |
| Réponse | Jusqu'à 5 lignes de 500 caractères chacune (un message de chat par ligne). |
| Délai | 0 à 86400 secondes. Il est partagé par tout le chat: après une utilisation, tout le monde attend. |
| Accès | Rang minimal, dans l'ordre: tout le monde → abonnés → VIP → modérateurs → modérateurs principaux → diffuseur. Chaque niveau inclut ceux au-dessus. |
| Restreindre à une personne | Verrouillez une commande sur un seul compte Twitch; cela remplace entièrement le niveau d'accès. Parfait pour la commande personnelle d'un ami. |
07Évitez la saisie: le constructeur
en bref Composez une commande en cliquant, prévisualisez-la en direct, envoyez-la dans votre tableau de bord.
Tout ce guide est intégré au constructeur de commandes: choisissez les variables dans une liste expliquée au lieu de les mémoriser, regardez une répétition de chat en direct pendant que vous tapez, et quand tout sonne juste, envoyez la commande à votre tableau de bord, où une confirmation la crée en un clic. C'est le chemin le plus court entre l'idée et la commande qui fonctionne.
Essayez maintenant Ouvrir le constructeur de commandes →