strAImer strAImer
Se connecter

Commandes Personnalisées

Les gens demandent cela comme

Fourni avec strAImer : ce module s'installe avec l'application, il n'y a donc rien à télécharger. Il figure dans Catalogue de modules → Intégrés.

Ce qu'est cette page

Chat Bot → Commandes de chat est l'endroit où se trouvent les commandes texte personnalisées ; la page elle-même est intitulée Commandes Personnalisées, "Gérer les commandes de texte personnalisées pour le chat". Une commande est un déclencheur que le chat tape et une réponse que le bot écrit en retour, avec des variables substituées dedans.

Une commande fonctionne quel que soit l'endroit où vous la tapez : le chat de la plateforme, le fil de chat du Panneau de contrôle ou la zone de message de l'application. Seule une vraie commande compte : vos messages ordinaires ne déclenchent jamais le bot, il ne se met donc pas à se parler à lui-même.

Comment la configurer

La page a deux onglets, Commandes et Variables, chacun avec son compte entre parenthèses. Le bouton en haut à droite suit l'onglet sur lequel vous êtes — Ajouter une Commande ou Ajouter une Variable.

Une installation neuve n'est pas vide : le module y place une commande prête à l'emploi pour que vous la voyiez fonctionner. Elle s'appelle commands, répond à !commands, !help et !cmds, et renvoie "Commands: {commands}", la liste de toutes vos commandes, avec un temps de recharge de 15 secondes pour tout le monde. Modifiez-la ou supprimez-la comme n'importe quelle autre ; une fois supprimée, elle ne revient pas.

Une commande

  1. Ouvrez Chat Bot → Commandes de chat, restez sur l'onglet Commandes et appuyez sur Ajouter une Commande. Le formulaire est intitulé Créer une Commande.
  2. Nom de la commande (pour vous) — un titre que vous reconnaîtrez dans la liste, les espaces sont autorisés : "Mon serveur Discord". Les majuscules sont conservées telles que tapées. Un nom en un seul mot sert aussi de déclencheur dans le chat ; un nom avec des espaces ne peut pas être tapé, donc une telle commande a besoin d'au moins un déclencheur et l'enregistrement sans déclencheur est refusé.
  3. Déclencheurs que les viewers tapent (séparés par des virgules) — les mots qui déclenchent la commande, l'espace réservé montre le format : discord, ds. Le premier est le principal — c'est ce que la liste {commands} montre — tandis que la commande répond à tous. Ils s'écrivent sans ! et séparés par des virgules. Les majuscules sont aussi conservées ici.
  4. Mode de Déclenchement — Le message commence par !commande, ou Mot n'importe où dans le message. Le second est marqué sur la carte par un badge mot-clé.
  5. Réponse de la Commande — ce que le bot écrit, par exemple "Rejoins notre serveur, {user} !". Sous le champ se trouve "Cliquez sur une variable pour l'insérer dans la réponse :" et une rangée de puces — {user}, {target}, {args}, {count}, {random:1-100}, {choose:a|b|c}, {randuser}, {channel}, {commands}, {auction_rules}, {time}, {date}, {math:}, {repeat:3:}. Un clic en dépose une au niveau du curseur. Trois onglets se trouvent au-dessus de la rangée — Intégrés, Les vôtres et Base de connaissances — ainsi vos propres variables et vos liens de référence sont aussi à un clic.
  6. Temps de recharge (sec) commence à 10, Temps de recharge par utilisateur (sec) à 0. En dessous se trouve la case à cocher Les modérateurs et le streamer ignorent le temps de recharge.
  7. Rôles Autorisés — Tout le monde, Abonné, VIP, Modérateur, Diffuseur. Tout le monde est coché sur une nouvelle commande, et ne cocher rien du tout enregistre aussi comme Tout le monde.
  8. Répondre uniquement lorsque — une condition, Toujours par défaut. La section ci-dessous l'explique.
  9. Appuyez sur Enregistrer, ou Annuler. Sans nom et sans réponse, le formulaire répond "Remplissez le nom de la commande et la réponse !" et reste ouvert.
  10. Une carte est intitulée par le nom de la commande seul, avec le badge des rôles à côté et un badge de condition quand il y en a une. La ligne en dessous contient les alias, en couleur et avec leur !, suivis de la réponse ; viennent ensuite le temps de recharge, le temps de recharge par utilisateur et le nombre de fois où elle a été déclenchée. La ligne affiche tous les déclencheurs auxquels la commande répond : les vôtres plus le nom lui-même quand il tient en un seul mot ; une répétition n'apparaît qu'une fois. L'interrupteur désactive la commande sans la supprimer ; à côté se trouvent Modifier et Supprimer, et la suppression demande "Supprimer cette commande ?".

