Regeln & Variablen

Mit Regeln reagiert dein Stream von selbst auf Ereignisse. Eine Regel sagt: Wenn etwas passiert und die Bedingungen passen, dann führe diese Aktionen aus. Variablen sind Zahlen oder Texte, die Regeln ändern und Overlays anzeigen.

Was eine Regel ist

• Wenn: das Ereignis, zum Beispiel ein Follow, Bits, ein eingelöster Gegenstand, ein Chat-Befehl, der Start des Streams oder der Wechsel zu einer Szene in OBS.
• Bedingungen: schränken ein, wann die Regel gilt. Ohne Bedingung gilt sie immer.
• dann: eine oder mehrere Aktionen, zum Beispiel ein Overlay zeigen, eine Variable erhöhen, eine Nachricht im Chat schreiben, Punkte im Scoreboard vergeben oder einen Hinweis in einer Einblendung zeigen. Hast du mehrere Scoreboards oder Einblendungen, wählst du in der Aktion, welche gemeint ist.

In der Liste steht jede Regel als Satz, zum Beispiel: Wenn Gegenstand eingelöst (Gegenstand „Happy Hour“), dann Overlay „Ereigniskarte“ zeigen (1 h). Mit dem Schalter Aktiv in ihrer Zeile pausierst du eine Regel, ohne sie zu löschen. Daneben stehen ▶ Testen und Bearbeiten, Entfernen findest du im Menü ⋯.

Auslöser einer Funktion

Jede Funktion hat den Reiter Auslöser. Oben unter Startet durch steht je Aktion der Funktion, was sie auslöst, zum Beispiel beim Glücksrad unter Glücksrad drehen: Kanalpunkte „Dreh am Rad“, !spin im Chat oder ein Follow. Darunter unter Danach steht je Ereignis der Funktion, was danach passiert, zum Beispiel bei Glücksrad gestoppt eine Nachricht im Chat.

• ＋ Auslöser legt unter der Aktion eine Regel an. Die Aktion ist schon gewählt, du suchst nur das Ereignis aus. Die Vorschläge der Funktion stehen in der Auswahl ganz oben und, solange es noch keinen Auslöser gibt, als Knöpfe darunter.
• ＋ Folge legt unter einem Ereignis eine Regel an, die darauf reagiert. Ereignis und Funktion sind schon gewählt.
• Eingebaut sind feste Chat-Befehle der Funktion, zum Beispiel !rad. Ihre Schreibweisen stellst du unter Commands ein.
• Zeitplan zeigt, wann die Rangliste verteilt oder die Monatswertung auswertet. Eingestellt wird er in der Funktion.
• Belohnung zeigt Belohnungen am Ergebnis, zum Beispiel „Monatswertung: Platz 1“ bei den Tickets und „Platz 1: 3 Tickets geben“ bei der Monatswertung. Einstellen führt zur Funktion, die die Belohnung vergibt.
• Automatisch zeigt Meldungen, die eine andere Funktion von selbst in die Einblendung schickt, zum Beispiel die Watch-Streak der Rangliste. Einstellen führt zur Quelle, dort schaltest du sie an oder aus.
• Von Hand löst du jede Aktion in der Kachel Fernsteuern unter Danach aus. Dort steht auch, wie du sie per Stream Deck oder Steuer-API auslöst.

Regeln einer Funktion, die weder sie steuern noch auf sie hören, stehen darunter unter Weitere Regeln.

Wo Regeln stehen

Jede Regel gehört zu einem Ort. Regeln einer Funktion stehen auf ihrer Seite im Reiter Auslöser, zum Beispiel „Glücksrad drehen bei Follow“. Regeln, die zu keiner Anzeige gehören, sind Automatiken auf der Seite Automatik, zum Beispiel „Kanalpunkte wechseln die Szene“ oder „Danke im Chat“. Dort verwaltest du im Reiter Variablen auch die Variablen deines Kanals. Mehr unter Automatik.

Eine bestimmte Regel findest du mit Strg+K: Tippe ihren Namen oder ein Wort aus ihrem Satz, und die Seite mit der Regel öffnet sich gleich im Editor. Regeln einer Leinwand oder eines eigenen Overlays stehen auf seiner Seite im Reiter Auslöser, je Aktion des Overlays unter Startet durch.

Regel anlegen

