Trigger

Trigger reagieren automatisch auf bestimmte Wörter oder Phrasen im Chat und senden danach eine vordefinierte Antwort.

Übersicht im Dashboard

Auf dieser Seite definierst du Trigger, steuerst Cooldowns und Rollen und legst die Bedingungen fest, wann ein Trigger aktiv ist.

Trigger erstellen

Beim Anlegen vergibst du einen eindeutigen Namen, setzt den Status, definierst die Antwort und legst Global/User-Cooldowns fest. Zusätzlich kannst du bestimmen, ob der Trigger nur online, nur offline oder immer aktiv ist, eine Mindestanzahl an Bits verlangen und Rollen erlauben oder ausschließen. Unter Auslöser wählst du, worauf der Trigger reagiert: auf eine Chat-Nachricht oder auf ein Power-Up.

Auslöser: Chat oder Power-Up

  • Chat ist die Standardeinstellung. Unter Phrasen definierst du, worauf der Bot reagieren soll (mindestens eine Phrase ist Pflicht).
  • Power-Up lässt den Trigger feuern, wenn ein Zuschauer ein bestimmtes Power-Up einlöst. Du wählst es aus einer Liste – deine eigenen Custom Power-Ups und die drei eingebauten Effekte (Emote vergrößern, Feier, Nachrichteneffekt). Phrasen gibt es hier nicht, der Trigger matcht direkt auf das gewählte Power-Up.

Bei Power-Up-Triggern zählt Mind. Bits die Kosten des Power-Ups – nützlich bei den eingebauten Effekten, deren Preis der Zuschauer selbst wählen kann. Rollen-Einstellungen (erlauben/ausschließen) werden hier ausgeblendet, weil eine Power-Up-Einlösung keine Rolleninformation mitliefert.

Power-Up-Trigger setzen Affiliate oder Partner voraus. Schaltest du einen bestehenden Chat-Trigger auf Power-Up um, werden seine Phrasen gelöscht.

Phrasen (Match)

Für Phrasen kannst du Match-Typen wie enthält, exakt, beginnt mit, endet mit oder RegEx wählen. Teilwort OK lässt hallo auch in hallihallo auslösen, Ganzes Wort verlangt ein freistehendes Wort. Bei Case-sensitiv wird Groß- und Kleinschreibung beachtet.

RegEx

RegEx ist für fortgeschrittene Muster. Du schreibst das Muster ohne Schrägstriche, z. B. ^https?:// oder hallo|hi. Die Option Case-sensitiv wirkt auch bei RegEx. Ganzes Wort gilt nur für normale Matches, nicht für RegEx. Wenn RegEx fehlschlägt oder riskant ist, wird die Phrase ignoriert.

Antworttext und Variablen

Deine Antwort kann diese Variablen enthalten: {user}, {login}, {channel}, {message}, {bits}. Ausgaben, die wie Commands wirken, werden bereinigt (z. B. kein !command).

Bei Power-Up-Triggern kommen {title} (Name des Power-Ups) und {input} (Eingabe des Zuschauers) dazu. {input} füllt nur ein Custom Power-Up, bei dem du eine Eingabe verlangst – bei den eingebauten Effekten bleibt es leer. {message} enthält bei Power-Up-Triggern denselben Text wie {input}.

Wie die Ausführung funktioniert

  • Phrasen werden gegen die Nachricht gematcht (Leerzeichen werden normalisiert).
  • Pro Nachricht feuert maximal ein Trigger (der erste Treffer in der Prioritätsliste). Bei Power-Ups gilt dasselbe pro Einlösung.
  • Spezifischere Trigger werden zuerst geprüft (RegEx, exakt, längere Phrasen, ganzes Wort).
  • Command-ähnliche Nachrichten werden ignoriert (z. B. !so).
  • Eigene Bot-Nachrichten werden ignoriert.
  • Dedupe: gleiche Nachricht wird nur einmal verarbeitet.

Hinweise

  • /timeout und /ban können hier nicht als Antwort genutzt werden. Verwende dafür die Wortfilter.