Automatiken & Variablen

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

Was eine Automatik 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 Automatik 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 Automatik 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 Automatik, 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 Automatik 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 Automatik 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.

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

Wo Automatiken stehen

Jede Automatik gehört zu einem Ort. Automatiken einer Funktion stehen auf ihrer Seite im Reiter Auslöser, zum Beispiel „Glücksrad drehen bei Follow“. Automatiken, 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 Automatik findest du mit Strg+K: Tippe ihren Namen oder ein Wort aus ihrem Satz, und die Seite mit der Automatik öffnet sich gleich im Editor. Automatiken einer Leinwand oder eines eigenen Overlays stehen auf seiner Seite im Reiter Auslöser, je Aktion des Overlays unter Startet durch.

Automatik 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 Automatik 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 Automatik 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 Automatik.

Mehrere Aktionen und Wartezeit

Eine Automatik 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 Automatik läuft:

• Sofort: Die Automatik läuft gleich los, auch wenn gerade ein Alert zu sehen ist.
• Nacheinander mit den Alerts: Die Automatik 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 Automatik startet bei jeder davon. Mit ＋ Neuer Befehl… gibst du einen Namen ein, der nur für diese Automatik 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 Automatik 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 Automatik 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 Automatik 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 Automatik 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 Automatik, 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 Automatik, 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 Automatik, 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, mit Audioquelle steuern das Mikrofon oder den Desktop-Ton stumm oder laut schalten oder die Lautstärke einstellen (auf Wunsch mit Überblenden) 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.
• Twitch: einem Kanal einen Shoutout geben, zum Beispiel wer dich raidet, oder eine farbige Ankündigung im Chat schreiben. Dazu Clip erstellen (der Link auf Wunsch in eine Variable), Twitch-Umfrage starten und Vorhersage starten. Diese drei brauchen zusätzliche Rechte, verbinde den Kanal dafür unter Verbindungen einmal neu.
• Moderation: Timeout geben, Bannen, Bann oder Timeout aufheben, den Chat-Modus schalten (Slow, Nur Follower, Nur Abonnenten, Nur Emotes, Einzigartiger Chat) und mit Nachricht löschen die Nachricht entfernen, die die Automatik ausgelöst hat. Mods und der Kanal bekommen nie einen Timeout oder Bann.
• Stream: dazu Titel und Kategorie setzen (Kategorie per Name, leere Felder bleiben, wie sie sind) sowie Raid starten und Raid abbrechen.
• OBS: dazu Stream starten oder beenden und Aufnahme oder Wiederholungspuffer (Aufnahme starten, beenden, umschalten oder den Wiederholungspuffer speichern, OBS-Plugin ab 0.15.0).
• Automatik: eine andere Automatik an oder aus schalten oder ausführen und eine Funktion über ihren Schalter Aktiv an oder aus schalten.
• Variablen: mit Zufallswert kommt eine Zufallszahl oder ein zufälliger Eintrag einer Liste in eine Variable. In Texten würfelt {{zufall:1-6}} eine Zahl und {{zufall:Kopf|Zahl}} wählt einen Eintrag.
• Ansage: dazu Ton abspielen: ein eigener Ton (MP3, WAV, OGG oder M4A) im Takt der Alerts. Es spielt das Alert-Overlay, die Sound-Player nach ihrer Automatik für Ansagen.
• Benachrichtigung: Webhook aufrufen schickt JSON oder Text an eine eigene https-Adresse, zum Beispiel an deine Heimautomation. Die Adresse wird verschlüsselt gespeichert, interne Adressen gehen nicht. Push aufs Handy schickt eine eigene Benachrichtigung an alle Geräte mit Push. Wer eigene Events stummschaltet, bekommt sie nicht.
• 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 Automatik: 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 Automatiken 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 Automatiken 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 Automatiken 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 Automatik 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 Automatiken, 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 Automatik 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 Automatik 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.