1. Öffne die Seite einer Funktion im Reiter Auslöser und klicke unter der Aktion auf ＋ Auslöser (oder unter einem Ereignis auf ＋ Folge). Auf der Seite Automatik klickst du auf ＋ Automatik hinzufügen.
2. Wähle unter Wenn das Ereignis.
3. Lege bei Bedarf Bedingungen fest.
4. Wähle unter dann bei 1. Aktion die erste Aktion und fülle ihre Felder aus.
5. Klicke auf Anlegen. Die Regel wirkt sofort. Beim Bearbeiten heißt der Knopf Speichern.

Mehrere Auslöser

Unter Wenn fügst du mit ＋ Auslöser weitere Ereignisse hinzu, bis zu fünf. Jedes hat eigene Bedingungen. Die Regel läuft, sobald eines davon passt, zum Beispiel bei einem Follow oder bei Bits ab 100. Über ⋯ an seiner Zeile entfernst du einen Auslöser wieder. Dort duplizierst oder kopierst du ihn auch, ebenso jede Aktion. Einfügen neben ＋ Auslöser bzw. ＋ Aktion hängt Kopiertes an, auch in einer anderen Regel.

Mehrere Aktionen und Wartezeit

Eine Regel kann bis zu zehn Aktionen haben. Sie laufen der Reihe nach. Jede Aktion hat ein eigenes Feld Warten mit bis zu einer Stunde. So erscheint zum Beispiel erst ein Overlay und zehn Sekunden später eine Nachricht im Chat.

Ablauf

Unter Ablauf legst du fest, wann die Regel läuft:

• Sofort: Die Regel läuft gleich los, auch wenn gerade ein Alert zu sehen ist.
• Nacheinander mit den Alerts: Die Regel reiht sich hinter Alerts und Glücksrad ein. So überlappt nichts im Bild.

Bedingungen

• Ab und Bis: ab oder bis zu einer Menge, zum Beispiel ab 100 Bits. Leer heißt offen.
• Belohnung, Gegenstand oder Befehl: nur bei genau dieser Kanalpunkte-Belohnung, diesem Gegenstand oder diesem Chat-Befehl.
• Den Befehl wählst du aus deinen Befehlen unter Commands und denen anderer Automatiken. Jeder Befehl steht einmal mit allen Schreibweisen da, die Regel startet bei jeder davon. Mit ＋ Neuer Befehl… gibst du einen Namen ein, der nur für diese Regel gilt.
• Nachricht: nur bei Chatnachrichten. Jede Nachricht löst aus, oder nur eine, die den Text enthält bzw. genau so lautet. Groß- und Kleinschreibung ist egal.
• Wer darf: Alle, Abonnenten und höher, VIPs und höher, Moderatoren, nur du oder Bestimmte Personen. Bei Bestimmte Personen gibst du einen oder mehrere Twitch-Namen ein. Dann lösen nur diese Personen aus, egal welche Rolle sie haben.
• Nur in Szene: nur, wenn in OBS diese Szene zu sehen ist.
• Nur live: nur während der Stream läuft.
• Einmal je Person: jede Person löst die Regel nur einmal je Stream aus. Mit einem Zeitraum in Stunden gilt das über Streams hinweg, zum Beispiel 12 Stunden für erneutes Folgen.
• Auch im Shared Chat: bei Chat-Befehlen, Chatnachrichten, Abos, geschenkten Abos und Bits. Teilst du den Chat mit anderen Kanälen, lösen auch Nachrichten und Abos aus diesen Partnerkanälen die Regel aus. Ohne den Schalter zählt nur dein eigener Kanal. Wer darf richtet sich nach der Rolle in deinem Kanal. Der Wert Partnerkanal nennt den Kanal, im eigenen Kanal ist er leer.
• Sperrzeit: die Regel löst höchstens einmal in dieser Zeit aus, egal wer sie auslöst. So wie die Sperrzeit eines Chat-Befehls.
• Vergleiche: mit ＋ Vergleich prüfst du eine Variable oder einen Wert des Ereignisses, zum Beispiel tode mindestens 10, die Eingabe einer Belohnung enthält „ja“ oder der Name ist nicht dein Bot. Zur Wahl stehen ist, ist nicht, kleiner, größer, höchstens, mindestens, enthält, enthält nicht und beginnt mit. Im Wert gehen Variablen wie {{rekord}}, dann wird mit ihrem Inhalt verglichen.
• Mehrere Vergleiche: ab zwei Vergleichen wählst du unter Es gilt, wenn, ob alle passen müssen oder einer reicht.

