# Verfuegbare Aktionen

# Verfuegbare Aktionen

Das Chatlix-Plugin für Stream Deck stellt eine Reihe von Aktionen bereit, die du als Tasten belegen kannst. Jede Aktion hat eigene Konfig-Felder im Stream-Deck-Plugin und ruft serverseitig den entsprechenden Endpoint unter `/v1/streamdeck/`.

## Reward triggern

Führt einen Channel-Points-Reward auf deinem Twitch-Kanal aus — als wäre er von einem Zuschauer eingelöst worden. Nützlich zum Testen von Reward-bedingten Automations, oder um in einer Show-Situation gezielt ein Event zu zünden.

- **Konfig**: Reward-Auswahl (Liste deiner aktiven Rewards), optional User-Kontext (für Logs).
- **Cooldown**: Pro Button frei wählbar.
- **Nutzungs-Tipp**: Idealerweise für Test/Demo. Im laufenden Stream sollte das normalerweise der Chat machen.

## Automation starten

Löst eine deiner Automations direkt aus, ohne dass ihr normaler Trigger feuert. Hilfreich für Setup-Routinen („Stream-Start-Sequenz“) oder manuelle Spezial-Events.

- **Konfig**: Automation-Auswahl, optional Payload (JSON-Mini-Editor) für Variablen.
- **Verhalten**: Die Automation läuft ihren Action-Stack ab; Bedingungen werden normal ausgewertet.

## Overlay-Szene wechseln

Wechselt das angezeigte Layout in einem deiner Chatlix-Overlays. Funktioniert für Overlays, die mit dem Pro Editor gebaut wurden und mehrere Szenen haben (z.B. „Starting Soon“, „Gameplay“, „BRB“, „Ending“).

- **Konfig**: Overlay-Auswahl, Ziel-Szene.
- **Übergang**: Falls im Pro Editor konfiguriert, mit Fade/Cut-Animation.
- **Wichtig**: Das wechselt **die Chatlix-Overlay-Szene**, nicht OBS-Szenen. Wenn du parallel OBS-Szenen brauchst, kombinier mit der Stream-Deck-OBS-Aktion.

## Sound abspielen

Spielt ein Audio-Asset aus deiner Media Library in einem oder allen aktiven Overlays ab. Das ist die Standard-Soundboard-Aktion.

- **Konfig**: Asset-Picker (Library), Lautstärke 0–100%, Cooldown, Ziel-Overlay (alle oder einzelnes).
- **Cooldown-Hinweis**: Soundboard-Spam vermeiden, mindestens 1s Cooldown pro Button setzen.
- **API**: `POST /v1/media-engine/play` mit Asset-ID.

## StoryQuest-Choice setzen

Wenn gerade eine StoryQuest-Live-Session läuft, kannst du eine bestimmte Choice manuell setzen — z.B. um ein offensichtlich bevorzugtes Voting frühzeitig durchzudrücken oder um in einer Solo-Show selber die Story zu steuern.

- **Konfig**: Quest-Auswahl, Choice-Identifier (Builder zeigt dir die IDs).
- **Verhalten**: Setzt die Choice unmittelbar, beendet das laufende Voting, springt zum Ziel-Node.
- **Vorsicht**: Im Multi-User-Voting macht der manuelle Choice das Chat-Voting hinfällig. Nutz das mit Bedacht.

## Counter inkrementieren

Chatlix führt Counter-Variablen (z.B. „Tode in Dark Souls“, „Witze pro Stream“). Diese Action erhöht einen Counter um 1 (oder den konfigurierten Wert).

- **Konfig**: Counter-Auswahl, Inkrement (Standard +1).
- **Anzeige**: Counter sind im Overlay als Text-Widget einblendbar, der automatisch aktualisiert.
- **Reset**: Über `/dashboard/counters` oder eigene Aktion „Counter setzen“ (manchmal als zweite Action verfügbar).

## Hype-Train manuell starten (Test)

Löst lokal einen simulierten Hype-Train aus. Achtung: das ist **nur Test/Simulation** für die Anzeige im Overlay und für Reward-Trigger; es löst keinen echten Twitch-Hype-Train aus.

- **Konfig**: Hype-Train-Profil (Dauer, Stufen).
- **Verwendung**: Zum Testen, ob deine Hype-Train-Automations korrekt feuern.
- **Sicherheits-Hinweis**: Diese Aktion sollte nicht im Live-Stream gedrückt werden, sondern im Setup-Modus.

## API-Routen

Alle Aktionen werden vom Plugin gegen Endpunkte unter `/v1/streamdeck/` aufgerufen:

- `POST /v1/streamdeck/action/reward`
- `POST /v1/streamdeck/action/automation`
- `POST /v1/streamdeck/action/scene`
- `POST /v1/streamdeck/action/sound`
- `POST /v1/streamdeck/action/storyquest-choice`
- `POST /v1/streamdeck/action/counter`
- `POST /v1/streamdeck/action/hype-train-test`

Alle erwarten den Geräte-Token im Header und einen kleinen Payload mit der Aktions-spezifischen Config. Wenn du eigene Tools oder Hotkey-Setups bauen willst (nicht Stream-Deck-basiert), kannst du dieselben Endpunkte direkt aufrufen.

## Logs prüfen

Im Dashboard `/dashboard/streamdeck` gibt es eine Aktivitäts-Tabelle mit den letzten Aktionen: Zeitstempel, Aktion, Ziel, Ergebnis (ok/Fehler). Falls eine Aktion nicht wirkt, ist das die erste Anlaufstelle — typisch ist `PLAN_REQUIRED`, `TOKEN_INVALID` oder `TARGET_NOT_FOUND` (z.B. Reward inzwischen gelöscht).