Streambuddy-ai — Handbuch
Konfigurierbarer Twitch-Chat-Bot mit OpenAI-Anbindung, eigenen Commands, Timern, Persona-System und einem optionalen Dashboard für Moderation, Alerts, Loyalty und Minispiele.
Übersicht
Was der Bot mitbringt, in einem Blick.
KI-Chat
Antwortet selbstständig, immer wenn direkt angesprochen (@bot, Name am Satzanfang) und optional spontan mit einstellbarer Wahrscheinlichkeit.
Eigene Commands
Statisch oder KI-generiert, direkt im Dashboard angelegt — Aliase, Cooldowns, Kanal-Beschränkungen inklusive.
Gedächtnis
Merkt sich dauerhaft Fakten pro User — manuell (!remember) und automatisch aus dem Chatverlauf.
Sofort wirksam
Änderungen im Dashboard erreichen den Bot innerhalb weniger Sekunden — kein Neustart nötig.
Dashboard
Webdienst mit Login: Commands, Timer, Alerts, Loyalty, Minispiele, Moderation — pro Kanal.
Alerts & Overlays
Stream-Einblendungen für OBS bei Sub, Bits, Raid, Spende und mehr — Optik und Texte frei einstellbar.
NeuigkeitenNEU
Alles, was neu ist — im Menü links mit NEW markiert.
| Neu | Wo |
|---|---|
| Starter-Vorlage für die Blacklist — ein Klick übernimmt ~40 fertige Regeln gegen Spam, Scam, Hassrede, Rassismus und NS-Parolen | Moderation |
Witz-Link für eigene Commands — öffentlicher Witz-Abruf, auch für Nightbot & Co. per $(urlfetch …) | Chat-Befehle |
| Registrierung mit E-Mail & „Passwort vergessen“ — Adresse bestätigen, Passwort per Mail-Link zurücksetzen | Konto & Sicherheit |
| Desktop-Client für die Sprachsteuerung — Push-to-Talk mitten im Spiel, eigene Tasten und Mikrofon wählbar; ohne Download geht auch das Handy als Sprechtaste | Sprache |
| Sprachsteuerung — Taste halten, sprechen: der Bot antwortet oder führt deine Anweisung als Chat-Befehl aus | Sprache |
| AutoMod-Warteschlange — von Twitch zurückgehaltene Nachrichten direkt freigeben oder ablehnen | Stream |
| Subathon-Timer — verlängert sich durch Subs, Bits, Gifts, Follows und Raids; im Overlay | Tools |
| Ziele — Fortschrittsbalken im Overlay für Subs, Follower, Bits oder manuell | Tools |
| Overlay-Zuweisung & Optik für Subathon und Ziele — eigene Browserquelle, Rahmen, Schrift, Farben | Tools |
Zitate — !quote, !addquote, !delquote | Tools, Chat-Befehle |
Variablen in Commands — $(uptime), $(followage), $(title), $(game), $(time), $(urlfetch …) | Commands & Timer |
Umfragen & Vorhersagen per Chat — !poll, !predict | Mods & Admins |
Raid-Mode — !bot raidmode schaltet Follower-only + Slow-Mode und stellt danach alles zurück | Mods & Admins |
!permit — einem User kurz Links erlauben | Mods & Admins |
Witze — „Erzähl einen Witz" liefert echte deutsche Witze (auch Chuck Norris, Lehrer-, Flach-, Programmierwitze …); mit !witzeinreichen reichst du eigene ein | Chat-Befehle |
Übersetzung — !translate | Chat-Befehle |
| Chat-Starter — der Bot belebt einen stillen Chat von selbst mit Dad-Joke, Fun-Fact oder Frage | Chat-Verhalten |
| Kostenbremse — Tages-Limit für KI-Tokens je Kanal | Chat-Verhalten |
| Einrichtungs-Check — zeigt, was bei deinem Kanal noch fehlt, inkl. „Test-Nachricht senden" | Twitch verbinden |
| 2FA, Twitch-Anmeldung, Datenexport | Konto & Sicherheit |
Deine Rolle im DashboardSTREAMER
Das Dashboard ist der zweite, optionale Dienst des Bots — Login unter deiner Adresse, kanal-beschränkt auf das, was dir zugewiesen wurde.
Als Streamer siehst du ausschließlich den Tab Meine Kanäle mit seinen Unter-Reitern, jeweils nur für die dir zugewiesenen Kanäle — kein Zugriff auf Übersicht, OpenAI-Grundeinstellungen, User-Suche oder Benutzerverwaltung. Ein Admin weist dir Kanäle über Benutzer → Kanäle zu.
| Rolle | Sichtbar |
|---|---|
| ADMIN | alles, für alle Kanäle |
| STREAMER | alle Reiter unter „Meine Kanäle" — nur eigene Kanäle |
| MOD | nur Commands & Timer, Giveaways, Medien, Minispiele — nur eigene Kanäle |
reporter.interval_seconds, üblich 45 s). Ein gleichnamiger Eintrag aus der config.yaml hat immer Vorrang vor einem Dashboard-Eintrag.Bedienung
| Element | Was es tut |
|---|---|
| Kopfleiste | bleibt beim Scrollen immer oben sichtbar: Kanalauswahl, Sync-Anzeige, Kanalrestart, Kosten-Status, 🎫 Support (öffnet die Support-Seite mit deinen Tickets) und Abmelden. Die Kanalauswahl steht dort auch dann, wenn du nur einen Kanal hast. Den Support-Link gibt es auch auf der Anmeldeseite, falls du nicht reinkommst. |
| Sync-Anzeige | Sync vor 12s = wann der Bot sich zuletzt die Einstellungen abgeholt hat. Nach dem Speichern steht dort ⏳ Änderung wartet auf Sync, sobald der Bot sie abgeholt hat, grün ✓ übernommen — ab dann ist die Änderung sicher aktiv. Orange heißt: seit über 2 Minuten kein Sync, der Bot ist vermutlich offline. |
| Speicher-Hinweise | auch direkt unter dem Speichern-Button (z. B. Minispiele, Loyalty) wechselt „wartet auf Bot-Sync" automatisch auf ✓ Vom Bot übernommen. |
| Speichern-Leiste | auf langen Seiten (Chat-Verhalten, Persona & Begrüßung, Moderation, Loyalty, Minispiele) klebt der Speichern-Button am unteren Rand — kein Runterscrollen mehr. Auf Seiten mit mehreren Blöcken heißt er Alle Änderungen speichern, zeigt z. B. „2 Blöcke geändert" und speichert genau die geänderten Blöcke. |
| Ungespeicherte Änderungen | wechselst du den Kanal, meldest dich ab oder schließt/lädst die Seite neu, fragt das Dashboard vorher nach — aber nur, wenn wirklich etwas ungespeichert ist. Zwischen den Reitern kannst du frei wechseln, Eingaben bleiben erhalten. |
| Direkt-Links | jeder Reiter hat eine eigene Adresse, z. B. …/#mychannels/games für Minispiele oder …/#mychannels/loyalty — als Lesezeichen speicherbar, führt nach dem Login direkt dorthin. Der Zurück-Button des Browsers springt zum vorherigen Reiter. |
| ↑ Nach oben | runder Button unten rechts, erscheint nach etwas Scrollen und bringt dich zurück an den Seitenanfang. |
Konto & SicherheitNEUSTREAMERMOD
Oben in der Kopfleiste: 🔒 Sicherheit — alles rund um dein eigenes Konto.
| Funktion | Bedeutung |
|---|---|
| Zwei-Faktor-Anmeldung (2FA) | zusätzlicher Code aus einer Authenticator-App bei jeder Anmeldung. QR-Code scannen (oder den Schlüssel eintippen), einen Code zur Bestätigung eingeben, danach die Recovery-Codes sichern — sie werden nur einmal angezeigt und ersetzen bei Geräteverlust den App-Code (je einmal nutzbar). Abschalten geht nur mit deinem Passwort. |
| Passwort ändern | mindestens 10 Zeichen, nicht zu einfach. Danach werden alle anderen Sitzungen beendet. |
| Überall abmelden | beendet alle Sitzungen, auch auf anderen Geräten. |
| Twitch-Anmeldung | Konto mit deinem Twitch-Account verknüpfen — danach meldest du dich mit Mit Twitch anmelden ohne Passwort an. Es werden keine Twitch-Rechte angefragt, nur deine Identität. Wer noch kein Konto hat, kann sich auch direkt mit Twitch registrieren; ein Admin gibt das Konto danach frei und weist Kanäle zu. |
| Registrieren & E-Mail bestätigen NEU | beim Anlegen eines Kontos gibst du Mailadresse und deinen Twitch-Namen an (der Name hilft dem Admin bei der Freigabe). Per Mail kommt ein Bestätigungslink, der 24 Stunden gilt; erst bestätigte Konten tauchen beim Admin zur Freigabe auf. Ein Captcha schützt die Registrierung vor Bots. |
| Passwort vergessen NEU | auf der Anmeldeseite Passwort vergessen wählen, Mailadresse eingeben (wieder mit Captcha) — du bekommst einen Link zum Zurücksetzen. Er gilt 1 Stunde, funktioniert nur einmal und beendet alle bestehenden Sitzungen. |
| Benachrichtigungen | optionale Mail bei Störungen (Bot meldet sich nicht mehr, Twitch-Verbindung abgelehnt). Standardmäßig aus; an eine bestätigte Adresse, höchstens alle 12 Stunden je Kanal. |
| Meine Daten | Daten exportieren lädt alles, was zu deinem Konto gespeichert ist, als Datei. Konto löschen entfernt dein Konto endgültig (Passwort + Benutzername zur Bestätigung); Support-Tickets bleiben anonymisiert erhalten, Kanal-Einstellungen gehören dem Kanal. |
Support
Probleme oder Fragen? Eröffne ein Ticket direkt im Dashboard – wir antworten dort oder im Discord, du siehst jede Antwort an beiden Stellen.
- Support öffnen Button 🎫 Support in der Kopfleiste oder Support in der Seitenleiste.
- „+ Neues Ticket" Betreff, optional den betroffenen Kanal und eine möglichst genaue Beschreibung eintragen, dann Ticket senden.
- Dateien anhängen (optional) 📎 Datei anhängen oder einen Screenshot einfach mit Strg+V ins Textfeld einfügen – bis zu 5 Dateien pro Nachricht, je max. 25 MB (Screenshots, Logs, Videos …). Bilder siehst du direkt als Vorschau, andere Dateien als Download.
- Antworten lesen & schreiben Neue Antworten zeigt ein roter Zähler an Support. Im Ticket siehst du den ganzen Verlauf und kannst direkt antworten (Strg+Enter sendet).
- Schließen Ist alles geklärt, Ticket schließen – im Dashboard oder im Discord-Thread über den Button 🔒 Ticket schließen. Eine neue Antwort im Dashboard öffnet ein geschlossenes Ticket wieder.
Discord-Konto verknüpfen
Verknüpfst du dein Discord-Konto, siehst du jedes deiner Tickets zusätzlich im Discord als privaten Thread und kannst dort antworten – egal, ob du das Ticket im Dashboard oder im Discord eröffnet hast. Nötig ist das nicht: Ohne Verknüpfung läuft alles hier im Dashboard.
- Support öffnen Oben in der Karte steht Mit Discord verknüpfen.
- Bei Discord anmelden & autorisieren Discord fragt, ob der Bot deinen Benutzernamen sehen und dich unserem Server hinzufügen darf. Mehr wird nicht freigegeben – keine Nachrichten, keine E-Mail-Adresse, keine Liste deiner Server.
- Zurück im Dashboard Die Karte zeigt jetzt Discord verknüpft: dein Name. Warst du noch nicht auf unserem Discord-Server, bist du jetzt automatisch Mitglied.
- Tickets im Discord finden
Nach spätestens ~15 Sekunden fügt dich der Bot allen deinen offenen Tickets hinzu. Du findest sie im Kanal
#support-ticketsunter Threads – jeder Thread heißt#Nummer Betreff.
| Frage | Antwort |
|---|---|
| Mehrere Dashboard-Konten, ein Discord-Konto? | Ein Discord-Konto gehört immer genau einem Dashboard-Konto. Verknüpfst du es mit einem anderen Dashboard-Konto, wandert die Verknüpfung dorthin. |
| Was passiert beim Trennen? | Tickets, die du im Dashboard eröffnest, erscheinen nicht mehr in deinem Discord. Bereits geöffnete Threads bleiben für dich sichtbar – antworte in diesen Tickets dann aber im Dashboard, sonst wird deine Discord-Antwort dort nicht dir zugeordnet. Tickets, die du selbst im Discord eröffnet hast, bleiben dort ganz normal deine. |
| Ticket im Discord eröffnet, aber noch nicht verknüpft? | Kein Problem: Sobald du verknüpfst, erscheint das Ticket automatisch auch hier im Dashboard. |
| „Anmeldelink abgelaufen oder ungültig" | Der Link gilt 10 Minuten. Einfach erneut auf Mit Discord verknüpfen klicken. |
Ticket direkt im Discord eröffnen
- Kanal
#ticket-erstellenöffnen Dort steht eine Nachricht mit dem Button 🎫 Ticket erstellen. - Button klicken, Formular ausfüllen Betreff und eine möglichst genaue Beschreibung eintragen, dann absenden.
- Bestätigung Discord zeigt dir (nur dir) „Ticket #… ist eröffnet".
- Privaten Thread öffnen
Wenige Sekunden später bist du in deinem Ticket-Thread in
#support-tickets. Dort schreibst du mit dem Support-Team und hängst Screenshots an.
Im Discord-Thread
| Was | So geht's |
|---|---|
| Antworten | Ganz normal im Thread schreiben – die Nachricht erscheint nach spätestens ~15 Sekunden auch im Dashboard. |
| Dateien & Screenshots | In den Thread ziehen oder mit Strg+V einfügen. Sie erscheinen auch im Dashboard (bis 25 MB je Datei). Große Dateien aus dem Dashboard kommen im Thread als Download-Link an, weil Discord größere Uploads nicht annimmt. |
| Nachrichten aus dem Dashboard | erscheinen im Thread mit dem Absender Name (Dashboard) bzw. Name (Support). |
| Schließen | Button 🔒 Ticket schließen in der ersten Nachricht des Threads – den dürfen du als Ersteller und das Support-Team benutzen. Der Thread wird archiviert und gesperrt. |
| Wieder öffnen | Im Dashboard eine neue Antwort ins geschlossene Ticket schreiben – der Thread öffnet sich wieder. |
| Geschlossene Tickets finden | Sie verschwinden aus der Thread-Liste von #support-tickets. Nachlesen: Threads → Archiviert oder hier im Dashboard unter Support. |
#support-tickets nur ihre eigenen Tickets, und schreiben kann dort niemand außerhalb der Threads.Twitch verbindenSTREAMER
Einmalige Twitch-Freigabe deines Broadcaster-Accounts — damit der Bot Follows, Werbepausen und mehr mitbekommt und für dich ausführen darf.
- Reiter öffnen Meine Kanäle → Twitch verbinden, oben den richtigen Kanal wählen.
- Mit Twitch verbinden Du meldest dich bei Twitch an und bestätigst die angezeigten Rechte. Das Passwort sieht nur Twitch.
- Fertig Der Reiter zeigt „verbunden". Fehlt später ein Recht („Rechte unvollständig – neu verbinden"), einfach noch einmal verbinden.
| Recht | Wofür |
|---|---|
| Follower & Werbung lesen | Follow- und Werbepausen-Alerts (Pflicht) |
| Werbung starten | !werbung und der automatische Werbeplaner |
| Clips erstellen | !clip |
| Chatter lesen | Loyalty zählt alle Anwesenden, nicht nur die Schreibenden |
| Kanalpunkte verwalten | Rewards und Einlösungen (Kanalpunkte-Reiter) |
| Titel/Kategorie ändern, Raids starten | Stream-Reiter und !bot title|game|raid |
Chat-Bot (channel:bot) | Bot-Badge im Chat — nur nötig, wenn der Bot bei dir kein Mod ist |
| Chat-Einstellungen NEU | Raid-Mode: Follower-only und Slow-Mode per !bot raidmode |
| Umfragen verwalten NEU | !poll |
| Vorhersagen verwalten NEU | !predict |
| AutoMod verwalten NEU | AutoMod-Warteschlange im Stream-Reiter |
Einrichtungs-Check NEU
Fehlt bei deinem Kanal noch etwas, erscheint oben in Meine Kanäle ein gelber Kasten „Einrichtung #kanal" — nur mit den offenen Punkten, sonst bleibt er weg:
- Bot-Instanz meldet sich — der Bot ist dem Kanal zugeordnet und aktiv.
- Twitch-Kanal verbunden und Berechtigungen vollständig — sonst fehlen Follow-Alerts, Kanalpunkte, Titel/Kategorie, Raid-Mode, Umfragen und AutoMod.
- Bot ist Moderator im Kanal — der Bot merkt sich das, sobald er einmal etwas im Kanal gesagt hat. Mit Test-Nachricht senden prüfst du es sofort.
- Mailadresse bestätigt — nur wenn der Server Mails versendet.
StreamSTREAMER
Player, Chat und Stream-Steuerung auf einen Blick — ohne Twitch selbst zu öffnen.
- Player + Chat-Embed deines Kanals direkt im Dashboard (stummgeschalteter Player, echter Chat daneben).
- Titel & Kategorie ändern — die Kategorie mit Autocomplete gegen die echten Twitch-Kategorien, damit die Schreibweise stimmt und der Speichervorgang nicht an einem Tippfehler scheitert.
- Activity Board — die letzten Follows, Raids, Subs, Cheers und Spenden als Liste, direkt aus den gespeicherten Alert-Ereignissen.
channel:manage:broadcast). Ohne gültige Freigabe bleibt das Formular ausgegraut und zeigt „Nicht verbunden" bzw. „Freigabe fehlt".AutoMod-Warteschlange NEU
Unten im Stream-Reiter erscheinen Nachrichten, die Twitchs AutoMod zurückhält — mit Absender, Text und Grund. Pro Nachricht ✔ Freigeben oder ✖ Ablehnen; die Liste aktualisiert sich alle paar Sekunden, solange der Reiter offen ist. So kann ein Mod, der hier zuschaut, sofort entscheiden.
Dieselbe Steuerung gibt es auch direkt im Chat: !bot title <text>, !bot game <kategorie> und !bot raid <kanal> — siehe Chat-Befehle für Mods & Admins.
Commands & TimerSTREAMERMOD
Für deine zugewiesenen Kanäle legst du eigene Chat-Commands und Timer direkt im Browser an.
Command-Felder
| Feld | Bedeutung | Beispiel |
|---|---|---|
Name | Command-Wort ohne Präfix | discord → im Chat !discord |
Typ | static feste Antwort, ai KI-generierte Antwort | static |
Antwort (bei static) | fester Text; Platzhalter $user $args $channel $random.chatter | Unser Discord: https://discord.gg/beispiel |
Prompt (bei ai) | Anweisung an das Modell, wird mit der Persona kombiniert | Beantworte kurz und witzig: $args |
Aliase | weitere Namen, die denselben Command auslösen | disco, dc |
Cooldown (Sek.) | Sperrzeit, standardmäßig pro Kanal gezählt | 30 |
Pro User | Häkchen: Cooldown gilt je User statt je Kanal | an |
Nur Mods | nur Moderatoren + Broadcaster dürfen den Command nutzen | an |
Nur Admin | nur Broadcaster + Bot-Admins | aus |
Erlaubte User | Positivliste bestimmter Logins, unabhängig vom Mod-Status — z. B. für einen Editor | meineditorin |
Aktiv | Häkchen zum vorübergehenden Deaktivieren, ohne zu löschen | an |
Antwort per Whisper (PN) | Antwort geht privat per Twitch-Whisper an den Auslöser statt sichtbar in den Kanal; dabei kein Abschneiden auf die Zeichen-Obergrenze, stattdessen ggf. auf mehrere Whispers aufgeteilt | an |
Overlay-Einblendung | zusätzlich Bild/GIF/Video + Sound über eine Browserquelle abspielen (Dauer, Position, Animation, Bildgröße %, Ziel-Quelle); optionaler Text mit {user} und {br} für Zeilenumbruch | Bild hype.gif, 4 s, Mitte, 60 % |
Sichtbar und bearbeitbar sind alle Commands des Kanals — auch die anderer zugewiesener User; die Spalte „angelegt von" zeigt den Ersteller.
Variablen in Antworten NEU
Zusätzlich zu $user, $args, $channel und $random.chatter kannst du Live-Werte einbauen:
| Variable | Ergebnis | Beispiel |
|---|---|---|
$(uptime) | wie lange der Stream läuft — oder „offline" | Live seit $(uptime) → „Live seit 2 Stunden 13 Minuten" |
$(followage) | wie lange der Auslöser dem Kanal folgt; mit Namen oder $args für jemand anderen | $user folgt seit $(followage) |
$(title) / $(game) | aktueller Stream-Titel / Kategorie | Wir spielen $(game) |
$(time) / $(time Europe/Berlin) | Uhrzeit, optional in einer Zeitzone | Es ist $(time) → „21:30 Uhr" |
$(urlfetch https://…) | Text einer öffentlichen Webadresse (max. 300 Zeichen) | Kurs: $(urlfetch https://example.com/kurs) |
$(followage) braucht die Twitch-Verbindung. $(urlfetch …) erlaubt nur öffentliches https und muss für Dashboard-Commands vom Admin freigeschaltet sein (allow_urlfetch) — setze dabei einen Cooldown.Timer-Felder
| Feld | Bedeutung | Beispiel |
|---|---|---|
Name | eindeutiger Timer-Name | discord-hinweis |
Intervall (Min.) | Mindestabstand zwischen zwei Nachrichten | 30 |
Mind. Chat-Nachrichten | so viele echte Chatnachrichten müssen seit der letzten Timer-Nachricht gefallen sein | 20 |
Text(e) | eine feste Nachricht oder mehrere, die reihum rotieren | Folgt uns auf Discord: discord.gg/beispiel |
Als Ankündigung | Ausgabe über Twitchs offizielle /announce statt normaler Chatnachricht | an, Farbe purple |
Aktiv | Häkchen zum vorübergehenden Deaktivieren | an |
Timer-Anti-Spam
| Feld | Bedeutung | Beispiel |
|---|---|---|
Mindestabstand (Min.) | Mindestabstand zwischen zwei Timer-Nachrichten im Kanal, egal welcher Timer | 3 |
Zufällige Schwankung (%) | streut das Intervall pro Zyklus, damit sich Timer-Takte nicht dauerhaft synchronisieren; 0 = aus | 20 |
Verhindert, dass mehrere gleichzeitig fällige Timer im selben Tick hintereinander posten und den Chat spammen. Ohne eigene Einstellung gilt die zentrale Vorgabe deines Admins aus config.yaml.
Typ: ai) muss dein Admin serverseitig freischalten (allow_ai_commands) — bewusst restriktiver Default, größere Angriffsfläche.Schritt für Schritt: eigenen Command anlegen
- Meine Kanäle → Commands & Timer öffnen Kanal oben auswählen, falls du mehrere betreust.
- „Neuer Command"
Namediscord,Typstatic. - Antwort eintragen
Unser Discord: https://discord.gg/beispielins FeldAntwort. - Zugriff einschränken (optional)
Cooldown15Sek. setzen, damit der Command nicht spammbar ist. - Speichern
Der Command erscheint sofort in der Liste; im Chat funktioniert
!discordbeim nächsten Bot-Sync (≤ 45 Sek.).
Schritt für Schritt: wiederkehrenden Timer anlegen
- Reiter Commands & Timer → Abschnitt Timer „Neuer Timer" klicken.
- Grunddaten
Namediscord-hinweis,Intervall30Min.,Mind. Chat-Nachrichten20. - Text festlegen
Folgt uns auf Discord: discord.gg/beispiel— optional mehrere Texte für Rotation hinzufügen. - Ausgabeart wählen
Häkchen „Als Ankündigung" für eine offizielle
/announce-Nachricht mit Farbe, sonst normale Chatnachricht. - Speichern Der Timer postet frühestens nach 30 Minuten — und erst, sobald seitdem 20 echte Chatnachrichten gefallen sind.
Chat-VerhaltenSTREAMER
Einstellungen, die sonst per !bot … im Chat gehen — jetzt per Klick. Jeder Block hat ein „hier verwalten"-Häkchen; ohne Häkchen gilt die zentrale Vorgabe deines Admins. Gespeichert wird über die Leiste Alle Änderungen speichern am unteren Rand.
Spontane Antworten
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | ob der Bot ungefragt mitreden darf | an |
Wahrscheinlichkeit | Chance pro Chatnachricht, von sich aus zu antworten (0–1) | 0.05 = 5 % |
Mindestpause (Sek.) | Abstand zwischen zwei spontanen Antworten | 90 |
Chat-Starter NEU
Ist der Chat still, wirft der Bot von sich aus etwas ein — einen Dad-Joke, einen nutzlosen Fun-Fact oder eine einfache Frage (z. B. „Kaffee oder Tee?"). Das sind ganz normale Chatnachrichten, keine Ankündigungen. Standard: an. Bei Fact und Frage kennt der Bot dein aktuelles Spiel, den Stream-Titel und die letzten Chatzeilen.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Chat-Starter aktiv | Hauptschalter | an |
Chat muss so lange still sein (Min.) | ab dieser Stille meldet sich der Bot | 5 |
Mindestabstand (Min.) | Pause zwischen zwei Startern | 15 |
Max. Starter pro Stream | Obergrenze je Stream | 6 |
Nach … Startern ohne Reaktion schweigen | antwortet niemand, hält der Bot still, bis wieder jemand schreibt | 2 |
Dad-Jokes / Fun-Facts / Fragen | welche Arten erlaubt sind; der Bot wechselt die Art ab | alle an |
Eigene Sprüche | eine Zeile je Spruch — Ersatz, falls KI oder Witz-Dienst ausfallen | Welches Spiel habt ihr zuletzt durchgespielt? |
Fragen zu Commands beantworten
Fragt jemand im Chat z. B. „wie komme ich ins Discord?", antwortet der Bot direkt mit dem Text von !discord — ohne dass jemand den Command tippen muss und ohne KI-Aufruf. Schalter: Fragen zu Commands beantworten im Block „Chat-Verhalten" (Standard: an).
- Die Nachricht muss eine Frage sein (
?oder Fragewort wie „wie", „wo", „gibt"). - Name oder Alias des Commands muss als Wort drin vorkommen, mindestens 4 Zeichen. Tipp: Gib dem Command passende Aliase (z. B.
server), dann greift auch „wo ist euer Server?". - Nur Commands vom Typ „fester Text"; Rechte und Cooldown gelten wie beim Tippen des Commands.
Shoutout
| Feld | Bedeutung | Beispiel |
|---|---|---|
Auto-Shoutout nach Raid | shoutet automatisch, sobald ein Raid ankommt | an |
Mindest-Raider | ab so vielen Raidern greift der Auto-Shoutout | 3 |
!so <username> nutzt dieselbe Vorlage — mit Platzhaltern $display_name, $game (zuletzt gespielt), $url.
Clips
| Feld | Bedeutung | Beispiel |
|---|---|---|
Aktiv | eingebauten Clip-Command freischalten | an |
Command | Chat-Wort ohne Präfix | clip |
Nur Mods | nur Moderatoren/Broadcaster dürfen clippen | an |
Cooldown (Sek.) | Sperrzeit pro Kanal | 60 |
!clip <titel> — der Titel ist optional. Twitch erlaubt beim Erstellen eines Clips keinen eigenen Titel über die API, daher taucht er nur in der Chat-Bestätigung des Bots auf (Clip erstellt: „<titel>" https://clips.twitch.tv/…), nicht am Clip selbst auf Twitch. Ohne Titel bleibt die Bestätigung wie gewohnt.
Rate-Limit & Kostenbremse NEU
| Feld | Bedeutung | Beispiel |
|---|---|---|
KI-Aufrufe pro Minute (gesamt) | harte Obergrenze für den ganzen Kanal | 15 |
KI-Aufrufe pro Minute je User | Obergrenze pro Zuschauer | 3 |
Abklingzeit je User (s) | Mindestabstand zwischen zwei KI-Antworten für denselben User | 8 |
Kostenbremse (Tokens pro Tag) | so viele KI-Tokens darf der Bot in deinem Kanal pro Tag verbrauchen; danach schweigt die KI bis Mitternacht — Commands, Timer und Alerts laufen weiter. Zählt auch die Sprachsteuerung (Spracherkennung + Einordnung) und das Vorlesen im Overlay mit; ist das Limit erreicht, nimmt die Sprachsteuerung keine Aufträge mehr an. 0 = aus | 200000 |
Die Kostenbremse schützt vor Überraschungen bei regem Chat. Der Zähler läuft im Bot; nach einem Bot-Neustart beginnt der Tag wieder bei null.
Ignorierliste
Beliebige Logins (z. B. andere Bots) für den Kanal ausschließen — sie bekommen keine KI-Antworten und keine Begrüßung.
Persona & BegrüßungSTREAMER
Persönlichkeit und Willkommensgruß deines Kanals, unabhängig von der zentralen Vorgabe.
Persona
| Feld | Bedeutung | Beispiel |
|---|---|---|
Name | Name, auf den der Bot zusätzlich hört | Nova |
Beschreibung | Freitext — der Kern der Persönlichkeit | Schlagfertiger Co-Host mit trockenem Humor |
Charakterzüge | einzelne Eigenschaften als Liste | neugierig, leicht sarkastisch |
Sprachstil | Ton, Emotes, Anrede | locker, duzt alle, nutzt gern Emotes |
Regeln | harte Leitplanken, die immer gelten | Maximal 2 Sätze pro Antwort |
Antwortlänge | Zeichenlimit einer Antwort (Twitch-Max. 500) | 220 |
Begrüßung
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | neue Chatter automatisch begrüßen | an |
Modus | first_msg nur beim allerersten Schreiben im Kanal, first_seen jeden User erneut nach einer Pause | first_seen |
Feste Nachricht | Text mit Platzhaltern $user $channel — hat Vorrang vor der KI-Variante | Willkommen im Chat, $user! 👋 |
KI-Begrüßung | alternativ von der Persona generieren lassen, wenn keine feste Nachricht gesetzt ist | Begrüße $user kurz und herzlich |
Cooldown (Sek.) | Mindestabstand zwischen zwei Begrüßungen | 5 |
Raid-Pause (Sek.) | nach einem Raid so lange nicht begrüßen, um Massen-Begrüßung zu vermeiden | 300 |
Wiederholung nach (Std.) | nur bei Modus first_seen: denselben User nach so vielen Stunden erneut begrüßen | 12 |
Jeder Block hat ein eigenes „Für diesen Kanal hier verwalten"-Häkchen — ohne Häkchen gilt die zentrale Vorgabe. Beide Blöcke speicherst du gemeinsam über die Leiste Alle Änderungen speichern am unteren Rand.
AlertsSTREAMER
Stream-Einblendungen für OBS bei Sub, Bits, Raid, Spende, Follow und Werbepausen.
Globale Optik
Vorgabe für alle Varianten; jede Variante kann einzelne Werte überschreiben.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Position | wo die Einblendung im Overlay erscheint | oben / mitte / unten |
Lautstärke | Abspiellautstärke von Sound/Video | 80 % |
Schriftgröße | Textgröße in Pixeln | 32 |
Bildgröße | Skalierung von Bild/GIF/Video in Prozent | 100 % |
Text-/Akzentfarbe | beliebige CSS-Farbe | #a970ff |
Schriftart | websichere Schrift | Poppins |
Text-Verschiebung | Feinjustage in Pixeln, horizontal/vertikal | 0 / 12 |
Vorlesen-Stimme | „Browser" (kostenlos, in OBS meist stumm) oder eine OpenAI-Stimme (zuverlässig in OBS, braucht Admin-Key) | nova |
Je Ereignis-Variante
Pro Ereignistyp (Sub, Bits, Raid, Follow, Spende, Werbung …) eine oder mehrere Varianten. Mehrere Varianten mit Schwelle = Stufen — es greift die höchste passende.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Name | interner Name der Variante | Bits ab 1000 |
Schwelle | ab welchem Wert diese Variante greift (Bits-Anzahl, Raid-Größe …) | 1000 |
Bild/Video | Medium aus dem Medien-Pool oder per URL | confetti.gif |
Sound | abgespielter Sound | tada.mp3 |
Dauer (Sek.) | Anzeigedauer der Einblendung | 6 |
Text-Vorlage | angezeigter Text mit Platzhaltern {user} {amount} {months} {tier} … sowie {br} für einen Zeilenumbruch im Overlay | {user} ist da!{br}Willkommen im Stream 🎉 |
Text im Bild | Text liegt über dem Medium statt darunter | an |
Animation | Ein-/Ausblend-Effekt | Fade |
Vorlesen (TTS) | zusätzlicher Text, der vorgelesen wird | {user} hat gecheert! |
Browserquelle | Ziel-Overlay dieser Variante (Standard oder eine benannte Quelle) | Standard-Overlay |
Chat-Nachricht | zusätzlich zur Einblendung eine Chat-Nachricht posten, optional als offizielle Ankündigung — kein {br}, das würde die Chat-Nachricht zerreißen | Danke {user} für {amount} Bits! |
Aktiv | Variante an-/ausschalten | an |
{br} funktioniert in jeder Overlay-Text-Vorlage (Alerts, Command-/Counter-Einblendungen, Kanalpunkte-Aktionen) — ohne {br} bleibt der Text wie gewohnt einzeilig. In Chat-Nachrichten wird {br} nicht ausgewertet und bleibt als wörtlicher Text stehen.Raid-Alert: Bild + Zufallsclip nacheinander
Bei einer Raid-Variante lässt sich als Medium ein Zufälliger Clip vom Raider wählen — dann ersetzt der Clip das Bild komplett. Neu: das Häkchen „danach zusätzlich Zufallsclip vom Raider zeigen" kombiniert beides. Zuerst läuft die Einblendung ganz normal mit deinem konfigurierten Bild/Video + Sound, direkt im Anschluss folgt automatisch noch ein zweiter Alert mit dem Zufallsclip des Raiders — beide spielen strikt nacheinander, nichts überlappt sich.
| Feld | Bedeutung | Beispiel |
|---|---|---|
danach zusätzlich Zufallsclip zeigen | Häkchen: nach Bild/Sound automatisch noch den Raider-Clip nachschieben | an |
Zeitraum | wie weit zurück nach einem Clip gesucht wird | 30 Tage |
Mindest-Views | Clips mit weniger Aufrufen werden übersprungen | 0 |
Max. Länge | obere Grenze für die Clip-Dauer | 40 Sek. |
Findet sich kein passender Clip (oder der Raid ist anonym), bleibt es beim Bild/Sound — kein zweiter Alert wird angehängt.
Ohne passende Variante wird für ein Ereignis nichts eingeblendet. Der Button „Test" spielt eine Variante sofort auf allen verbundenen Browserquellen ab.
Shoutout-Clip (!so) & Clipfenster-Optik
Beim manuellen !so <user> spielt das Overlay zusätzlich einen zufälligen Clip des genannten Kanals ab, gerahmt mit Namensschild. Bei Raids übernimmt das die Raid-Alert-Variante oben. Braucht einen verbundenen Twitch-Admin-Account (Client-ID/Secret).
| Feld | Bedeutung | Beispiel |
|---|---|---|
aktiv | schaltet den Zufallsclip bei !so ein/aus | an |
Browserquelle | Ziel-Overlay des Shoutout-Clips | Standard-Overlay |
Zeitraum (Tage) | wie weit zurück nach einem Clip gesucht wird | 30 |
min. Views | Clips mit weniger Aufrufen werden übersprungen | 0 |
max. Länge (s) | obere Grenze für die Clip-Dauer | 40 |
Text im Rahmen | Namensschild-Text, Platzhalter {user}; leer = kein Schild | {user} |
Die Optik des Rahmens selbst gilt gemeinsam für den Shoutout-Clip und den Raid-Clip (leer/Standard = eingebaute Vorgabe bzw. Akzentfarbe der globalen Optik):
| Feld | Bedeutung | Beispiel |
|---|---|---|
Rahmenfarbe | Randfarbe des Rahmens | #a970ff |
Schild-Hintergrund | Hintergrund des Namensschilds | wie Rahmen |
Schriftfarbe | Textfarbe im Namensschild | #ffffff |
Schriftart | websichere Schrift im Namensschild | Impact |
Schriftgröße | Textgröße im Namensschild in Pixeln | 29 |
Größe des Clipfensters | skaliert nur den Clip-Rahmen (Bild/Video + Schild); leer = folgt der allgemeinen Bildgröße oben, sonst eigene, unabhängige Größe | 150 % |
Browserquellen
Jeder Kanal hat ein Standard-Overlay; weitere benannte Browserquellen lassen sich anlegen (Name, eigene URL/Token, umbenennbar, Token neu erzeugen, löschen sofern unbenutzt) — jede Variante wählt ihr Ziel.
Schritt für Schritt: neue Browserquelle hinzufügen
- Alle Browserquellen dieses Kanals aufklappen Meine Kanäle → Alerts → unter „Browserquelle (Standard-Overlay)" das Detail „Alle Browserquellen dieses Kanals" aufklappen.
- „➕ Neue Browserquelle" klicken
Im Namensfeld einen sprechenden Namen eingeben, z. B.
Hype-Ecke— erzeugt sofort eine eigene URL mit eigenem Token. - URL kopieren Bei der neuen Quelle „Kopieren" klicken.
- In OBS einbauen Neue Browserquelle anlegen, URL einfügen (1920×1080, „Quelle beim Aktivieren neu laden" aus).
- Als Ziel auswählen
Bei der gewünschten Alert-Variante, Command-Overlay-Einblendung, Minispiel o. Ä. im Feld
Browserquelledie neue Quelle statt „Standard-Overlay" wählen — ab jetzt spielt genau diese Einblendung dort statt auf dem Standard-Overlay.
Spenden-Webhook
| Feld | Bedeutung | Beispiel |
|---|---|---|
Anbieter | Auto-Erkennung oder fest wählen | Ko-fi, StreamElements, Streamlabs, PayPal, Generisch |
Mindestbetrag | kleinere Spenden lösen keinen Alert aus | 5 |
Währung (Fallback) | greift, wenn der Anbieter keine mitschickt | EUR |
Feld-Zuordnung | nur bei „Generisch": Punkt-Pfade auf verschachtelte Felder | data.donor |
Die Webhook-URL trägst du beim Spenden-Anbieter als Ziel ein. Leakt sie, im Dashboard „Secret neu erzeugen".
Schritt für Schritt: Sub-Alert einrichten
- Browserquelle in OBS einbauen Meine Kanäle → Alerts → Browserquelle kopieren, in OBS als „Browserquelle" einfügen (1920×1080, „Quelle beim Aktivieren neu laden" aus).
- Medium hochladen
Im Reiter Medien ein GIF hochladen, z. B.
sub-hype.gif. - Variante anlegen
Unter „Einblendungen je Ereignis" bei
Subauf „Neue Variante" —NameStandard-Sub,Bildsub-hype.gif,Dauer6Sek. - Text-Vorlage eintragen
{user} ist jetzt Subscriber! 🎉ins Feld Text-Vorlage. - Optional Chat-Nachricht
Häkchen „Chat-Nachricht" setzen:
Danke {user} für den Sub! - Testen & aktivieren Button „Test" klicken — läuft die Einblendung in OBS durch, Häkchen „Aktiv" setzen und speichern.
MedienSTREAMERMOD
Eigener Reiter für Bild-, Video- und Sound-Uploads — mit eigenem Speicherkontingent je Kanal.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Datei | Bild/GIF/Video/Sound — Format wird an den tatsächlichen Bytes geprüft, nicht am Dateinamen | png, gif, webp, mp4, webm, mp3, ogg |
Für alle Kanäle | Häkchen „shared" — Datei erscheint zusätzlich im Medien-Pool jedes anderen Kanals, zählt aber nur auf dein Kontingent | an |
Kontingent | maximaler Gesamtspeicher je Kanal, vom Admin gesetzt | 250 MB |
Genutzt von Alerts, Commands mit Overlay-Einblendung und Minispielen.
WerbungSTREAMER
Werbepausen-Automatik pro Kanal, unabhängig von der zentralen Vorgabe. Häkchen „Werbe-Einstellungen hier verwalten" aktiviert die eigenen Werte.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Command aktiv | erlaubt !werbung [30…180] (Alias !commercial, !ad) für Mods/Broadcaster | an |
Länge | Dauer einer Werbepause in Sekunden | 60 |
Chat-Text (Start) | Nachricht beim Beginn der Pause, {duration} = Sekunden | Kurze Werbepause ({duration}s) – gleich zurück! |
Als Ankündigung | Text als offizielle /announce senden, mit Farbe | an, purple |
Vorwarnung an/aus | warnt vor dem geplanten Werbestart | an |
Vorlauf (Sek.) | wie weit vorher gewarnt wird | 60 |
Vorwarn-Text | {seconds} = Vorlauf, {duration} = Werbelänge | ⚠ In {seconds}s startet die Werbung! |
Automatik an/aus | eigener Zyklus statt Einzelauslösung | an |
Intervall (Min.) | Abstand zwischen automatischen Werbepausen | 60 |
!ad stop beendet den Zyklus, !ad status zeigt die nächste geplante Pause, !ad once [sek] löst eine einmalige Pause ohne Zyklus aus.
Endet dein Stream, pausiert der Zyklus sofort — keine Vorwarnung und kein Werbeversuch im leeren Chat. Bist du binnen 10 Minuten wieder live (z. B. nach einem Verbindungsabbruch), läuft er einfach weiter; sonst endet er still, und du startest ihn im nächsten Stream wieder mit !ad. !ad status zeigt währenddessen „pausiert".
KanalpunkteSTREAMER
Twitch-Kanalpunkte-Rewards direkt aus dem Dashboard anlegen und mit einer Bot-Aktion verknüpfen — ganz ohne Erweiterungs-Panel bei Twitch.
Reward-Felder (bei Twitch)
| Feld | Bedeutung | Beispiel |
|---|---|---|
Titel | Name der Belohnung, wie er bei Twitch erscheint (max. 45 Zeichen) | Songwunsch |
Kosten | Preis in Kanalpunkten | 5000 |
Beschreibung | Prompt-Text unter dem Titel (max. 200 Zeichen) | Wünsch dir einen Song für die Playlist! |
Nutzereingabe nötig | Zuschauer muss bei der Einlösung Text eingeben | an |
Hintergrundfarbe | Kachelfarbe im Twitch-Kanalpunkte-Menü | #9146FF |
Cooldown (Sek.) | globale Sperrzeit, bis der Reward erneut einlösbar ist | 300 |
Max. pro Stream | Obergrenze der Einlösungen je Stream (0 = unbegrenzt) | 3 |
Aktiv / pausiert | Reward für Zuschauer sichtbar bzw. gesperrt | aktiv |
Neue Rewards legt der Bot direkt bei Twitch an; bestehende, bereits vorhandene Rewards lassen sich zum Verknüpfen auswählen, aber nur bot-eigene Rewards vollständig bearbeiten oder löschen.
Verknüpfte Aktion — Aktionstyp
| Typ | Was passiert bei Einlösung | Beispiel |
|---|---|---|
Minispiel | startet automatisch ein Minispiel mit festem, virtuellem Einsatz (es werden keine Loyalty-Punkte abgezogen, Gewinne werden normal gutgeschrieben) — Feld Spiel + Einsatz. Zur Wahl: Coinflip, Glücksrad, Slots, Heist und Jackpot. Bei Heist tritt der Zuschauer der Lobby bei bzw. eröffnet sie (Einsatz muss im erlaubten Bereich des Heists liegen), bei Jackpot nimmt er ohne Eintritt teil (Einsatz wird ignoriert); das Ergebnis kommt wie gewohnt nach Ablauf der Lobby. Duell und Reimbattle gibt es hier nicht, weil sie einen Gegner brauchen. | Glücksrad, Einsatz 500 |
Sound | spielt eine Sound-Datei aus dem Medien-Pool ab — Feld Sound + Lautstärke | airhorn.mp3, 80 % |
Text | zeigt einen Text im Overlay — Feld Text-Vorlage (Platzhalter {user} {input} {reward}, {br} für Zeilenumbruch) | {user} wünscht sich:{br}{input} |
TTS | liest einen Text vor — Feld Text-Vorlage + Stimme | Stimme nova |
Bild/Video | spielt ein Medium aus dem Medien-Pool ab — Feld Medium | confetti.gif |
Command | löst einen Timeout oder einen freigegebenen Dashboard-Command/-Timer aus | Timeout, 60 Sek. |
Zähler | erhöht einen bestehenden Counter um einen festen Betrag | Counter hype, +1 |
Gemeinsame Felder jeder Verknüpfung
| Feld | Bedeutung | Beispiel |
|---|---|---|
Browserquelle | Ziel-Overlay der Einblendung (bei Minispiel/Sound/Bild-Video immer aktiv, sonst wählbar) | Standard-Overlay |
Chat-Nachricht | eigene Antwort im Chat, mit {user} {input} {reward} {cost} — kein {br}, das ist nur in Overlay-Texten wirksam | {user} löst „{reward}" ein! |
Vorlesen (TTS) | zusätzlich die Chat-Nachricht vorlesen lassen, unabhängig vom Aktionstyp | an |
Aktiv | Verknüpfung an-/ausschalten; deaktiviert pausiert der Bot den Reward — soweit möglich — automatisch bei Twitch | an |
Der Button „Test" löst die Aktion einmal probeweise aus, ohne echte Kanalpunkte abzuziehen — bei Timeout/eigenem KI-Command sowie Heist/Jackpot prüft er nur, ob die Aktion korrekt aufgelöst wird (beim Test wird keine echte Lobby eröffnet).
Schritt für Schritt: Reward mit Soundeffekt verknüpfen
- Meine Kanäle → Kanalpunkte öffnen Kanal muss vorher unter Alerts mit Twitch verbunden sein.
- Neuen Reward anlegen
„Neuer Reward" —
TitelAirhorn,Kosten2000,Max. pro Stream5. - Sound hochladen (falls nötig)
Im Reiter Medien
airhorn.mp3hochladen. - Aktion verknüpfen
Beim neuen Reward auf „Aktion verknüpfen" —
AktionstypSound,Soundairhorn.mp3,Lautstärke80 %. - Chat-Nachricht ergänzen (optional)
{user} lässt den Airhorn los! 📣ins Feld Chat-Nachricht. - Testen & aktivieren Button „Test" prüft die Einblendung in OBS, Häkchen „Aktiv" setzen und speichern — der Reward ist ab sofort bei Twitch einlösbar.
LoyaltySTREAMER
Punkte- und Watchtime-System mit Leaderboard.
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | Loyalty für diesen Kanal aktivieren | an |
Currency-Name | Punktename, daraus wird der Chat-Command !<name> | memecoins → !memecoins |
Punkte | Menge pro Intervall | 10 |
Intervall (Min.) | wie oft Punkte vergeben werden | 5 |
Sub-Multiplikator | Subscriber bekommen fürs Zusehen entsprechend mehr Punkte | 2 = doppelt |
Aktiv-Chatter-Multiplikator | wer kürzlich geschrieben hat, bekommt mehr Punkte (nicht Watchtime); stapelt mit dem Sub-Multiplikator | 1.5 |
Aktiv-Fenster (Min.) | Zeitraum, der als „kürzlich geschrieben" zählt | 15 |
Alle Anwesenden zählen | Watchtime/Punkte auch für stille Lurker mit offenem Chat, nicht nur Schreiber | an |
Follow-Bonus | einmalige Punkte beim Follow | 100 |
Tip-Bonus | Punkte je Spenden-Einheit (Bonus × Betrag) | 10 pro € |
Cheer-Bonus | Punkte je 100 Bits | 5 |
Raid-Bonus | Punkte an den raidenden Kanal | 50 |
Ignorierte User | bekommen keine Punkte fürs Zusehen | nightbot |
Watchtime-Command | Chat-Command für die gesehene Zeit | watchtime → !watchtime |
Leaderboard mit Punkte-/Watchtime-Sortierung, Username-Suche, manuellem ± je Zeile und CSV-Import (StreamElements-Export oder generisch, Modus zusammenführen/ersetzen).
MinispieleSTREAMERMOD
Chat-Minispiele je Kanal an-/ausschalten und konfigurieren — alle setzen aktives Loyalty voraus.
Gemeinsame Felder (jedes Spiel)
| Feld | Bedeutung | Beispiel |
|---|---|---|
Aktiv | Spiel für den Kanal freischalten | an |
Command | Chat-Wort ohne Präfix; leer = Spielname | flip |
Aliase | zusätzliche Trigger, max. 5 | coin |
Einsatz min./max. | erlaubte Einsatzspanne in Loyalty-Punkten | 10 – 1000 |
Cooldown (Sek.) | Sperrzeit je User | 5 |
Tages-Verlustlimit | kanalweit: kappt den Netto-Tagesverlust je User (0 = aus) | 5000 |
Browserquelle | Overlay-Ziel für die Spiel-Einblendung | Standard-Overlay |
Chat-Texte | Vorlagen je Ausgang (win/push/lose/no_bet) mit {user} {bet} {payout} {balance} | {user} gewinnt {payout} Punkte! 🎉 |
Coinflip
Klassischer Einsatz-Münzwurf — nur die gemeinsamen Felder, Auszahlung als Multiplikator je Ausgang.
Slots — zusätzliche Felder
| Feld | Bedeutung | Beispiel |
|---|---|---|
Gewichte | Auftrittshäufigkeit je Symbol (Ganzzahl) | 🍒: 40, 7️⃣: 2 |
Auszahlungen | Multiplikator je Symbol-Kombination | three_7: 20× |
Jackpot-Schwelle | ab diesem Multiplikator gilt ein Treffer als Jackpot | 10 |
Gewinnchance manuell festlegen + Gewinnchance (%) | feste Gewinnwahrscheinlichkeit statt der aus den Gewichten berechneten — Eingabe in Prozent | an, 30 = 30 % |
Glücksrad — zusätzliche Felder
| Feld | Bedeutung | Beispiel |
|---|---|---|
Segmente | Liste der Rad-Felder mit Multiplikator | 0×, 2×, 5×, Mystery |
Gleiche Segmentgröße | alle Segmente gleich groß statt gewichtet | aus |
Mystery min./max. | Spanne, aus der ein Mystery-Treffer seinen Multiplikator würfelt | 0.1 – 10 |
Gratis-Dreh-Wert | virtueller Einsatz für kostenlose Drehs (echter Einsatz bleibt 0) | 50 |
Chatrain-Punkte | Punkte, die bei einem „Chatrain"-Segment verteilt werden | 50 |
Duell — zusätzliche Felder
Nutzt nur die gemeinsamen Felder: ein Chatter fordert per Command einen anderen heraus, Einsatz und Auszahlung wie oben.
Heist — zusätzliche Felder
| Feld | Bedeutung | Beispiel |
|---|---|---|
Lobby-Dauer (Sek.) | wie lange sich die Crew sammeln kann | 120 |
Crew min./max. | nötige bzw. maximale Teilnehmerzahl | 2 – 50 |
Crew-Bonus | Erfolgschance steigt mit jedem Mitglied | 0.02 je Kopf |
Solo-Abzug | Erfolgschance sinkt, wenn nur einer mitmacht | 0.1 |
Beute-Modus | multiplier (Einsatz × Faktor) oder split (Topf geteilt) | split |
Heist-Cooldown (Sek.) | Sperrzeit zwischen zwei Heists im Kanal | 300 |
Erinnerung vor Start (Sek.) | Chat-Erinnerung, bevor die Lobby schließt | 30 |
Letzter Aufruf (Sek.) | letzte Erinnerung kurz vor Lobby-Ende | 5 |
Ergebnis ansagen | Ausgang zusätzlich als Chat-Ankündigung | an |
Jackpot — zusätzliche Felder
Wie der Heist ein Lobby-Gruppenspiel: der Chat-Command tritt einer offenen Runde bei (bzw. eröffnet sie) und bucht dabei die Beitrittsgebühr in den Topf. Nach Ablauf der Beitritts-Dauer entscheidet EIN Wurf gegen die Gewinnchance, ob es überhaupt einen Gewinner gibt — bei Erfolg bekommt ein zufällig ausgeloster Mitspieler den kompletten Topf, sonst bleibt er stehen und wächst mit der nächsten Runde weiter.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Beitrittsgebühr | Punkte, die der Beitritt zur Runde kostet | 100 |
Mods gratis | Moderatoren zahlen keine Beitrittsgebühr | an |
Mindest-Topf | der Topf muss mindestens so viele Punkte enthalten, bevor beigetreten werden kann | 1000 |
Anteil verlorener Punkte in den Topf (%) | Anteil des Hausgewinns anderer Spiele, der in den Topf fließt — Eingabe in Prozent | 100 = 100 % |
Beitritts-Dauer (Sek.) | wie lange sich Mitspieler sammeln können | 120 |
Runden-Cooldown (Sek.) | Sperrzeit zwischen zwei Runden im Kanal | 300 |
Erinnerung vor Ziehung (Sek.) | Chat-Erinnerung, bevor die Runde schließt | 30 |
Letzter Aufruf (Sek.) | letzte Erinnerung kurz vor Ziehung | 5 |
Gewinnchance (%) | Wahrscheinlichkeit, dass die Runde überhaupt einen Gewinner hat — Eingabe in Prozent, Kommawerte erlaubt | 5 = 5 %, 0.5 = 0,5 % |
Status-Command | zeigt den aktuellen Topfstand | pot → !pot |
Ergebnis ansagen | Ausgang zusätzlich als Chat-Ankündigung | an |
GiveawaysSTREAMERMOD
Verlosungen mit Chat-Eintrag und Ziehung — auch für Mods verfügbar.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Preis-Text | was verlost wird | Steam-Key: Hollow Knight |
Eintrag-Command | Chat-Wort, je offenem Giveaway eindeutig | giveaway → !giveaway |
Kosten je Ticket | kostenlos oder Loyalty-Punkte je Los | 50 |
Max. Tickets je User | Obergrenze pro Teilnehmer | 5 |
Sub-Multiplikator (Lose) | Subscriber bekommen pro Ticket mehr Lose (Punktekosten unverändert) | 2 |
Botantwort im Chat | bestätigt Eintrag/zu wenig Punkte/Blacklist | an |
Chat-Nachricht beim Öffnen | Text beim Anlegen/Wieder-Öffnen, mit {prize} {command} {cost} {max} | 🎁 Verlosung „{prize}" ist offen! Mitmachen mit !{command} |
Vorheriges Schreiben nötig | User muss seit Streambeginn schon einmal im Chat geschrieben haben | an |
Auto-Blacklist nach N Verstößen | sperrt einen User nach wiederholten Verstößen automatisch (0 = aus) | 3 |
Ziehungs-Overlay | Browserquelle für die Ziehungs-Animation | Standard-Overlay |
Animationsdauer | Länge der Ziehungs-Animation | 5 s |
Announce-Text | Gewinner-Ansage im Chat, mit {winner} {prize} | 🎉 {winner} gewinnt „{prize}"! |
Reiter Status: Teilnehmer einsehen/entfernen, schließen, Gewinner ziehen, als abgeschlossen markieren. Reiter Liste: wiederverwendbare Preise mit Name, Sponsor und Restbestand. Reiter Archiviert: abgeschlossene Giveaways durchsuchen und nach Alter aufräumen.
Schritt für Schritt: Giveaway durchführen
- Meine Kanäle → Giveaways → Settings öffnen „Neues Giveaway" klicken.
- Preis & Command festlegen
Preis-TextSteam-Key: Hollow Knight,Eintrag-Commandgiveaway. - Kosten wählen
kostenlos lassen oder
Kosten je Ticket50Loyalty-Punkte setzen, dazuMax. Tickets je User3. - Öffnen
Speichern — der Bot postet die Chat-Nachricht beim nächsten Sync und
!giveawaynimmt ab sofort Einträge an. - Verlauf beobachten Im Reiter Status → „Übersicht öffnen" die aktuelle Teilnehmerliste ansehen.
- Schließen & ziehen Wenn genug Einträge da sind: „Schließen", dann „Gewinner ziehen" — die Ziehungs-Animation läuft im Overlay, danach postet der Bot den Announce-Text im Chat.
- Abschließen Nachdem der Gewinner sich gemeldet hat: „Als abgeschlossen markieren" — das Giveaway wandert ins Archiv.
ToolsSTREAMER
Overlay-Werkzeuge, dieselbe Optik wie bei den Alerts (gerahmte Box, konfigurierbares Namensschild).
Stoppuhr
| Feld | Bedeutung | Beispiel |
|---|---|---|
Start-Command | startet die Stoppuhr | stoppuhr |
Stop-Command | stoppt und zeigt die Zeit | stopp |
Aliase | zusätzliche Trigger je Command | sw |
Wer darf bedienen | mods oder everyone | mods |
Zeitformat | mm:ss, mm:ss.d oder hh:mm:ss | mm:ss.d |
Overlay-Ziel | Standard oder eine benannte Browserquelle | Standard-Overlay |
Stopp-Nachricht | Chat-Text mit {time} = gestoppte Zeit | Zeit gestoppt: {time} |
Auto-Ausblendzeit (Sek.) | Overlay blendet sich nach dem Stopp automatisch aus | 20 |
Rahmen / Namensschild / Schrift / Farben | Optik wie bei den Alerts — Rahmen an/aus, Schild-Text, Schriftart/-größe, Text-/Akzentfarbe | Schild-Text Speedrun |
Countdown
| Feld | Bedeutung | Beispiel |
|---|---|---|
Name | Bezeichnung des benannten Countdowns | Pause |
Command | startet genau diesen Countdown | pause |
Dauer (Sek.) | feste Laufzeit dieses Countdowns | 300 |
Start-Nachricht | Chat-Text beim Start | ⏳ Pause gestartet! |
Ablauf-Nachricht | Chat-Text mit {name}, wenn die Zeit abläuft | ⏰ {name} – Zeit abgelaufen! |
Ablauftext im Overlay | kurzer Text, der im Overlay bei 0 erscheint | Zeit abgelaufen! |
Abbrechen-Command | stoppt alle laufenden Countdowns auf einmal | countdownstop |
Zusätzlich ein spontaner Countdown, dessen Dauer aus dem Chat-Command selbst kommt, z. B. !countdown Pause 5 Minuten 30 Sekunden (eigenes Feld Max. Dauer begrenzt den größtmöglichen Wert). Mehrere gleichzeitig laufende Countdowns werden im Overlay gestapelt.
Subathon NEU
Ein Countdown im Overlay, der sich durch Aktionen deiner Community verlängert. Unter Tools → Subathon / Ziele startest du ihn mit Minuten, pausierst, setzt fort, korrigierst die Zeit (auch negativ) oder beendest ihn. Der Zustand bleibt auch bei einem Neustart erhalten; pausiert zeigt das Overlay die eingefrorene Zeit.
| Regel | Bedeutung | Standard |
|---|---|---|
Minuten je Sub/Resub | Tier 2 zählt doppelt, Tier 3 dreifach | 5 |
Minuten je verschenktem Sub | je Empfänger | 5 |
Bits für +1 Minute | 0 = Bits zählen nicht | 100 |
Sekunden je Follow | neue Follower verlängern den Timer | 0 |
Minuten je Raid | jeder eingehende Raid | 0 |
Maximale Restzeit (Stunden) | Deckel, damit der Timer nicht unbegrenzt wächst | 24 |
Im Chat: !subathon zeigt die Restzeit (alle), Mods steuern mit !subathon start <min>, pause, resume, add <min>, stop.
Ziele NEU
Fortschrittsbalken im Overlay. Pro Ziel: Name, Art (Subs, Follower, Bits zählen automatisch mit; Manuell änderst du selbst), Ziel (Zielwert), Stand und aktiv. Bis zu 10 Ziele je Kanal. Wird ein Ziel erreicht, meldet der Bot das im Chat. Im Chat zeigt !goal den Fortschritt, Mods ändern mit !goal set <nr|name> <wert> oder !goal add <nr|name> <n>.
Overlay-Zuweisung & Optik für Subathon und Ziele NEU
Beide Bereiche haben unter Overlay-Zuweisung & Optik dieselben Einstellungen wie Stoppuhr und Countdown:
| Feld | Bedeutung | Beispiel |
|---|---|---|
Overlay-Ziel | in welcher Browserquelle es erscheint — Standard-Overlay oder eine deiner benannten Quellen. Nicht vergessen zuzuweisen, sonst läuft es im Standard-Overlay. | Standard-Overlay |
Rahmen / Kasten | Subathon: Rahmen mit Namensschild an/aus. Ziele: Kasten hinter jedem Balken an/aus. | an |
Name im Rahmen | Text im Namensschild (nur Subathon) | Subathon |
Schriftart / Schriftgröße | websichere Schriftart und Größe in px | Arial, 54 |
Textfarbe | beliebiger CSS-Farbwert | #ffffff |
Akzentfarbe / Balkenfarbe | Subathon: Rahmen/Glow. Ziele: Farbe des Balkens. | #9147ff |
Position, Breite, Kastenfarbe | nur Ziele: sechs Positionen (oben/unten × links/mittig/rechts), Breite in px, Hintergrund des Kastens | unten links, 460 |
?demo=goal an die Overlay-URL hängen. Nach dem Update in OBS einmal Cache der aktuellen Seite aktualisieren.Zitate NEU
Unter Tools → Zitate siehst du alle gespeicherten Zitate, kannst neue hinzufügen oder löschen. Die Nummern zählen je Kanal hoch und werden nach dem Löschen nicht neu vergeben. Im Chat: !quote (zufällig) oder !quote 3, Mods speichern mit !addquote <text> und löschen mit !delquote <nr>.
Chat-TTS NEU
Liest laufende Chat-Nachrichten automatisch per Sprachausgabe im Overlay vor — läuft als eigene Ebene mit eigener Warteschlange, damit ein reger Chat nie einen Follow-/Raid-/Sub-Alert verzögert.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Aktiv | Chat-TTS für den Kanal einschalten | an |
Command | Chat-Wort für den Steuerbefehl (nicht zum Vorlesen selbst — das passiert automatisch) | tts → !tts … |
Stimme | OpenAI-Vorlesestimme | nova |
Browserquelle | Ziel-Overlay für die Vorlese-Einblendung | Standard-Overlay |
Min. Zeichen | kürzere Nachrichten werden übersprungen | 2 |
Max. Zeichen | Obergrenze, ab der eine Nachricht gekappt/übersprungen wird | 200 |
Anzeigedauer (Sek.) | wie lange die Vorlese-Einblendung sichtbar bleibt | 6 |
Commands überspringen | Nachrichten, die mit dem Bot-Präfix beginnen (!…), nicht vorlesen | an |
Links überspringen | Nachrichten mit erkennbaren Links nicht vorlesen | an |
Text im Overlay anzeigen | zusätzlich zur Sprachausgabe die Zeile im Overlay einblenden; aus = nur Ton, keine sichtbare Textzeile | an |
Username anzeigen | Absender vor dem Text mit einblenden | an |
Rahmen / Schrift / Farben | Optik wie bei Stoppuhr/Countdown | Akzentfarbe #a970ff |
Ignorierte User | diese Logins werden nie vorgelesen (einer pro Zeile) | nightbot |
Der Steuerbefehl läuft direkt im Chat (nur Mods/Broadcaster) und schreibt in dieselbe Einstellung, die auch das Dashboard pflegt:
| Command | Wirkung |
|---|---|
!tts on / !tts off | Chat-TTS für den Kanal an-/ausschalten |
!tts ignore <user> / !tts unignore <user> | User von der Vorlese-Funktion ausnehmen / wieder zulassen |
!tts ignorelist | zeigt die aktuelle Ignorierliste |
!tts status | zeigt, ob Chat-TTS gerade an oder aus ist |
ModerationSTREAMER
Keyword-Blacklist, Link-, Caps-, Spam-, Symbol-/Emote- und Backseat-/Meta-Schutz je Kanal, dazu ein gemeinsames Warnsystem — alles wird komplett im Dashboard gepflegt. Der Moderation-Tab hat zwei Unterreiter: Konfiguration (alle Regeln/Schutzmechanismen unten) und Verstöße (der Warnsystem-Zähler je User). Keyword-Regeln speicherst du einzeln; alle Schutz-Blöcke darunter gemeinsam über die Leiste Alle Änderungen speichern am unteren Rand.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Muster | der zu erkennende Text | schleichwerbung |
Vergleich | word ganzes Wort, substring auch mitten im Wort, regex reguläre Ausdrücke (≤ 200 Zeichen) | word |
Strafe | purge (1-Sek.-Timeout, entfernt sichtbare Nachrichten), timeout oder ban | timeout |
Dauer | nur bei timeout: 1 Sekunde bis 14 Tage | 600 (10 Min.) |
Grund | an Twitch sichtbarer Grund; leer = „Blacklist-Keyword: <Muster>" | Verbotener Begriff |
Chat-Warnung | optionale öffentliche Warnung mit $user/$channel, 10 s Anti-Spam je User | $user, bitte die Regeln beachten. |
Ausnahmen | Mods / VIPs / Subs von dieser Regel ausnehmen | VIPs ausgenommen |
Aktiv | Regel vorübergehend deaktivieren | an |
Broadcaster und Admins sind immer ausgenommen. Es greift immer die erste passende Regel; Suche über das Muster, Pagination ab 15 Regeln.
Starter-Vorlage NEU
Du musst die Blacklist nicht von Hand füllen: Über die Karte Starter-Vorlage oberhalb der Regelliste übernimmst du mit + Vorlage übernehmen ein fertiges Regelset (nach einer Rückfrage).
| Gruppe | Strafe |
|---|---|
| Spam & Scam: Follower-/Viewer-Verkauf, bekannte Spam-Seiten, „free Nitro/Robux“, Adult-Spam | ban |
| Rassismus & Hassrede: N-Wort (auch mit Leetspeak oder Bindestrichen), weitere Slurs, „Ausländer raus“, „white power“, NS-Parolen und -Codes | ban |
| Messenger-Einladungslinks (t.me, wa.me, WhatsApp) | timeout 1 Std. |
| Suizid-Aufforderungen („kys“, „bring dich um“) | timeout 1 Tag + Chat-Warnung |
| Beleidigungen (z. B. „Hurensohn“, „Wichser“, „Spast“) | timeout 10 Min. + Chat-Warnung |
Die Vorlage ist idempotent: Regeln, die es schon gibt, werden übersprungen — du kannst den Button also gefahrlos mehrfach drücken. Danach sind es ganz normale Regeln, die du ändern, ausschalten oder löschen kannst; Mods sind wie überall ausgenommen. Spätere Ergänzungen der Vorlage erreichen nur Kanäle, die sie danach erneut übernehmen.
Link-Schutz
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | Nachrichten mit Links von normalen Usern löschen | an |
VIPs erlauben | VIPs dürfen trotzdem Links posten | an |
Erlaubte User | diese Logins dürfen immer Links posten | meinco_host |
Erlaubte Links | Muster mit * als Wildcard, die niemals gelöscht werden | clips.twitch.tv/*, youtube.com/watch* |
Moderatoren und der Broadcaster sind immer ausgenommen. Löschen braucht serverseitig den Twitch-Moderator-Status des Bots im Kanal.
Caps-Schutz
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | Nachrichten mit zu vielen Großbuchstaben ahnden | an |
VIPs erlauben | VIPs dürfen trotzdem in Caps schreiben | an |
Erlaubte User | diese Logins sind immer ausgenommen | meinco_host |
Mindestlänge | erst ab dieser Nachrichtenlänge greift die Prüfung | 10 |
Großbuchstaben-Anteil | Prozentsatz Großbuchstaben, ab dem es als Verstoß zählt | 70 % |
Chat-Warnung | optionale öffentliche Warnung mit $user/$channel | $user, bitte nicht schreien. |
Warn-Cooldown | Warnung je User frühestens wieder nach so vielen Sekunden (0 = jedes Mal) | 30 |
Spam-Schutz
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | zu schnell aufeinanderfolgende Nachrichten ahnden | an |
VIPs erlauben | VIPs ausnehmen | an |
Erlaubte User | diese Logins sind immer ausgenommen | meinco_host |
max. Nachrichten | so viele Nachrichten sind im Zeitfenster erlaubt | 5 |
Zeitfenster (Sek.) | Zeitraum, in dem die Nachrichten gezählt werden | 10 |
Wiederholung blocken | direkt zweimal dieselbe Nachricht zählt ebenfalls als Verstoß | an |
Chat-Warnung | optionale öffentliche Warnung mit $user/$channel | $user, langsamer bitte. |
Warn-Cooldown | Warnung je User frühestens wieder nach so vielen Sekunden (0 = jedes Mal) | 30 |
Symbol-/Emote-Schutz
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | Nachrichten mit zu vielen Sonderzeichen oder Emotes ahnden | an |
VIPs erlauben | VIPs ausnehmen | an |
Erlaubte User | diese Logins sind immer ausgenommen | meinco_host |
Mindestlänge | der Sonderzeichen-Anteil greift erst ab dieser Nachrichtenlänge | 10 |
Sonderzeichen-Anteil | Prozentsatz Sonderzeichen, ab dem es als Verstoß zählt | 70 % |
max. Emotes | so viele Emotes sind pro Nachricht erlaubt (0 = Prüfung aus) | 10 |
Chat-Warnung | optionale öffentliche Warnung mit $user/$channel | $user, weniger Emotes bitte. |
Warn-Cooldown | Warnung je User frühestens wieder nach so vielen Sekunden (0 = jedes Mal) | 30 |
Bei Caps-, Spam- und Symbol-/Emote-Schutz sind Broadcaster, Admins und Moderatoren immer ausgenommen — zusätzlich zu den oben eingestellten Ausnahmen.
Backseat-/Meta-Schutz
Erkennt per KI ungefragte Spielanweisungen („geh nach links“, „du musst erst X holen“) und optional Meta — also Infos, die du selbst nicht haben kannst, z. B. aus dem Stream eines Mitspielers. Ein lokaler Vorfilter schickt nur verdächtige Nachrichten an die KI; die bekommt dazu Spiel, Streamtitel und die letzten Chatzeilen. Die Prüfung läuft im Hintergrund, ein Treffer wird deshalb ein bis zwei Sekunden später gelöscht.
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | Backseat-Erkennung aktiv (Standard aus, verbraucht API-Tokens) | an |
Meta erkennen | auch Meta erkennen — Treffer werden nur im Aktivitäts-Log gemeldet, der Bot greift nicht ein | aus |
VIPs ausnehmen | VIPs dürfen Tipps geben | an |
Erlaubte User | diese Logins sind immer ausgenommen | mein_coach |
Mindest-Sicherheit | wie sicher sich die KI sein muss (0.5–1); höher = weniger Fehlalarme | 0.8 |
Nachricht löschen | erkannte Backseat-Nachricht entfernen | an |
Als Verstoß zählen | Treffer zählt im Warnsystem mit und kann so zu Timeouts führen (Standard aus) | aus |
Chat-Warnung | optionale öffentliche Warnung mit $user/$channel | $user, bitte kein Backseat 🙏 |
Warn-Cooldown | Warnung je User frühestens wieder nach so vielen Sekunden (0 = jedes Mal) | 60 |
Pause nach Frage | fragst du selbst „Chat, …?“, ist Rat erwünscht — so viele Sekunden wird nicht geprüft | 120 |
max. KI-Prüfungen/Min. | Kostendeckel pro Kanal; darüber wird nicht mehr geprüft | 20 |
Im Chat schalten Mods den Schutz mit !bot backseat on|off und die Meta-Erkennung mit !bot backseat meta on|off — das ändert dieselbe Einstellung wie hier im Dashboard und wirkt sofort.
Warnsystem
Ein gemeinsamer Verstoßzähler pro Kanal und User, der von allen fünf Moderations-Mechanismen (Keyword-Blacklist, Link-, Caps-, Spam-, Symbol-/Emote-Schutz) gefüttert wird — der Backseat-Schutz nur, wenn dort „Als Verstoß zählen“ an ist. Der Zähler läuft nie von selbst zurück — er zählt jeden Verstoß dauerhaft mit und löst ab konfigurierbaren Schwellen automatisch eine Strafe aus.
| Feld | Bedeutung | Beispiel |
|---|---|---|
An/Aus | automatische Strafen bei Schwellenüberschreitung | an |
Verstöße bis Timeout | ab dieser Gesamtzahl an Verstößen wird der User automatisch getimeoutet | 3 |
Timeout-Dauer (Sek.) | Länge des automatischen Timeouts | 600 (10 Min.) |
Verstöße bis Ban | ab dieser Gesamtzahl wird der User dauerhaft gebannt; muss höher sein als „Verstöße bis Timeout" | 6 |
Im Unterreiter Verstöße siehst du den aktuellen Zählerstand je User, kannst ihn durchsuchen, manuell bearbeiten oder auf 0 zurücksetzen.
WissenSTREAMER
Regelwerk, FAQ & Co. als Link oder Datei hinterlegen — der Bot beantwortet Fragen dazu anhand dieser Quellen, nur in deinem Kanal.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Stichwort | Name der Quelle und zugleich das Wort, mit dem man im Chat danach fragt (Pflicht, mind. 3 Zeichen, Groß-/Kleinschreibung egal; später in der Liste änderbar) | Regelwerk |
Link | Webseite oder PDF-Link; per „Neu laden" holst du Änderungen am Online-Regelwerk | https://deathvalleyroleplay.de/regelwerk.html |
Datei | statt Link: PDF (mit Text, keine Scans), Word .docx, TXT/Markdown oder HTML, max. 10 MB | regeln.pdf |
Aktiv | Quelle vorübergehend abschalten, ohne sie zu löschen | an |
- Quelle anlegen Stichwort eintragen, Link einfügen oder Datei wählen, „Hinzufügen" klicken. Die Liste zeigt danach, wie viel Text gelesen wurde.
- Kurz warten Der Bot übernimmt neue oder geänderte Quellen beim nächsten Abgleich (ca. 1 Minute).
- Im Chat fragen
Den Bot direkt ansprechen und das Stichwort nennen:
@bot Regelwerk: was ist RDM?oder@bot laut Regelwerk, darf ich eine Maske tragen?
Ohne Stichwort (@bot was ist RDM?) antwortet der Bot ganz normal, ohne die Quelle. Steht die Antwort nicht in der Quelle, sagt er das, statt etwas zu erfinden. Bis zu 10 Quellen pro Kanal.
Regelwerk oder FAQ. Die Suche arbeitet mit Stichwörtern: Die Frage sollte Begriffe enthalten, die auch in der Quelle vorkommen.SpracheSTREAMER
Sprich mit dem Bot, statt zu tippen — er antwortet per KI oder führt deine Anweisung als Chat-Befehl aus.
- Einschalten Unter Einstellungen „Sprachsteuerung aktiv" anhaken und speichern. Beim ersten Sprechen fragt der Browser nach dem Mikrofon — erlauben.
- Mikrofon prüfen Unter dem Sprech-Button wählst du, welches Mikrofon dieser Browser nutzt. Die Namen erscheinen nach der ersten Aufnahme.
- Taste halten und sprechen „Gedrückt halten zum Sprechen" halten oder einfach die Leertaste gedrückt halten (nicht während du in ein Feld tippst), sprechen, loslassen. Bis zu 30 Sekunden pro Aufnahme.
- Ergebnis prüfen
Darunter siehst du, was verstanden wurde und was der Bot daraus macht: „Bot antwortet per KI", „Bot sucht im Web" oder einen Befehl wie
!so max.
Was der Bot daraus macht
| Du sagst | Der Bot |
|---|---|
| „Was hältst du von dem Boss gerade?" | antwortet per KI — im Chat und/oder vorgelesen im Overlay |
| „Wie ist das Wetter in Berlin?" | sucht im Web und antwortet mit echten, aktuellen Infos (auch News, Ergebnisse, Termine) |
| „Mach einen Shoutout für Max" | führt !so max aus |
| „Starte eine Umfrage: Pizza oder Döner?" | führt !poll mit Frage und Antworten aus |
| „Sag dem Chat, dass ich kurz Pause mache" | schreibt den Satz per !bot say in den Chat |
| „Gib dem Troll einen Timeout" | zeigt den Befehl mit Ausführen / Verwerfen — läuft erst nach deinem Klick |
Befehle laufen mit deinen Rechten, als hättest du sie selbst getippt. Es werden nur vorhandene Befehle genutzt (eingebaute und deine eigenen Commands). Ban, Timeout, Löschen und Ähnliches brauchen immer deine Bestätigung — die verfällt nach 2 Minuten.
Drei Wege zum Sprechen — welcher passt?
| Weg | Gut für | Einschränkung |
|---|---|---|
| Dashboard am PC | schnell ausprobieren, Button oder Leertaste | nur solange der Browser vorne ist — nicht mitten im Spiel |
| Handy | ohne Download und ohne Windows-Warnung; Handy neben die Tastatur legen | Bildschirm muss an und die Seite offen bleiben |
| Windows-Client | Push-to-Talk mitten im Spiel mit eigener Taste (z. B. Maus-Seitentaste) | einmalige Einrichtung, Windows-Warnung beim ersten Start |
Handy als Sprechtaste NEU
Wer den Windows-Client nicht möchte, nimmt einfach das Handy: Das Dashboard funktioniert im Handy-Browser (Safari, Chrome) genauso — nichts installieren, keine Datei, keine Windows-Warnung. Gesprochen wird ins Handy-Mikrofon.
- Dashboard am Handy öffnen Im Handy-Browser das Dashboard aufrufen und mit deinem normalen Zugang anmelden.
- Zum Reiter Sprache Meine Kanäle → Sprache, oben deinen Kanal wählen. Tipp: Seite als Lesezeichen oder über Teilen → Zum Home-Bildschirm (Safari) bzw. ⋮ → Zum Startbildschirm hinzufügen (Chrome) ablegen — dann ist sie mit einem Tipp da.
- Mikrofon erlauben Beim ersten Drücken fragt der Browser nach dem Mikrofon — Erlauben tippen. Danach den Button noch einmal drücken.
- Gedrückt halten und sprechen Den lila Button mit dem Finger festhalten: er wird rot, solange aufgenommen wird. Loslassen schickt die Aufnahme ab, darunter steht, was verstanden wurde und was der Bot macht.
- Bestätigen Ban, Timeout & Co. erscheinen mit Ausführen / Verwerfen — antippen.
Desktop-Client: sprechen aus dem Spiel heraus NEU
Die Leertaste im Dashboard funktioniert nur, solange der Browser vorne ist. Für Push-to-Talk mitten im Spiel gibt es einen kleinen Windows-Client — ohne Installation. Lieber nichts herunterladen? Dann nimm das Handy (siehe oben).
Einrichten — Schritt für Schritt
- Herunterladen
Im Dashboard unter Meine Kanäle → Sprache bei „Desktop-Client" auf Client herunterladen klicken. Du bekommst die Datei
twitchbot-sprache-<kanal>.cmd. - Download behalten (nur falls der Browser fragt) Chrome und Edge warnen bei Skript-Dateien manchmal mit „Diese Datei kann schädlich sein". Im Download-Bereich (oben rechts der Pfeil) bei der Datei auf Behalten bzw. ⋯ → Behalten → Trotzdem behalten klicken.
- An einen festen Ort legen
Die Datei aus dem Download-Ordner in einen eigenen Ordner verschieben, z. B.
Dokumente\Twitchbot— dort räumt sie niemand versehentlich weg. Tipp: Rechtsklick → Senden an → Desktop (Verknüpfung erstellen) für den schnellen Start. - Erster Start: Windows-Warnung einmalig abschalten Doppelklick auf die Datei. Windows zeigt „Datei öffnen – Sicherheitswarnung: Der Herausgeber konnte nicht verifiziert werden". Unten den Haken bei „Vor dem Öffnen dieser Datei immer bestätigen" entfernen, dann Ausführen klicken. Ab jetzt startet der Client ohne Nachfrage.
- Falls stattdessen ein blaues Fenster kommt „Der Computer wurde durch Windows geschützt" (SmartScreen): auf Weitere Informationen und dann Trotzdem ausführen klicken.
- Client-Fenster offen lassen Es öffnet sich ein schwarzes Fenster mit den Tasten oben. Gern minimieren — schließen beendet den Client.
- Mikrofon wählen Beim ersten Start listet der Client alle Aufnahmegeräte — Nummer eintippen, Enter. Nimm das echte Mikro, keinen „Stream Mix" (der enthält Spielsound).
- Sprechen Im Spiel F9 gedrückt halten, sprechen, loslassen — ein kurzer Ton markiert Start und Ende. Das Fenster zeigt, was verstanden wurde.
- Bestätigen Bei Ban, Timeout & Co. piept es zweimal: innerhalb von 10 Sekunden F10 drücken, sonst wird verworfen.
| Taste | Wirkung |
|---|---|
| F9 (Standard) | gedrückt halten = sprechen — funktioniert überall, auch im Spiel |
| F10 (Standard) | Ban, Timeout & Co. bestätigen (10 s nach dem Doppel-Piep) |
| M | Mikrofon wechseln — nur wenn das Client-Fenster vorne ist |
| T | Tasten ändern: einfach die neue Taste drücken, auch Maus-Seitentasten — nur wenn das Client-Fenster vorne ist |
Das Client-Fenster zeigt die aktuelle Belegung und das gewählte Mikrofon immer oben an. Mikrofon und Tasten werden gespeichert und bleiben auch nach einem neuen Download erhalten. Einmal herunterladen reicht — gibt es eine neue Client-Version, sagt dir das Fenster Bescheid.
Warum warnt Windows — und ist das sicher?
Windows warnt bei jeder Datei aus dem Internet, die keine digitale Signatur hat. Eine .cmd-Datei kann technisch nicht signiert werden, und weil jede Datei deinen persönlichen Zugang enthält, ist sie für jeden Kanal anders. Die Warnung heißt also nur „unbekannte Herkunft", nicht „gefährlich". Du kannst den Inhalt jederzeit selbst ansehen: Rechtsklick auf die Datei → Bearbeiten (öffnet den Editor, nichts wird ausgeführt). Der Client nimmt nur auf, solange die Taste gedrückt ist, schickt die Aufnahme ausschließlich an deinen Bot-Server, löscht sie danach sofort, ändert nichts an Windows und richtet keinen Autostart ein.
| Problem | Lösung |
|---|---|
| Die Warnung kommt bei jedem Start | Beim nächsten Start den Haken „Vor dem Öffnen dieser Datei immer bestätigen" entfernen. Oder: Rechtsklick auf die Datei → Eigenschaften → ganz unten bei „Sicherheit" Zulassen anhaken → OK. |
| Nach einem neuen Download ist die Warnung wieder da | Normal — die neue Datei kommt wieder aus dem Internet. Einmal wie oben bestätigen. Die alte Datei kannst du löschen, sie funktioniert ohnehin nicht mehr. |
| Das Virenschutz-Programm blockiert oder löscht die Datei | Die Datei im Virenschutz als Ausnahme zulassen (bei Microsoft Defender: Windows-Sicherheit → Viren- & Bedrohungsschutz → Schutzverlauf → Eintrag → Zulassen). |
| Fenster geht sofort wieder zu bzw. zeigt „Zugang ungültig" | Der Zugang wurde widerrufen oder es gibt eine neuere Datei für deinen Kanal — im Dashboard neu herunterladen. |
| Die Taste reagiert im Spiel nicht | Manche Spiele laufen mit Administrator-Rechten und schirmen Tasten ab. Dann den Client ebenfalls als Administrator starten (Rechtsklick → Als Administrator ausführen) oder mit T eine andere Taste wählen. |
Einstellungen
| Feld | Bedeutung | Beispiel |
|---|---|---|
Sprachsteuerung aktiv | Hauptschalter; aus = Aufnahme-Taste gesperrt | an |
Anweisungen als Chat-Befehle ausführen | aus = der Bot unterhält sich nur, führt nie Befehle aus | an |
Antwort in den Chat | KI-Antwort im Chat posten | an |
Antwort im Overlay vorlesen | KI-Antwort per Sprachausgabe in der Browserquelle (eigene Ebene wie Chat-TTS, blockiert keine Alerts); Standard aus. Emojis werden nie mitvorgelesen | aus |
Stimme | Stimme fürs Vorlesen | verse |
Overlay-Ziel | in welcher Browserquelle vorgelesen wird | Standard-Overlay |
Erkennungshilfe | Namen und Begriffe, die oft falsch verstanden werden, kommagetrennt (max. 300 Zeichen) | Valorant, Lisa_Mod, Clutch |
AuswertungSTREAMER
Was der Bot in deinem Kanal gemacht hat: Aktivität, KI-Nutzung und seine Logs — nur für deinen Kanal, zum Nachschauen, ohne etwas einzustellen.
| Feld | Bedeutung | Beispiel |
|---|---|---|
Zeitraum | 24 Stunden (Werte pro Stunde), 7 oder 30 Tage (Werte pro Tag); gilt für Kacheln, Diagramme und Logs | 7 Tage |
Kacheln | Summen im Zeitraum: Chat-Nachrichten deiner Zuschauer (ohne Bots und ignorierte Accounts), Bot-Nachrichten, KI-Antworten, Shoutouts, Begrüßungen, Moderation (Caps-/Spam-/Symbol-Verstöße) | Chat-Nachrichten 1.284 |
Diagramme | Verlauf von Chat-Nachrichten, Bot-Nachrichten und KI-Antworten; Maus über eine Säule zeigt den genauen Wert | — |
Logs · Level | alle Meldungen oder nur Warnungen bzw. Fehler | Nur Warnungen |
Logs · Suche | Teilwort in Meldung und Details, Groß-/Kleinschreibung egal; Enter oder „Suchen" | Shoutout |
Die Log-Tabelle zeigt die neuesten 300 Einträge, neueste zuerst — mit Zeit, Level (Info, Warnung, Fehler), Meldung und Details wie Timer-Name oder betroffenem Zuschauer. Für ältere Einträge den Zeitraum verkleinern oder filtern.
Chat-Befehle — für alle
Jeder Zuschauer kann diese Commands im Chat nutzen.
| Command | Wirkung |
|---|---|
!remember <text> | speichert einen Fakt über dich selbst |
!forget <nr> / !forget all | löscht einen / alle Fakten über dich |
!aboutme | zeigt, was der Bot über dich gespeichert hat — kommt standardmäßig per Whisper (privat) |
!quote / !quote <nr> | zufälliges bzw. bestimmtes Zitat (Alias !zitat) |
!subathon | zeigt die Restzeit des laufenden Subathons |
!goal | zeigt den Fortschritt der aktiven Ziele (Alias !ziel) |
!translate [sprache] <text> | übersetzt den Text, z. B. !translate en Guten Morgen; Sprache als Kürzel oder Name, ohne Angabe gilt die Standardsprache des Kanals — nur wenn dein Admin die Übersetzung eingeschaltet hat |
!witzeinreichen <witz> NEU | reicht deinen Witz bei witzapi.de ein (10–500 Zeichen, ohne Links, 1× pro Minute) — keine Garantie, dass er aufgenommen wird. Alias !submitjoke |
!aboutme chat | wie !aboutme, aber sichtbar im Kanal statt per Whisper. Auch: kanal, public, öffentlich |
Aliase: !merkdir !vergiss !whoami !uebermich
Witze in eigenen Commands NEU
Den Witz-Dienst gibt es auch als öffentlichen Link ohne Login — praktisch für eigene Commands (Commands & Timer) oder Chat-Bots wie Nightbot und StreamElements. Mit format=text kommt nur der Witz zurück:
| Link-Zusatz | Wirkung | Beispiel |
|---|---|---|
format=text | nur der Witz als Text — so lässt er sich direkt im Chat ausgeben | $(urlfetch https://<deine-dashboard-adresse>/api/public/joke?format=text) |
source=witz|chuck | deutsche Witze (witzapi.de) oder Chuck-Norris-Witze; ohne Angabe zufällig | ?source=witz |
category=… | nur bei source=witz: Kategorie | ?category=flachwitze |
Chuck-Norris-Witze kommen hier unübersetzt auf Englisch. Pro IP sind höchstens 30 Abrufe pro Minute möglich; fällt die Witz-Quelle aus, kommt eine Fehlermeldung statt eines Witzes.
Chat-Befehle — Mods & Admins
Live-Steuerung direkt im Chat via !bot …. Link-Schutz, die Moderationsbefehle sowie Raid-Mode, !permit, Umfragen, Vorhersagen, Subathon, Ziele und Zitate funktionieren zusätzlich für Moderatoren, alles andere nur für Broadcaster und twitch.admins.
| Command | Wirkung | Rechte |
|---|---|---|
!bot help | Kurzhilfe | Admin |
!bot linkprotection on|off | Link-Schutz im aktuellen Kanal an/aus | Mod+ |
!bot linkprotection status | effektiver Link-Schutz-Zustand des Kanals | Mod+ |
!bot backseat on|off | KI-Backseat-Schutz im Kanal an/aus — ändert direkt die Dashboard-Einstellung (Alias !bot bs) | Mod+ |
!bot backseat meta on|off | Meta-Erkennung an/aus (nur Meldung im Aktivitäts-Log) | Mod+ |
!bot backseat status | zeigt, ob Backseat-Schutz und Meta-Erkennung an sind | Mod+ |
!bot timeout <user> <sek> [grund] | User timeouten (1–1 209 600 s) | Mod+ |
!bot ban / unban / purge <user> | bannen, entbannen, Nachrichten entfernen | Mod+ |
!bot title <text> | Stream-Titel ändern | Mod+ |
!bot game <kategorie> | Stream-Kategorie ändern (Name wird gegen Twitch gesucht) | Mod+ |
!bot raid <kanal> | Raid in <kanal> starten | Mod+ |
!bot raidmode [min] / off / status | Raid-Mode: Follower-only + Slow-Mode für N Minuten (Standard 15), danach stellt der Bot die vorherigen Chat-Einstellungen wieder her — auch nach einem Neustart. Alias !bot shield | Mod+ |
!permit <user> | erlaubt dem User für kurze Zeit (Standard 60 s) Links trotz Link-Schutz | Mod+ |
!poll [sek] Frage | A | B … / !poll end | Twitch-Umfrage starten (bis 5 Optionen, 15–1800 s, Standard 60 s) bzw. beenden | Mod+ |
!predict [sek] Frage | A | B … | Twitch-Vorhersage starten (bis 10 Ergebnisse). Danach !predict lock (sperren), !predict resolve <nr> (Sieger), !predict cancel (abbrechen, Punkte zurück) | Mod+ |
!subathon start <min> / pause / resume / add <min> / stop | Subathon steuern | Mod+ |
!goal set <nr|name> <wert> / add | Stand eines Ziels setzen bzw. erhöhen | Mod+ |
!addquote <text> / !delquote <nr> | Zitat speichern bzw. löschen (auch !quote add <text>) | Mod+ |
!bot status | aktueller Zustand (Pause, Spontaneität, Overrides) | Admin |
!bot persona <text> / clear | temporärer Persona-Zusatz setzen / entfernen | Admin |
!bot engage <0..1> | Spontan-Wahrscheinlichkeit live setzen | Admin |
!bot spontaneous on|off [*] | spontane Reaktionen im Kanal (* = global) an/aus | Admin |
!bot pause / resume | Not-Aus / wieder aktiv | Admin |
!bot say <text> | Bot sagt den Text (gekürzt) | Admin |
!bot ignore <user> [*] | User im Kanal (bzw. global) ignorieren | Admin |
!bot remember/forget <user> … | Fakt über einen anderen User setzen/löschen | Admin |
!bot-Overrides werden gespeichert und überleben einen Neustart. Jede zustandsändernde Aktion landet 30 Tage lang im Audit-Log — im Dashboard nur für den Superadmin sichtbar. title/game/raid brauchen dieselbe Twitch-Freigabe des Kanals wie das Formular oben (Twitch verbinden, Scopes channel:manage:broadcast bzw. channel:manage:raids) — Twitch lässt diese beiden Aktionen nämlich nur vom Broadcaster-Account selbst zu, nicht vom Bot-Account.