Bots lösen nie eine Regel aus.

Grundregeln

Manche Funktionen reagieren von selbst, zum Beispiel zeigen Alerts bei jedem Follow einen Alert, und das Goal zählt Abos. Diese Reaktionen stehen als Grundregeln im Reiter Auslöser der Funktion, gekennzeichnet mit Grundregel:

• Alerts: je Art eine Regel, zum Beispiel „Wenn Follow, dann Alert Follow zeigen“. Der Zuschauerrekord hat die Bedingung Pause nach Raid (Vorgabe 60 Minuten), damit die Raid-Zuschauer ihn nicht verfälschen.
• Goal: je Kategorie eine Regel, zum Beispiel „Wenn Abo, dann zählt fürs Goal“. Die Punkte stehen weiter im Goal.
• Countdowns: „Wenn Stream beendet, dann hochzählende Countdowns anhalten“.
• Etiketten: je Abo-Art eine Regel, die ein Etikett anlegt. Der Schalter Aktiv im Design ist derselbe.

Eine Grundregel schaltest du an und aus, gibst ihr Bedingungen wie Nur live oder Einmal je Person und einen eigenen Namen. Ereignis und Aktion stehen fest. Entfernen lässt sie sich nicht, Zurücksetzen im Editor stellt Name und Bedingungen wie vorgegeben her. Die Schalter auf den Seiten Alerts und Goal sind dieselben Schalter: Änderst du einen, ändert sich der andere mit.

Ereignisse deiner Funktionen

Auch deine Funktionen melden Ereignisse, zum Beispiel Glücksrad gestoppt, Goal erreicht, Umfrage beendet, Tribunal-Urteil oder Alert gezeigt. In der Auswahl stehen sie unter dem Namen des Bausteins, zum Beispiel „Goalbar“, sobald du eine solche Funktion angelegt hast. Das Giveaway meldet zum Beispiel Gewinner gezogen und Teilnehmer dazu.

• Funktion: welche Funktion das Ereignis melden muss. Alle heißt jede Funktion dieser Art.
• Werte: stehen in den Vergleichen zur Wahl und gehen in Texten als Platzhalter, zum Beispiel %result% beim Glücksrad oder %goal% beim Goal. %module% ist der Name der Funktion.

Zwei Beispiele: Wenn Glücksrad gestoppt und Ergebnis enthält Kostüm, dann Szene wechseln. Wenn Goal erreicht, dann Glücksrad drehen.

Overlay zeigen

Die Aktion Overlay zeigen startet eine Aktion eines Overlays, zum Beispiel die Ereigniskarte. Mit einer Dauer läuft ein Timer. Kommt das Ereignis erneut, während er läuft, verlängert sich die Zeit, der Timer startet neu oder es passiert nichts. Auf Wunsch zählt das Overlay während der Laufzeit mit, zum Beispiel Abos. Laufende Overlays stehen oben in der Liste und lassen sich dort beenden.

Weitere Aktionen

• OBS: Szene wechseln, eine Quelle ein- oder ausblenden, einen Filter schalten oder mit Medienquelle steuern eine Medienquelle neu starten, abspielen, pausieren oder stoppen. Quellen und Filter wählst du aus der Liste, die OBS meldet. Ist OBS nicht verbunden, meldet die Aktion „OBS ist gerade nicht verbunden.“
• Licht: Leuchten in einer Farbe leuchten lassen oder an- und ausschalten. Einzelne Leuchten fügst du mit ＋ Leuchte hinzu. Ohne Auswahl gilt es für alle Leuchten. Die Farbe ist ein Farbcode wie #ff8800 oder ein Name wie rot.
• Discord: eine Nachricht über einen Webhook in einen Discord-Kanal schicken. Die Webhook-Adresse wird verschlüsselt gespeichert und nie wieder angezeigt. Lässt du das Feld beim Bearbeiten leer, bleibt die gespeicherte Adresse.
• Zuschauer: der Person des Ereignisses einen Gegenstand oder Giveaway-Tickets geben. Hat das Ereignis keine Person, passiert nichts. Bots bekommen nichts.
• Ansage: einen Text mit einer Stimme sprechen lassen, im Takt der Alerts. Mit Chat vorlesen schaltest du das Vorlesen des Chats an oder aus.
• Stream: einen Marker im laufenden Stream setzen, zum Beispiel für das spätere Schneiden. Mit Event erstellen landet das Ereignis als eigenes Event in deiner Event-Liste, mit Titel, Text und Symbol. So geht eine Kanalpunkte-Einlösung oder ein Wunsch aus dem Chat nicht unter, und du hakst es ab, wenn es erledigt ist.
• Eigene Funktionen: die Aktionen deiner eigenen Funktionen. Nutzt eine Aktion eine Liste, wählst du unter Eintrag einen bestimmten Eintrag oder lässt Zufällig stehen. Hast du mehrere Funktionen dieser Art, wähle zuerst die Funktion, dann erscheinen ihre Einträge.

