01Die Anatomie eines Befehls
Ein eigener Befehl ist eine Frage, die deine Zuschauer stellen können
(!knuddel), und die Antwort, die dein Bot darauf gibt. Der Editor hat acht Felder;
nur Name und Antwort sind Pflicht.
- 01 Name: Was Zuschauer nach dem „!“ eingeben. Kleinbuchstaben, ein einzelnes Wort.
- 02 Alternative Namen: zusätzliche Auslöser für denselben Befehl (!knuddel und !knuddeln können ein Befehl sein).
- 03 Antwort: Was der Bot sagt. Bis zu 5 Zeilen; jede Zeile ist eine eigene Chat-Nachricht.
- 04 Der Chat-Probelauf spielt deine Antwort mit Beispielwerten durch, bevor du speicherst. Der Befehls-Builder hat denselben.
- 05 Zugriff und Abklingzeiten: wer ihn nutzen kann, wie lange alle nach jeder Verwendung warten und wie lange jeder Zuschauer zwischen seinen eigenen Verwendungen wartet.
- 06 Nur während des Live-Streams parkt den Befehl, wenn der Stream offline ist; Aktiv ist der Ein-/Ausschalter.
- 07 Datenquelle: fügt einen Wert ein, der aus einer deiner Datenquellen abgerufen wurde, anstatt einer Variable.
{urlfetch:name} ein, einen Wert aus
einer Datenquelle, die du selbst gespeichert hast. Der Leitfaden zu Datenquellen erklärt, wie du die erste speicherst.02Zwei Wege, einen zu erstellen
Im Dashboard
Öffne Befehle, klicke auf Neuer Befehl, fülle Name und Antwort aus und klicke dann auf Erstellen. Im Chat antwortet er meist innerhalb weniger Sekunden. Bearbeiten funktioniert genauso: Klicke auf eine Befehlszeile, ändere sie und speichere.
Aus dem Chat, mit !cmd
Du und deine Moderatoren könnt Befehle auch verwalten, ohne den Chat zu verlassen, mitten im Stream.
Jeder Moderator kann das ausführen: !cmd erfordert nicht die Beförderung zum leitenden
Moderator, die manche andere integrierte Befehle verlangen.
⚔ Ayshacinder !cmd add hype LOS GEHT’S 🎉
ItsBagelBot @Ayshacinder der Befehl hype wurde hinzugefügt
SnackPackPanda !hype
ItsBagelBot LOS GEHT’S 🎉
!cmd add <name> <antwort>erstellt einen Befehl.!cmd edit <name> <antwort>ersetzt seine Antwort.!cmd remove <name>löscht ihn.
03Variablen: die smarten Teile
Schreib {user} in eine Antwort, und der Bot ersetzt es durch den Namen
der Person, die den Befehl ausgelöst hat. Das ist eine Variable: ein Platzhalter, den der Bot im
Moment der Antwort ausfüllt. Jede Variable, die er versteht, mit ihrer genauen Syntax und einem
konkreten Beispiel, steht in der Variablen-Referenz.
Füge in den geschweiften Klammern einen senkrechten Strich und einen Text hinzu, damit eine Variable etwas
sagen kann, wenn sie leer zurückkommt: hug {touser|alle} umarmt die genannte Person
oder alle, wenn niemand genannt wurde.
SnackPackPanda !hug
ItsBagelBot SnackPackPanda gibt allen eine warme Bagel-Umarmung 🥯
SnackPackPanda !hug MikanMeerkat
ItsBagelBot SnackPackPanda gibt MikanMeerkat eine warme Bagel-Umarmung 🥯
04Mehrere Zeilen und Chat-Aktionen
Eine Antwort kann bis zu 5 Zeilen enthalten, und jede Zeile wird als eigene Chat-Nachricht gesendet, von oben nach unten. Und eine Zeile, die mit einem dieser Befehle beginnt, wird zu einer nativen Twitch-Aktion statt zu einer normalen Nachricht:
| Zeile beginnt mit | Was passiert |
|---|---|
/me | Kursive „Aktion“-Nachricht im klassischen IRC-Stil. |
/announce | Eine hervorgehobene Twitch-Ankündigung. Farbvarianten: /announceblue, /announcegreen, /announceorange, /announcepurple. |
/shoutout | Ein natives Twitch-Shoutout an den ersten Namen in der Zeile. |
/pin | Sendet die Nachricht und heftet sie bis zum Ende des Streams an. |
SnackPackPanda !gewinnspiel
Ankündigung · Das Gewinnspiel LÄUFT! Tippe !enter, um mitzumachen.
ItsBagelBot Der Gewinner wird zur vollen Stunde gezogen. Viel Glück! 🍀
{args},
{touser}) wird bereinigt, bevor er in der Nachricht landet: Niemand kann einen
/ban oder /timeout in die Ausgabe deines Befehls schmuggeln.05Die Spielregeln
Der Editor prüft all das für dich und sagt in einfachen Worten, was nicht stimmt. Zur Übersicht:
| Feld | Die Regel |
|---|---|
| Name | 1 bis 64 Zeichen, ohne Leerzeichen und ohne das „!“ (der Chat fügt es hinzu). Wird in Kleinbuchstaben gespeichert: !Hug und !hug sind derselbe Befehl. |
| Alternative Namen | Bis zu 25, jeder nach denselben Regeln wie der Name. |
| Antwort | Bis zu 5 Zeilen mit je 500 Zeichen (eine Chat-Nachricht pro Zeile). |
| Gemeinsame Abklingzeit | 0 bis 86400 Sekunden. Sie gilt für den gesamten Chat: Nachdem jemand den Befehl genutzt hat, warten alle. 0 schaltet sie aus. |
| Abklingzeit pro Zuschauer | 0 bis 86400 Sekunden. Jeder Zuschauer wartet so lange zwischen seinen eigenen Verwendungen; alle anderen können den Befehl weiterhin ausführen, sobald die gemeinsame Abklingzeit abgelaufen ist. Alternative Namen zählen als derselbe Befehl. 0 schaltet sie aus. |
| Zugriff | Mindestrang, in dieser Reihenfolge: Alle, Abonnenten, VIPs, Moderatoren, leitende Moderatoren, Kanalinhaber. Jede Stufe schließt alle darüber ein. |
| Auf Nutzer-ID beschränken | Beschränke einen Befehl optional auf ein einzelnes Twitch-Konto; das überschreibt die Zugriffsstufe vollständig. Ideal für den persönlichen Befehl eines Freundes. Das Feld nimmt nur Ziffern an: die Twitch-Nutzer-ID, nicht den Nutzernamen. Um eine ID zu finden, nutze eine Twitch-Nutzer-ID-Suche, der du vertraust, oder ein Moderationswerkzeug, das Nutzer-IDs anzeigt. |
06Ohne Tippen: der Befehls-Builder
Dieser ganze Leitfaden ist im Befehls-Builder eingebaut: Wähle Variablen aus einer beschrifteten Liste, statt sie auswendig zu lernen, sieh dir einen Live-Chat-Probelauf an, während du tippst, und wenn alles stimmt, sende den Befehl an dein Dashboard, wo ein Klick ihn erstellt. Das ist der kürzeste Weg von der Idee zum funktionierenden Befehl.