Une variable personnelle

  1. Passez à l'onglet Variables et appuyez sur Ajouter une Variable — le formulaire est Créer une Variable.
  2. Nom de la Variable — lettres, chiffres et _ uniquement ; le champ met en minuscule ce que vous tapez et supprime le reste. L'indice en dessous montre le résultat : "Utilisé dans les réponses comme {name}".
  3. Valeurs (une par ligne) — l'espace réservé montre trois lignes, pizza, sushi, burger. "Une valeur aléatoire de la liste est insérée lorsque la commande est déclenchée".
  4. Appuyez sur Enregistrer. Un nom répété est refusé avec "Une variable avec ce nom existe déjà !", un formulaire incomplet avec "Indiquez un nom et au moins une valeur !".
  5. La carte montre {name}, combien de valeurs elle contient et les valeurs elles-mêmes. Modifier rouvre le formulaire en tant que Modifier la Variable avec le nom et les valeurs actuels déjà remplis, de sorte que les valeurs sont corrigées plutôt que retapées. Supprimer avertit d'abord : "Supprimer cette variable ? Les commandes qui l'utilisent cesseront de la substituer."

Répondre seulement parfois

Répondre uniquement lorsque contient une condition, et Toujours — aucune condition — est ce qu'une nouvelle commande obtient.

Répondre lorsque la condition n'est pas remplie est la deuxième réponse. Elle prend les mêmes variables et liens de référence — et sa propre rangée de puces, donc un clic là atterrit dans ce champ et non dans celui du dessus. "Pas d'enchère en ce moment — la prochaine est vendredi !" est une réponse complète. Laissez-la vide et la commande ne dit rien du tout ; une commande silencieuse ne dépense pas son temps de recharge, donc le prochain viewer qui demande au bon moment obtient quand même une réponse.

Enregistrer une condition de jeu avec un champ de jeux vide est refusé : la condition ne correspondrait jamais et la commande serait silencieuse pour toujours.

Liens de référence et règles d'enchère

Deux autres choses peuvent être déposées dans une réponse et sont conservées à un seul endroit au lieu d'être retapées.

Les accolades sont simples, comme toute autre variable. Les doubles accolades {{...}} fonctionnent toujours — c'était l'ancienne orthographe, et les anciens textes continuent de fonctionner. Les variables intégrées sont lues en premier, donc une référence nommée time n'écrasera pas la variable {time} ; évitez simplement de nommer les liens d'après les variables.

La référence

Référence des Variables en haut ouvre Variables Disponibles — chaque variable intégrée avec sa signification et un exemple concret : {display_name}, {user.id}, {touser}, {args:0|default}, {count+10}, {channel} et le reste, avec les vôtres à la fin de la liste.

Pourquoi une commande ne répond pas

Une commande qui reste silencieuse laisse une ligne avec [Skipped] dans la Console des logs système en bas de la fenêtre de l'application. Cette même ligne donne la raison entre crochets :

  1. [NoMatch] : aucune commande ne répond à ce mot. Vérifiez l'orthographe du déclencheur et que l'interrupteur de la commande est activé : une commande désactivée compte comme absente. Seuls les mots tapés avec ! sont journalisés ; une commande en Mot n'importe où dans le message ne laisse aucune ligne quand elle ne correspond pas.
  2. [Cooldown] : la commande a répondu il y a moins de Temps de recharge (sec), 10 secondes sur une nouvelle commande, ou ce viewer est encore soumis au Temps de recharge par utilisateur (sec). Le temps de recharge compte aussi pour vous : taper deux fois de suite la même commande pour la tester donne une seule réponse. Cochez Les modérateurs et le streamer ignorent le temps de recharge pour tester librement.
  3. [Permission] : l'auteur n'a aucun des Rôles Autorisés. Les rôles supérieurs incluent les inférieurs : un modérateur a accès à une commande réservée aux VIP ou aux abonnés, et vous avez accès à toutes.
  4. [Condition] : Répondre uniquement lorsque n'est pas rempli et Répondre lorsque la condition n'est pas remplie est vide. Une commande réglée sur Le stream est en direct reste silencieuse hors direct.

Aucune ligne du tout pour une commande ! signifie que le message n'a jamais atteint l'application : la plateforme n'est pas connectée sous Connexions → Chaînes, ou le module est désactivé. Une ligne avec [Success] et rien dans le chat signifie que la plateforme n'a pas accepté la réponse. Sur YouTube, la raison habituelle est le bot : les réponses partent de lui, et un bot qui n'est pas connecté pour le chat n'envoie rien, avec "No bot session" dans le journal. Connectez-le sous Connexions → Bots.

Ce qu'elle ne peut pas faire