Zum Inhalt

VTube Hotkey bei Twitch-Event

Avatar reagiert automatisch auf Twitch-Events: Sub → Wave, Bits → Dance, Follow → Smile.

Voraussetzung: VTube Studio verbunden (siehe setup.md) Patterns: Twitch-Event-Trigger + Trigger Hotkey by Name Sub-Actions: 1-3 pro Event

Hotkeys in VTube Studio anlegen

Bevor du Hotkeys triggern kannst, im VTube Studio:

  1. Hotkey-Tab öffnen (Schmetterling-Icon)
  2. Hotkeys für gewünschte Aktionen anlegen mit klarem Namen:
  3. Wave
  4. Dance
  5. Heart
  6. Smile
  7. Surprised
  8. Cry
  9. Pro Hotkey: Animation/Expression/Sound-Trigger zuweisen
  10. Save

Wichtig: exakte Namen merken — die brauchen wir in SB.

Action: [Event] Sub → VTube Wave

Trigger

Twitch → Subscriptions → Subscription

Sub-Action 1: Trigger Hotkey by Name

Pfad: Integrations → VTube Studio → Trigger Hotkey by Name

Feld Wert
Name Wave

Setzt %success% (bool).

Sub-Action 2: Send Message (optional)

Send Message: "💎 @%user% wurde gesubt — Avatar winkt zurück 👋"

Action-Tree

[Event] Sub → VTube Wave  (Trigger: Subscription)
├── 1. Trigger Hotkey by Name: Wave
└── 2. Send Message: "💎 @%user% wurde gesubt..."

Mehrere Events → Mehrere Hotkeys

Twitch-Event Hotkey Use-Case
Subscription Wave Begrüßung
Gift Subscription Heart Liebe an Gifter
Cheer (>500 Bits) Dance Großzügig = Tanz
Follow Smile Lächeln
Raid Surprised Überraschung
Hype Train Start Excited Hype-Modus

Pro Event eine eigene Action mit dem passenden Hotkey-Namen.

Beispiel: Bits-Cheer mit Range

[Event] Cheer → Dance (>500 Bits)

Trigger: Twitch → Chat → Cheer
        Min: 500
        Max: leer

Im Trigger-Dialog die Min/Max-Range setzen damit die Action nur bei großen Cheers feuert.

[Event] Cheer Dance
├── 1. Trigger Hotkey by Name: Dance
├── 2. Send Message: "🔥 %user% mit %bits% Bits — Dance-Time!"
└── 3. Delay 5000 ms
    + Trigger Hotkey by Name: ResetPose   (zurück in Idle)

Avatar tanzt 5s, dann zurück in normale Pose.

Erweiterung: Random Hotkey aus Pool

Für Vielfalt bei häufigen Events (Follow):

[Event] Follow → Random Hotkey
├── Group [Random]: Welcome Hotkeys
│   ├── Trigger Hotkey by Name: Wave
│   ├── Trigger Hotkey by Name: Smile
│   ├── Trigger Hotkey by Name: Bow
│   ├── Trigger Hotkey by Name: Thumbsup
│   └── Trigger Hotkey by Name: Heart
└── Send Message: "💜 @%user% folgt jetzt"

VTS zeigt zufällig eine der 5 Begrüßungs-Animationen.

Erweiterung: Hotkey via Chat-Command

User können Hotkeys triggern (mit Cooldown gegen Spam):

[Cmd] !wave
├── 1. Trigger Hotkey by Name: Wave
└── 2. (kein Send Message — Avatar-Bewegung reicht als Feedback)

Command-Settings: | Feld | Wert | |------|------| | Sources | Twitch Message | | Global Cooldown | 5 | | User Cooldown | 30 | | Permissions | (leer = alle) ODER Allow: Subscribers (nur Subs) |

Erweiterung: Hotkey via Channel-Point-Reward

Reward "Avatar tanzt" für 500 Channel-Points:

[Reward] Avatar Dance  (Trigger: Reward Redemption)
├── 1. Trigger Hotkey by Name: Dance
├── 2. Send Message: "💃 @%user% lässt den Avatar tanzen"
├── 3. Delay 8000 ms
└── 4. Trigger Hotkey by Name: ResetPose

Häufige Fallen

  • Hotkey-Name Tippfehler — %success% = false. Im VTS exakten Namen kopieren
  • Hotkey wechselt Pose dauerhaft — VTS-Hotkeys sind oft Toggle. Wenn du nach 5s zurück willst, expliziter Reset-Hotkey
  • Mehrere Hotkeys gleichzeitig — kann VTS verwirren. Delays einbauen
  • Multi-User-Spam — wenn 5 Subs gleichzeitig kommen, 5× gleichzeitig Trigger Hotkey. Action Queue mit Single-Concurrent verhindert Chaos

Quellen