Commands, Timer und Variablen

Eigene Commands

Ein Command ist ein Wort mit Ausrufezeichen, auf das der Bot antwortet — etwa !discord mit deinem Server-Link. Je Command legst du Antwort, Aliase, einen Cooldown für alle und einen je Person fest, dazu die Mindestrolle und ob er nur auf Twitch, nur auf Discord oder auf allen Plattformen gilt — dazu zählt auch ein verbundener Kick-Kanal. Die Cooldowns laufen je Plattform getrennt.

Aliase sind zusätzliche Namen für denselben Command, etwa als Abkürzung. Das geht auch bei eingebauten Commands: Unter Commands bei !lastmatch auf Bearbeiten und lm als Alias eintragen — dann macht !lm genau dasselbe, mit denselben Cooldowns. Im Chat geht es per !cmd alias lastmatch lm, zurück mit !cmd unalias lm. Je Command sind bis zu 5 Aliase möglich; ein Alias darf nicht so heißen wie ein anderer Command oder dessen Alias.

Eigene Commands kannst du unter Bearbeiten umbenennen. Der alte Name bleibt dabei automatisch als Alias erhalten, damit Zuschauer ihn weiter benutzen können — dafür braucht es einen freien Alias-Platz. Willst du den alten Namen loswerden, entferne ihn danach aus den Aliasen. Eingebaute Commands behalten ihren Namen.

Gelöscht ist nicht gleich weg: Nach dem Löschen eines Commands, Timers oder Sounds zeigt das Dashboard ein paar Sekunden lang Rückgängig. Damit ist der Eintrag mit allen Einstellungen wieder da, nur der Nutzungszähler eines Commands beginnt neu.

In der Antwort stehen Platzhalter wie {user}, {touser}, {uptime}, {game} oder {random.1-100} zur Verfügung — die vollständige Liste zeigt das Formular beim Anlegen.

Mit einem Punkt dahinter liefern manche Platzhalter mehr: {channel.subs} und {channel.viewers} zeigen Abos und Zuschauer, {channel.lastfollower} den letzten Follower. {touser.points}, {touser.watchtime} oder {touser.accountage} beziehen sich auf den genannten Namen, ohne Namen auf die Person, die den Command schreibt — {user.points} meint immer sie selbst. Dazu kommen {rank.peak} und {rank.today} für Valorant ({rank:Name} für einen weiteren Account), {song.url} für Spotify und {wow.ilvl} für deinen WoW-Charakter.

Für Abos und Sub-Punkte braucht der Bot die Twitch-Berechtigung Sub-Events; fehlt sie, steht ein Hinweis statt der Zahl in der Antwort.

Beginnt eine Antwort mit einem Twitch-Befehl, führt der Bot ihn aus, statt ihn in den Chat zu schreiben — wie bei StreamElements. Möglich sind /announce (auch /announceblue, /announcegreen, /announceorange, /announcepurple), /me, /timeout, /untimeout, /ban, /unban, /warn, /shoutout, /clear sowie /slow, /followers, /subscribers, /emoteonly und /uniquechat mit ihren …off-Gegenstücken. Beispiel: !v mit der Antwort /timeout {user} 1 blendet die eigenen Nachrichten aus. Dafür muss der Bot im Kanal Moderator sein; lehnt Twitch ab, bleibt der Chat still — eine Ansage kommt dann als normale Nachricht. Gilt der Befehl auch auf Discord, wird eine Ansage dort normaler Text, Moderationsbefehle entfallen.

Antworten aus StreamElements kannst du 1:1 übernehmen: ${user} funktioniert wie {user}, ${1} wie {arg1}. Zähler anderer Bots wie ${count nt}, $(count nt) oder $(count::nt) zählen wie {count:nt}, ${getcount nt} zeigt nur den Stand. Den alten Zählerstand holst du mit !var nt 2206 herüber.