In Texten gehen Platzhalter wie %user% und Variablen wie {{tode}}.

Manche Aktionen gehören zu einer Funktion, etwa Tickets geben. Sie stehen nur zur Auswahl, wenn die Funktion hinzugefügt ist.

Variablen

1. Lege auf der Seite Automatik im Reiter Variablen eine Variable an, zum Beispiel tode als Zahl mit Startwert 0. Schneller geht es in einer Regel: Neben jeder Auswahl einer Variable legt Neue Variable eine Zahl an, die bei 0 beginnt, und wählt sie gleich aus.
2. In Textfeldern von Overlays zeigst du sie mit {{tode}}. Ändert sich der Wert, ändert sich das Overlay sofort.
3. In Regeln setzt, erhöhst oder setzt du sie zurück. Ein Beispiel ist der Chat-Befehl !tod, der tode um 1 erhöht.

Variablen lassen sich auch von Hand setzen und zurücksetzen.

Werte der Funktionen

Deine Funktionen liefern Werte von selbst, zum Beispiel {{goal.prozent}}, {{gluecksrad.letztes}}, {{umfrage.fuehrend}} oder {{countdown.rest}}. Sie gehen überall, wo Variablen gehen: in Texten von Regeln und Ansagen, in Vergleichen, in Textfeldern von Overlays und auf Leinwänden. Hast du mehrere Funktionen einer Art, trägt die zweite eine 2 im Namen, zum Beispiel {{goal2.prozent}}.

Alle Werte mit ihrem aktuellen Stand stehen auf der Seite Automatik im Reiter Variablen unter Werte der Funktionen. Im Seitenpanel stehen sie beim gewählten Textfeld. Ändern lassen sie sich nur über die Aktionen der Funktion, zum Beispiel Goal-Punkte.

Vorlagen

Vorlagen legen fertige Regeln mit wenigen Angaben an. Fehlt eine Variable, legt die Vorlage sie gleich mit an.

So richtest du eine Happy Hour ein:

1. Öffne deine Ereigniskarte im Reiter Auslöser, klicke auf Aus Vorlage und wähle Happy Hour.
2. Wähle den Gegenstand und die Dauer, zum Beispiel 60 Minuten. Das Overlay der Ereigniskarte nimmt die Vorlage selbst.
3. Klicke auf Anlegen. Die Regel steht sofort unter Overlay zeigen.

Weitere Vorlagen:

• Bei einem Ereignis auslösen: gibt es für jede Funktion mit Aktionen. Du wählst ein Ereignis und eine Aktion der Funktion, zum Beispiel bei jedem Follow das Glücksrad drehen. Beim Chat-Befehl gibst du den Befehl an, beim Szenenwechsel die Szene. Die Felder der Aktion bekommen ihre Startwerte, ändern kannst du sie danach mit Bearbeiten.

Der Reiter Auslöser einer Funktion zeigt ihre Regeln, die passenden Vorlagen findest du dort unter Aus Vorlage. Fertige Automatiken ohne Bild, zum Beispiel Danke im Chat oder Variable bei Stream-Start zurücksetzen, wählst du auf der Seite Automatik unter ＋ Automatik hinzufügen.

Testen

Mit Testen führst du eine Regel mit Beispielwerten aus. Sie wirkt wie echt: Das Overlay erscheint in OBS, und eine Nachricht geht in den Chat. So siehst du sofort, ob alles passt. Gegenstände und Tickets verteilt ein Test nicht, er sagt nur, was passieren würde.

Hat das Ereignis eigene Werte und reagiert die Regel auf eine Funktion oder hat Vergleiche, fragt Testen erst nach den Werten, zum Beispiel nach dem Ergebnis des Glücksrads. Passen die Vergleiche bei diesen Werten nicht, sagt dir der Test das und löst nichts aus. Mehr Beispiele stehen unter Baukasten.