Import einer Action schlägt fehl

~5 Min

Was du lernst

• Import-String-Fehler debuggen: Version, Format, Connections
• Fehlende OBS/Twitch-Connections erkennen

Symptom

Du hast einen Import-String kopiert (aus diesem Cookbook, von einem Kollegen, aus einer Action-Sammlung) und drückst in Streamer.bot Import. Aber:

• Fehlerdialog Invalid import string
• Import läuft durch, aber Action erscheint nicht im Actions-Pane
• Import läuft durch, Action ist da, funktioniert aber nicht (Sub-Actions leer / falsch)
• Dialog This import requires connections that are not configured und du weisst nicht welche

Schnell-Check (30 Sekunden)

1. Den Import-String komplett kopieren: auch Zeichen ganz am Ende. Wenn du auf eine Webseite klickst und nur einen Teil markierst, fehlen oft Bytes.
2. In SB: Actions-Pane → unten rechts Import → den String kompletten einfügen → Import.
3. Wenn Fehler-Dialog kommt, exakten Wortlaut lesen: meist steht die Ursache drin.

Schritt-für-Schritt-Debug

1. String vollständig?

Import-Strings sind oft 1000+ Zeichen lang. Bei Copy-Paste aus Browsern können Bytes verloren gehen.

Test: String in einen Texteditor einfügen → Länge prüfen. Wenn die Doku 1247 Zeichen angibt und dein String hat 1180, fehlen welche.

Fix: Original-Source erneut öffnen, Copy-Button (falls vorhanden) statt manueller Selektion nutzen. Im Streamer.bot-Cookbook hat jeder Import-Container einen eigenen Copy-Button: der kopiert garantiert komplett.

2. Version-Mismatch

Streamer.bot v1.0.4-Imports laufen nicht in v0.x und umgekehrt. Sub-Action-Pfade haben sich geändert.

Erkennen: Fehler Sub-Action 'Twitch.Chat.SendMessageToChannel' unknown oder ähnlich.

Fix: Streamer.bot-Version prüfen (Hauptfenster → Hilfe → Info). Wenn zu alt: Update auf v1.0.4+. Import-String aus der Doku ist für v1.0.4+ gebaut.

3. Fehlende Plattformen / Connections

Wenn die importierte Action z.B. eine OBS Studio-Sub-Action enthält und du noch keine OBS-Connection in Platforms → OBS Studio angelegt hast, zeigt SB:

This action references OBS Studio. No OBS Studio connection is configured.
Configure one in Platforms → OBS Studio before this action can run.

Fix:

Sub-Action-Kategorie	Was vorher konfigurieren
Twitch	Twitch-Account in Platforms → Twitch verbunden
OBS Studio	OBS-Connection in Platforms → OBS Studio
Discord	Discord-Webhook in Servers/Clients → Discord
VTube Studio	VTS-Connection in Servers/Clients → VTube Studio
HypeRate / Pulsoid	Heart-Rate-Connection in Servers/Clients
Spotify	Spotify-Auth: wir verweisen auf Tawmae

4. Action importiert aber Sub-Actions sind leer

Manche Sub-Actions speichern Referenzen auf Connections (z.B. “diese OBS-Connection”). Wenn deine Connection einen anderen Namen hat als beim Export, kann SB die Referenz nicht auflösen.

Erkennen: Sub-Action-Editor zeigt leeren Account-Slot oder leeres Connection-Dropdown.

Fix: Jede Sub-Action manuell öffnen und Connection neu zuweisen.

5. Command-Eintrag fehlt

Imports beinhalten oft Action + Sub-Actions + Trigger, aber kein Command-Eintrag. Du musst den Command-Eintrag selbst im Commands-Pane anlegen und mit der Action verknüpfen.

Fix:

1. Commands-Pane → + Add Command.
2. Name + Trigger-Text wie in der Doku angegeben.
3. Sources, Cooldown setzen.
4. Save.
5. Action öffnen → Triggers-Tab → existierenden Command Triggered-Trigger editieren und den eben angelegten Command auswählen.

6. Action erscheint nicht in der Liste

Manche Imports landen in einer Group, die nicht expanded ist. Im Actions-Pane:

• Filter prüfen: All Groups aktiv?
• Such-Feld leeren.
• Group-Filter durchklicken: vielleicht ist die Action in _Imported oder Unsorted.

7. String ist kein SB-Import, sondern ein Sub-Action-Snippet

Ältere Tutorials geben manchmal nur Sub-Action-JSON, kein voller Action-Export. SB lehnt das ab mit Invalid root structure.

Fix: Originalquelle prüfen: gibt es einen kompletten Action-Export? Wenn nicht, Action manuell nachbauen.

8. Backup machen vor riskanten Imports

Vor dem Import einer fremden / unbekannten Action: data/-Ordner sichern (SB schließen, Ordner zippen). Wenn der Import etwas zerschießt, kannst du den Backup-Stand zurückspielen.

Im laufenden SB: File → Export Actions exportiert alle Actions als Bundle: auch ein sinnvolles Backup vor großen Imports.

Häufige Ursachen. Top 5

Ursache	Fix
String nicht komplett kopiert (fehlende Bytes am Ende)	Copy-Button des Cookbooks nutzen statt manuelle Selektion
Version-Mismatch (v0.x → v1.x)	SB auf v1.0.4+ aktualisieren
Connection (OBS/Discord/VTS) nicht konfiguriert	Vorher in Platforms / Servers/Clients anlegen
Command-Eintrag fehlt	Manuell im Commands-Pane anlegen + Trigger verknüpfen
Action liegt in Group die nicht sichtbar ist	Group-Filter prüfen, All Groups aktivieren

Wenn du selbst eine Action exportierst

Für sauberen Export an andere:

1. Action im Pane markieren → Rechtsklick → Export.
2. SB öffnet Dialog mit dem JSON-String.
3. Vor dem Weitergeben: sensitive Daten checken (API-Keys, Webhook-URLs, persönliche Pfade: sind nicht automatisch entfernt!).
4. Inkludierte Connections im Export anonymisieren (Sub-Actions öffnen, Connection-Referenzen auf “OBS-Default” setzen).
5. Import-String + Versions-Hinweis (getestet mit SB v1.0.4) mitliefern.

Verwandt

• Voraussetzungen: Installation
• FAQ: Daten & Privacy
• Import-Sammelseite: alle in diesem Cookbook verfügbaren Import-Strings im Überblick

Verwandt

• Command feuert nichtDebug nach Import.
• OBS-SetupOBS-Connection einrichten.
• InstallationTwitch-Auth einrichten.