{customapi:Adresse} ruft eine Web-Adresse auf und schreibt ihre Antwort in den Chat — etwa {customapi:https://decapi.me/twitch/followcount/{channel}}. Platzhalter in der Adresse werden vorher eingesetzt. Aus anderen Bots übernimmst du das unverändert: ${customapi.…} (StreamElements), $(customapi …) (Fossabot) und $(urlfetch …) (Nightbot). Die Adresse muss im Internet erreichbar sein; nach 5 Sekunden ohne Antwort oder bei einer Webseite statt Text steht ein Hinweis im Chat. Lange Antworten werden auf eine Chatzeile gekürzt.

Auf Discord pingt eine Antwort höchstens einzelne Personen, nie eine Rolle oder @everyone — auch dann nicht, wenn jemand !hug @everyone schreibt.

Im geteilten Chat (Stream Together) antwortet der Bot nur deinen eigenen Zuschauern: Gäste aus dem Partnerkanal lösen bei dir keine Commands aus und sammeln keine Punkte. Deine Moderationsregeln gelten trotzdem für alles, was in deinem Chat steht.

Dein Kanalbereich und die Command-Seite

Jeder Kanal hat eine öffentliche Seite unter dashboard.fettyhelper.de/kanal/<dein-kanal> — ohne Anmeldung, im Look von fettyhelper.de. Links stehen dein Profilbild und eine Leiste mit allem, was dein Kanal teilt: Stream (dein Twitch-Player, lädt erst nach einem Klick), Commands, Rangliste (wenn freigegeben), Songwünsche (solange Wünsche an sind) und die Chat-Statistik.

Die Chat-Statistik zählt Nachrichten im Twitch-Chat, die beliebtesten Emotes von Twitch, 7TV, BTTV und FFZ und die meistgenutzten Commands. Die Listen mit Namen — Top-Chatter nach Nachrichten und nach Chat-Zeit — erscheinen nur, wenn du die Rangliste freigegeben hast. Gezählt wird seit dem 5. Oktober 2026, aktualisiert etwa jede Minute. Den Link zum Weitergeben findest du im Dashboard unter Statistik.

Unter Commands stehen alle aktiven Twitch-Commands mit Antwort und Mindestrolle, eingebaute mit Erklärung — zum Filtern nach Zuschauer-, Mod- und eigenen Commands und mit Suche. !commands schickt den Link im Chat automatisch mit. Deaktivierte und reine Discord-Commands erscheinen dort nicht.

Timer

Ein Timer schreibt eine Nachricht in festen Abständen — aber nur, wenn seitdem genug im Chat passiert ist. So wiederholt sich der Bot nicht in einen leeren Chat hinein. Ein Timer kann mehrere Nachrichten reihum senden und auf Wunsch nur, solange du live bist.

Sind mehrere Timer gleichzeitig fällig, etwa direkt nach dem Streamstart, sendet der Bot sie nacheinander statt als Block: höchstens einen alle 30 Sekunden, den am längsten wartenden zuerst, und jeden erst, wenn wieder genug im Chat geschrieben wurde. Chat von vor dem Stream zählt dabei nicht mit.

Beginnt eine Timer-Nachricht mit /announce, erscheint sie als farbig hervorgehobene Twitch-Ansage — dafür muss der Bot Moderator sein, sonst kommt sie als normale Nachricht.

Ist ein Discord-Server verbunden, kann ein Timer statt im Twitch-Chat auch auf Discord posten: Unter Wo posten Nur Discord wählen und den Kanal aussuchen. „Mindestens X Chatzeilen“ zählt dann die Nachrichten in diesem Discord-Kanal, „nur live“ richtet sich weiter nach deinem Twitch-Stream. Ein Timer läuft entweder auf Twitch oder auf Discord — für beide legst du zwei Timer an. Der Bot braucht im Kanal das Recht Nachrichten senden.

Variablen und Zähler

Eine Variable ist ein Platzhalter wie {discord} oder {socials}, den du an einer Stelle pflegst und in beliebig vielen Commands und Timern verwendest. Änderst du den Wert, ändern sich alle Antworten mit.

Zähler brauchen keine Vorarbeit: Ein Command mit der Antwort Schon {count:tode} Tode heute zählt bei jedem Aufruf eins hoch und legt {tode} beim ersten Mal selbst an. Mods korrigieren im Chat mit !var tode 0 oder !var tode +1. Soll nur ein Mod zählen (z.B. !ace), stellst du den Command auf Moderator.

Auf der Seite Variablen zählst du einen Zähler mit + und − direkt am Wert. Unter Bearbeiten → Automatisch hochzählen steigt er von selbst bei neuen Followern, Subs, Resubs, verschenkten Subs (je Abo), Cheers, Bits (Anzahl Bits) oder Raids; Zurücksetzen auf 0 setzt ihn jeden Tag zur gewählten Uhrzeit zurück — ideal für „Follower heute“.

Im Stream zeigt der Baustein Zähler im Screen-Studio jede Variable an, mit Titel, optionalem Ziel und „+1“-Animation. Jede Änderung — per Command, !var, Dashboard oder Automatik — ist sofort im Overlay.

Shoutouts, Raids und Werbepausen

  • !so @name postet deine Shoutout-Nachricht und löst — mit der passenden Berechtigung — zusätzlich den offiziellen Twitch-Shoutout aus.
  • Wirst du geraidet, bedankt sich der Bot im Chat und gibt dem Raider einen Shoutout. Twitch erlaubt den offiziellen Shoutout nur alle 2 Minuten, die Chat-Nachricht kommt trotzdem immer.
  • Startet eine Werbepause, sagt der Bot sie im Chat an — damit niemand glaubt, der Stream sei weg.
  • Auf Wunsch warnt der Bot schon 1, 2, 3 oder 5 Minuten vorher, mit eigenem Text und den Platzhaltern {countdown} und {duration}. Das klappt nur bei Pausen, die Twitchs Werbeplaner einplant; eine Pause, die du von Hand startest, kennt vorher niemand. Verschiebst du sie, warnt der Bot zum neuen Termin noch einmal.

Zitate

Fällt im Stream ein Satz, den niemand vergessen soll, speichert ein Mod ihn mit !quote add <Text> - <Person> — die Person ist optional, dazu merkt sich der Bot Kategorie und Datum. Zuschauer holen Zitate mit !quote (zufällig), !quote 12 (genau dieses) oder !quote <Wort> (ein passendes) zurück; !zitat geht genauso.

Unter Zitate im Dashboard stehen alle Zitate zum Bearbeiten, Löschen und neu Anlegen. !quote del 12 löscht im Chat. Eine gelöschte Nummer wird nicht neu vergeben, damit !quote 12 nie plötzlich ein anderes Zitat zeigt.

Commands im Kick-Chat

Streamst du parallel auf Kick, beantwortet der Bot deine eigenen Commands auch dort. Die Kick-Anbindung wird gerade freigeschaltet — sobald sie unter Integrationen als verfügbar erscheint, verbindest du unter Integrationen → Kick mit Mit Kick verbinden dein Kick-Konto und bestätigst bei Kick, dass fettyhelper deinen Chat lesen und darin schreiben darf.

Danach gelten im Kick-Chat alle eigenen Commands mit Plattform Alle Plattformen — mit Mindestrolle, Aliasen, Cooldowns, Variablen, {count} und {customapi:…}. Commands mit Nur Twitch oder Nur Discord bleiben dort, wo sie sind. Mindestrollen erkennt der Bot an Kicks Abzeichen: Moderator, VIP und Abonnent; du selbst giltst als Broadcaster. Die Antwort kommt vom Bot-Konto von fettyhelper als Antwort auf die Nachricht.

Noch nicht auf Kick: eingebaute Commands wie !sr, !points oder !uptime, Timer und Moderationsregeln. Platzhalter, die Twitch- oder Spiel-Daten brauchen ({followers}, {uptime}, {channel.subs}, {user.points}, {song}, {rank} …), zeigen auf Kick nur einen Hinweis „nicht verfügbar“ — nutze für Kick am besten Commands mit festem Text und eigenen Variablen. Beginnt eine Antwort mit /announce oder /me, steht sie auf Kick als normaler Text; Twitch-Moderationsbefehle wie /timeout entfallen dort.

Unter Integrationen → Kick siehst du, mit welchem Kick-Kanal du verbunden bist, und trennst ihn wieder. Beim Trennen meldet fettyhelper das Chat-Abo bei Kick ab und widerruft den Zugang.

KI-Antworten mit !ask

Mit !ask <Frage> beantwortet Claude Fragen von Zuschauern in einer Chatzeile. Die KI kennt Titel und Kategorie deines Streams und — wenn du es eingeschaltet lässt — deine eigenen Commands: „wann streamst du?“ beantwortet sie mit dem Inhalt von !zeiten und nennt den Command. Unter Integrationen → KI-Antworten aktivierst du sie.

Dafür brauchst du einen eigenen API-Schlüssel von Anthropic (console.anthropic.com) mit Guthaben; die Kosten je Frage rechnet Anthropic mit dir ab. Du wählst das Modell — Opus antwortet am besten, Haiku am günstigsten — und kannst Hinweise zu Ton und Inhalt mitgeben. Standardmäßig darf jede Person einmal pro Minute fragen; das stellst du wie bei jedem Command unter Commands ein.

Für die Antwort gehen die Frage, der Anzeigename der fragenden Person, Titel, Kategorie, deine Hinweise und gegebenenfalls deine Commands an Anthropic in den USA.