VTube Studio Integration Setup
VTube Studio mit Streamer.bot verbinden, damit du Avatar-Hotkeys, Expressions und Model-Wechsel automatisieren kannst.
Doku: docs.streamer.bot/guide/integrations/vtube-studio
Voraussetzungen
Abschnitt betitelt „Voraussetzungen“- VTube Studio auf gleichem PC oder im LAN
- VTube Studio API aktiviert (siehe unten)
- Streamer.bot ≥ v1.0.4
VTube Studio API aktivieren
Abschnitt betitelt „VTube Studio API aktivieren“- VTube Studio öffnen
- Settings (Zahnrad-Icon)
- Plugin Settings → “Start API” Toggle aktiv
- Default Port:
8001(kann angepasst werden)
Verbindung in Streamer.bot
Abschnitt betitelt „Verbindung in Streamer.bot“- Links Integrations → VTube Studio
- Felder:
| Feld | Wert |
|---|---|
| Host | localhost (oder LAN-IP wenn auf anderem PC) |
| Port | 8001 (default) |
| Auto Connect | aktiv |
| Auto Reconnect | aktiv |
- Connect klicken
- In VTube Studio: Authorize-Dialog erscheint → klicke “Allow”
Nach erster Authorization merkt sich VTube den SB-Plugin-Token. Bei künftigen Starts automatisch verbinden.
Verbindung testen
Abschnitt betitelt „Verbindung testen“Action [Test] VTS Connection:
1. Get Current Model (Integrations → VTube Studio → Get Current Model)2. Send Message: "VTS Model: %modelName%"Wenn der Model-Name im Chat erscheint → verbunden.
Sub-Actions im Überblick
Abschnitt betitelt „Sub-Actions im Überblick“| Sub-Action | Pfad |
|---|---|
| Trigger Hotkey | Integrations → VTube Studio → Trigger Hotkey |
| Trigger Hotkey by Name | Integrations → VTube Studio → Trigger Hotkey by Name |
| Set Expression State | Integrations → VTube Studio → Set Expression State |
| Load Model | Integrations → VTube Studio → Load Model |
| Load Model by Name | Integrations → VTube Studio → Load Model by Name |
| Move Model | Integrations → VTube Studio → Move Model |
| Color Tint | Integrations → VTube Studio → Color Tint |
| Reset All Color Tints | Integrations → VTube Studio → Reset All Color Tints |
| Get Current Model | Integrations → VTube Studio → Get Current Model |
| Send Raw Request | Integrations → VTube Studio → Send Raw Request |
Wichtige Konzepte
Abschnitt betitelt „Wichtige Konzepte“Hotkey: In VTS angelegte Tastenkombination/Aktion die was am Modell macht (z.B. “Wave”, “Laugh”, “Cry”). Hat einen Namen + optional einen ID.
Expression: Datei die Mimik/Pose definiert (z.B. surprised.exp3.json, angry.exp3.json). Kann an/aus.
Model: Komplettes Avatar-Set (Mesh, Texturen, Physics, Hotkeys, Expressions).
Use-Cases in dieser Sektion
Abschnitt betitelt „Use-Cases in dieser Sektion“| Use-Case | MD |
|---|---|
| Hotkey bei Twitch-Event (Sub/Follow/Bits) | hotkey-on-event.md |
| Expression-Toggle via Chat-Command | expression-toggle.md |
| Model-Wechsel als Channel-Point-Reward | model-load-reward.md |
Häufige Fallen
Abschnitt betitelt „Häufige Fallen“- API nicht aktiv: Streamer.bot zeigt “Disconnected”. Settings → Plugin Settings → Start API
- Port-Konflikt: wenn 8001 schon belegt, anderen Port in VTS und SB übereinstimmend setzen
- Authorization vergessen: beim ersten Connect IMMER manuell in VTS bestätigen. Sonst kein Zugriff
- Hotkey-Name case-sensitive?: Load Model ist case-INsensitive, andere Sub-Actions oft case-sensitive. Im Zweifel exakte Schreibweise aus VTS kopieren
- Multi-PC Setup: VTS auf Streaming-PC, SB auf Gaming-PC? Host
192.168.x.xsetzen, VTS-PC Firewall öffnen für 8001
Quellen
Abschnitt betitelt „Quellen“- VTube Studio Guide: docs.streamer.bot/guide/integrations/vtube-studio
- VTube Studio Website: denchisoft.com