FAQ

Fragen, die immer wiederkommen. Sortiert nach Setup, Commands, Permissions, OBS, Daten/Privacy. Wenn deine Frage hier nicht steht, schau im Streamer.bot Discord vorbei.

Setup & Installation

Brauche ich Streamer.bot Pro?

Nein. Streamer.bot ist kostenlos und Open-Core. „Pro“ existiert nicht. Donations gehen an den Entwickler, schalten aber keine Features frei. Alles in diesem Cookbook funktioniert mit der Free-Version.

Funktioniert das mit OBS Studio?

Ja, ab OBS 28 mit eingebautem obs-websocket v5. Ältere OBS-Versionen brauchen das obs-websocket-Plugin separat. Besser direkt auf OBS 28+ updaten. Setup-Anleitung: OBS-Setup.

Was ist mit Streamlabs OBS / OBS Studio Classic / XSplit?

Streamlabs OBS (jetzt Streamlabs Desktop) unterstützt den obs-websocket ebenfalls: gleicher Port, gleiche Auth. XSplit hat keinen WebSocket-Server; dort funktionieren OBS-Sub-Actions nicht. Workaround für XSplit: Stream-Deck-Plugin oder HTTP-Trigger.

Läuft Streamer.bot auf macOS oder Linux?

macOS-Beta ab v1.1, einige Windows-only Sub-Actions (Streamlabs-Bridge, manche Hotkeys) funktionieren dort nicht. Linux läuft Community-getrieben über Wine oder als native Build. Für Production-Use auf Windows bleiben: am stabilsten getestet.

Warum funktioniert mein Bot-Account nicht obwohl er verbunden ist?

Drei häufige Ursachen:

Bot ist kein Mod im eigenen Chat → /mod NameDeinesBots im eigenen Twitch-Chat.
Bot-Account wurde mit dem Browser-Profil deines Streamer-Accounts authentifiziert → in Platforms → Twitch → Bot Disconnect, dann Browser auf Inkognito + mit Bot-Login erneut verbinden.
Bot postet aber Nachrichten verschwinden → AutoMod oder R9K filtert. Bot-Account verifizieren (Telefonnummer in Twitch-Settings hinterlegen) hebt die meisten Filter auf.

Commands & Trigger

Mein Command feuert nicht. Was prüfe ich zuerst?

In dieser Reihenfolge:

Action ist enabled: Häkchen vor dem Action-Namen im Actions-Pane.
Trigger ist verknüpft: Action → Triggers-Tab → mindestens ein Command Triggered → !name.
Command-Source ist Twitch: Commands-Pane → Command → Sources: Twitch aktiv.
Bot ist mit Chat verbunden: Platforms → Twitch Status-Indikator grün.
Du bist nicht Cooldown: 10 Sekunden warten oder in Commands-Pane Cooldown temporär auf 0.

Wenn die Logs unten Action triggered zeigen, aber im Chat nichts ankommt: Sub-Action prüfen, Bot-Verbindung prüfen. Detailliertes Debug-Pattern: Was tun wenn nichts passiert.

Command feuert auf zufällige Wörter in normalen Chat-Nachrichten

Location: Anywhere ist aktiv. Im Commands-Pane den Command öffnen → Location auf Starts with umstellen. Anywhere ist nur für Keyword-Detection sinnvoll, nicht für normale Commands.

`%user%` wird im Chat als Text gepostet statt als Name

Die Variable wurde nicht aufgelöst. Häufige Ursachen:

Tippfehler in der Sub-Action: muss exakt %user% sein (mit Prozent vor und nach).
Command ist nicht über Command Triggered-Trigger angesprungen, sondern über Chat Message: dann existiert die Variable nicht. Trigger-Typ in der Action prüfen.
Du nutzt %userName% statt %user%: beide existieren, aber Casing unterscheidet sich; Liste in der Variablen-Referenz.

Welche Variablen setzt der Command-Trigger automatisch?

Mindestens: %user%, %userName%, %userId%, %userType%, %message%, %rawInput%, %input0%, %input1%, …, %targetUser% (wenn @user im Input). Komplette Liste mit Beispielen: Variablen-Referenz.

Wie speichere ich Werte zwischen Sessions?

Mit Persisted Globals. Sub-Action Core Globals Global (Set) mit Häkchen Persisted. Werte überleben Streamer.bot-Restart. Ohne Häkchen ist der Wert nach Restart weg. Pattern-Details: Globals.

Counter-Reset: wie setze ich User-Globals zurück?

In Streamer.bot UI: Servers/Clients → Persisted Globals oder User Globals öffnen, Einträge manuell löschen. Per Sub-Action: Core Globals Clear Non-Persisted Globals oder selektiv Clear All User Globals. Vorsicht: Clear-Sub-Actions sind irreversibel. Backup vorher empfohlen.

Permissions & Moderation

Meine Mod-Permission funktioniert nicht. Moderatoren werden abgelehnt

Wahrscheinlich hast du im Command unter Permissions → Allow Häkchen gesetzt aber keine Group selektiert. Wenn Allow aktiv ist ohne Groups, darf niemand außer Broadcaster den Command nutzen. Fix: entweder Moderators-Group selektieren oder Allow deaktivieren und stattdessen Deny → Viewers nutzen.

Mehr Patterns: Permissions-Setup.

Mods werden vom Cooldown ausgebremst: kann ich das abschalten?

Nur der Broadcaster ist von Cooldowns ausgenommen. Mods nicht. Wenn du Mods exemptieren willst: zweiter Command-Eintrag mit Permissions Moderators und Cooldown 0, plus erster Command mit Permissions Viewers und normalem Cooldown.

