Skip to main content

​
Was sind Variablen?

Variablen sind Platzhalter, die du in den Antwort-Text eines Custom-Commands einbauen kannst. Sobald jemand den Command im Chat aufruft, ersetzt der Bot die Platzhalter durch die passenden Werte — z.B. den Namen des Users, eine Zufallszahl oder einen zufällig ausgewählten Wert aus einer Liste. So wird aus einem Command mit fester Antwort einer, der bei jedem Aufruf etwas anderes ausgibt. Beispiel

​
Grundregeln zur Schreibweise

Variablen haben immer die Form $(name) — ein Dollarzeichen, eine öffnende Klammer, der Name der Variable (bei manchen mit Zusätzen) und eine schließende Klammer.
  • Kleinschreibung — Variablen müssen genau so geschrieben werden wie in dieser Dokumentation (z.B. $(user), nicht $(User) oder $(USER)).
  • Beliebig oft kombinieren — du kannst so viele Variablen pro Antwort verwenden wie du willst.
  • Fehler brechen den Command nicht ab — ungültige Variablen werden still durch nichts (leeren Text) ersetzt (siehe Fehlerverhalten).

​
Verfügbare Variablen

$(user)

Username des Aufrufers.

$(touser)

Der hinter dem Command genannte User — sonst der Aufrufer.

$(random)

Eine Zufallszahl, optional mit Bereich.

$(pick)

Wählt zufällig einen Wert aus einer Liste.

$(repeat)

Wiederholt einen Text N-mal.

$(clip)

Erstellt einen Twitch-Clip und fügt die URL ein.

​
Variablen kombinieren

Variablen lassen sich frei mischen — du kannst so viele in einer Antwort verwenden wie du möchtest.

​
Was passiert bei Fehlern?

Wenn eine Variable falsch geschrieben ist, bricht der Command nicht ab — der fehlerhafte Teil wird einfach durch nichts (leeren Text) ersetzt. Der Rest der Antwort bleibt erhalten.
Es erscheint niemals ein nacktes $(...) im Chat. Wenn du also siehst, dass eine Stelle in der Bot-Antwort leer ist, weißt du sofort: dort ist eine Variable, die nicht aufgelöst werden konnte — und du kannst den Command anpassen.

​
Einschränkungen

  • Keine Verschachtelung möglich. Konstrukte wie $(pick $(user)|hans) oder $($(user)) funktionieren nicht und können zu unerwarteten Ausgaben führen (z.B. nur eine schließende Klammer im Chat). Schreibe Variablen immer nacheinander, nie ineinander verschachtelt.
  • Keine Quotes nötig. Anführungszeichen werden nicht unterstützt — sie sind aber auch nicht nötig, da Trennzeichen (|, ,) klar definiert sind.
  • Maximale Nachrichtenlänge: 500 Zeichen. Twitch limitiert Chat-Nachrichten auf 500 Zeichen. Längere Outputs werden automatisch gekürzt.