Zum Inhalt

VTube Studio Integration Setup

VTube Studio mit Streamer.bot verbinden, damit du Avatar-Hotkeys, Expressions und Model-Wechsel automatisieren kannst.

Doku: https://docs.streamer.bot/guide/integrations/vtube-studio

Voraussetzungen

  • VTube Studio auf gleichem PC oder im LAN
  • VTube Studio API aktiviert (siehe unten)
  • Streamer.bot ≥ v1.0.4

VTube Studio API aktivieren

  1. VTube Studio öffnen
  2. Settings (Zahnrad-Icon)
  3. Plugin Settings → "Start API" Toggle aktiv
  4. Default Port: 8001 (kann angepasst werden)

Verbindung in Streamer.bot

  1. Links Integrations → VTube Studio
  2. Felder:
Feld Wert
Host localhost (oder LAN-IP wenn auf anderem PC)
Port 8001 (default)
Auto Connect aktiv
Auto Reconnect aktiv
  1. Connect klicken
  2. 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

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

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

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

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

  • 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.x setzen, VTS-PC Firewall öffnen für 8001

Quellen