Custom-Groups syncen nicht zwischen zwei Streamer.bot-Installationen

Korrekt. Groups sind lokal in der SB-Datenbank. Wenn du auf einem zweiten PC weiterarbeitest, Groups manuell anlegen. Workaround: Streamer.bot-data/-Ordner per Cloud-Sync (Syncthing, manuell) übertragen. Aber nicht während SB läuft.

OBS-Integration

OBS-Verbindung schlägt fehl

Reihenfolge:

OBS läuft?: obs64.exe muss aktiv sein.
WebSocket-Server aktiviert?: In OBS Werkzeuge → obs-websocket-Einstellungen → Server aktivieren.
Port korrekt?: Standard 4455. In SB unter Platforms → OBS Studio → Port denselben Wert.
Passwort korrekt?: Aus OBS-Settings exakt kopiert. Kein zusätzliches Leerzeichen.
Firewall?: Windows-Defender blockt eventuell obs64.exe. Eingehende Regel für Port 4455 erlauben.

Scene wechselt im SB-Log aber OBS reagiert nicht

OBS-Verbindung ist nicht aktiv. Im OBS-Connection-Pane in SB Status prüfen. Bei Disconnected: Reconnect-Button.

Wie blende ich eine Source temporär ein für 5 Sekunden?

Sub-Action Source Visibility → Set (true) + Core > General > Delay (5000 ms) + Source Visibility → Set (false). Pattern-Details: Source-Toggle via Reward.

APIs & externe Daten

`Fetch URL` Sub-Action schlägt fehl mit “Unable to send POST”

Fetch URL unterstützt nur GET-Requests. POST/PUT/DELETE gehen nicht. Workarounds: API mit GET-Endpoint suchen, oder Execute Code Sub-Action mit C#-HttpClient (außerhalb des Scopes dieses Cookbooks).

API antwortet, aber `%apiResponse%` ist leer

Parse JSON Response ist nicht aktiviert. In der Sub-Action Fetch URL → Settings Häkchen bei Parse JSON Response setzen. Danach sind die Felder als %apiResponse.feldname% zugänglich. Setup-Details: Fetch-URL-Setup.

Twitch-Chat schneidet meine API-Antwort ab

Twitch-Chat limitiert auf 500 Zeichen. Wenn die API-Response länger ist, kürze in der Sub-Action Set Argument mit Substring 0 480 oder picke nur das relevante Feld statt die ganze Response zu posten.

Daten & Privacy

Wo werden meine Daten gespeichert?

Alle Settings, Actions, Persisted-Globals und Quotes liegen lokal in deinem Streamer.bot-data/-Ordner. Nichts wird in eine Cloud synchronisiert. Backups gehen über manuelles Kopieren des data/-Ordners (bei laufendem SB nicht: vorher schließen).

Ein Zuschauer fragt nach DSGVO-Löschung seiner Quotes / Counter

Quotes: SB → Servers/Clients → Quotes öffnen → manuell suchen + löschen. User-Globals: Servers/Clients → User Globals → User suchen → Einträge löschen. Per Sub-Action: Core Globals Global (Set) .

Werden Twitch-Chat-Nachrichten irgendwo geloggt?

Standardmäßig nein: Streamer.bot loggt nur Action-Trigger und Sub-Action-Schritte, nicht den Chat-Verlauf selbst. Wenn du Chat-Logs willst, brauchst du eine eigene Sub-Action die jede Message in eine Datei schreibt (oder externe Tools wie ChatLogger).

Performance & Stabilität

Wie viele Actions sind zu viele?

Praktisch unbegrenzt. Streamer.bot handhabt 500+ Actions ohne Probleme. Bei sehr großen Setups (1000+ Persisted-Globals, häufige API-Calls) die data/-Ordner-Größe und CPU im Auge behalten: selten Limit-Probleme.

Streamer.bot crasht beim Start oder bleibt hängen

Häufig: Logs-Ordner ist voll oder Settings korrupt. Lösung Schritt für Schritt:

SB komplett schließen (Taskmanager prüfen: kein Streamer.bot.exe-Prozess mehr).
data/logs/ Inhalt löschen.
SB neu starten: wenn jetzt OK, war’s der Log-Ordner.
Wenn weiterhin Crash: data/settings.json umbenennen zu settings.json.bak, SB starten. Wenn jetzt sauber startet, war’s die Settings.

Vor jeder Reparatur immer data/-Ordner sichern.

Verweise

Wofür sollte ich nicht selbst bauen sondern Tawmae nutzen?

Komplexe Overlay-basierte Features mit Polish und Wartung:

Loyalty-Points / Currency / Gamble-Mechaniken
Spotify-Now-Playing-Overlay mit Album-Art
Subathon-Timer mit Animation
Throne-Holder-Game
Better-Shoutouts mit Avatar-Overlay
Raffle / Giveaway mit Ticket-System

Details und Direkt-Links: Tawmae-Section (kommt mit S13).

Wo finde ich die offizielle Streamer.bot Doku?

docs.streamer.bot. Referenz aller Sub-Actions, Trigger und C#-API. Für UI-Klick-Tutorials ohne Code bist du hier richtig; für C#-Scripting und tiefe Sub-Action-Details ist die offizielle Doku besser.

Wo bekomme ich Hilfe wenn ich hier nichts finde?

Kanal	Wofür
Streamer.bot Discord	Live-Hilfe, große Community, schnelle Antworten
docs.streamer.bot	Offizielle Referenz
GitHub Issues	Fehler in diesem Cookbook melden
Discord von AzaCraft	Feedback zur Site, Cookbook-Wünsche