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 dynamische Werte — z.B. den Namen des Users, eine Zufallszahl oder einen zufällig ausgewählten Wert aus einer Liste. So bekommst du aus einem statischen Command einen, der bei jedem Aufruf etwas anderes ausgibt. Beispiel| Antwort-Text im Command | Output im Chat |
|---|---|
Hallo, schön dass du da bist! | Hallo, schön dass du da bist! |
Hallo $(user), schön dass du da bist! | Hallo WhyScarface, schön dass du da bist! |
Syntax-Grundregeln
Variablen haben immer die Form$(name) — ein Dollarzeichen, eine öffnende Klammer, der Name der Variable (mit optionalen Argumenten) 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 einen leeren String ersetzt (siehe Fehlerverhalten).
Verfügbare Variablen
$(user)
Username des Aufrufers.
$(touser)
Der im Command übergebene User — Fallback auf den Aufrufer.
$(random)
Eine Zufallszahl, optional mit Range.
$(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.| Antwort-Text | Output (Beispiel) |
|---|---|
$(user) würfelt $(random 1-100) und wählt $(pick Pizza|Sushi) | WhyScarface würfelt 73 und wählt Sushi |
GG $(repeat 5 !) $(user) WP | GG ! ! ! ! ! WhyScarface WP |
$(user), $(pick Glück|Pech)! Du bekommst $(random -10-10) Punkte. | WhyScarface, Glück! Du bekommst 7 Punkte. |
$(touser), du bekommst $(random 1-100) Punkte! | @streame_gg, du bekommst 73 Punkte! |
$(user) hat einen Clip gemacht: $(clip) | WhyScarface hat einen Clip gemacht: https://clips.twitch.tv/AbcDef123 |
Was passiert bei Fehlern?
Wenn eine Variable falsch geschrieben ist, bricht der Command nicht ab — der fehlerhafte Teil wird einfach durch einen leeren String ersetzt. Der Rest der Antwort bleibt erhalten.| Eingabe | Output im Chat |
|---|---|
Test $(randdom) (Tippfehler) | Test |
Test $(random ohne klammer | Test |
Test $(pick) (ohne Auswahl) | Test |
Test $$(user) | Test $WhyScarface |
Test $($(user)) (Verschachtelung) | Test ) |
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.