Reward: Avatar Model-Wechsel

~10 Min

Was du lernst

• Avatar-Modell per Channel-Point-Reward temporär wechseln
• Auto-Reset nach 5 Minuten mit Delay und Globals

Voraussetzungen

• VTube-Setup
• Rewards-Setup

Reward: Halloween Avatar

Pro

Lädt für 5 Minuten das Halloween-Model, danach Reset aufs gemerkte Default-Model. Mit Refund bei Fehler.

Patterns

If/Else Globals Send Message

Steps

7

Cooldown

0s/User

Cooldown

10 minglobal

Zugriff

Public

Voraussetzungen

VTube Studio mit SB verbunden: siehe VTube-Setup. Mindestens zwei Models in VTube verfügbar (Default + Variante). Reward in SB anlegen (siehe Rewards-Setup), sonst funktioniert Update Redemption Status nicht für den Refund.

Premium-Reward für Costume-Wechsel. Pattern: Default-Model in einem Global persistieren, gewünschtes Variant-Model laden, 5 Minuten Delay, automatischer Reset aufs gemerkte Default. Falls VTube den Wechsel ablehnt (Model gelöscht/umbenannt), bekommt der Viewer die Points via Refund-Pattern zurück.

Trigger setzt %user% Argument %user% Display-Name des Redeemers. Variablen-Doku und %redemptionId% Argument %redemptionId% Für Update Redemption Status. Variablen-Doku . Nach Load Model by Name steht das Resultat in %success% Argument %success% bool: false wenn das Model in VTube nicht existiert. Variablen-Doku .

Reward-Settings in SB

Feld	Wert
Title	Halloween-Modus für Avatar
Cost	5000
Prompt	Avatar wird 5 Minuten gespooky 🎃
Skip Request Queue	aktiv
Max Per Stream	2
Global Cooldown	600 (10 Minuten)

Action: [Reward] Halloween Avatar

Trigger: Twitch > Channel Reward > Reward Redemption mit Reward-Filter Halloween-Modus für Avatar.

1

Get Current Model

Integrations ›VTube Studio ›Get Current Model

Liest aktuellen Model-Namen: wird als Default fürs Reset gemerkt.

2

Global Set: originalModel sichern

Core ›Globals ›Global (Set)

Global Name	originalModel
Value	%modelName%
Persisted	aktiv

3

Load Model by Name. Halloween

Integrations ›VTube Studio ›Load Model by Name

Setzt %success%: false bei Tippfehler oder fehlendem Model.

Name	Halloween Costume

4

If/Else: Wechsel fehlgeschlagen

Core ›Logic ›If/Else

Input	%success%
Operation	Equals
Value	false

4a

Then

Update Redemption Status. Canceled

Twitch ›Rewards ›Update Redemption Status

Redemption ID	%redemptionId%
Status	Canceled

4b

Then

Send Message: Refund

Twitch ›Chat ›Send Message to Channel

Message	@%user% Avatar-Wechsel fehlgeschlagen, Points zurück.

4c

Then

Break

Core ›Logic ›Break

5

Send Message: Aktiviert

Twitch ›Chat ›Send Message to Channel

Message	🎃 @%user% hat den Halloween-Modus aktiviert. 5 Minuten Spooky!

6

Delay. Anzeigedauer

Core ›Delay ›Delay

Duration	300000 ms (5 Minuten)

7

Load Model by Name. Reset auf Original

Integrations ›VTube Studio ›Load Model by Name

Lädt das gemerkte Default-Model zurück.

Name	%originalModel%

Action-Tree

1. 1 Get Current Model (setzt %modelName%)
2. 2 Global Set: originalModel = %modelName% (Persisted)
3. 3 Load Model by Name: Halloween Costume
4. 4 If/Else: %success% Equals false
   1. Then 4a Update Redemption Status: Canceled
   2. Then 4b Send Message: "@%user% Avatar-Wechsel fehlgeschlagen..."
   3. Then 4c Break
5. 5 Send Message: "🎃 @%user% hat Halloween-Modus aktiviert..."
6. 6 Delay 300000 ms (5 Minuten)
7. 7 Load Model by Name: %originalModel%

Verwendungsbeispiele

Aktion	Resultat
Reward eingelöst, Halloween-Model existiert	Avatar wird 5 min Halloween, dann zurück
Halloween-Model umbenannt in VTube	%success% = false, Points zurück
2 Viewer redeemen gleichzeitig	Mit Concurrent = false queue’t sich der zweite Wechsel nach Reset des ersten

Edge-Cases

• Model-Name Tippfehler: VTube findet nichts, Sub-Action gibt success = false. Refund springt sauber.
• SB-Crash während 5-min-Delay: Avatar bleibt im Variant-Mode. Mitigation: System-Action [Sys] Stream Online → Load Default Model als Safety-Net beim nächsten Stream-Start.
• Mehrere Rewards parallel: ohne Queue-Setting (Concurrent = false) konkurrieren die Wechsel. Sichere Bank: Action-Queue mit Single-Concurrent.
• Default-Model später umbenannt: wenn der originalModel-Wert noch den alten Namen hält, scheitert der Reset. Get Current Model direkt vor Wechsel ist der Live-Snapshot, kein hardcodierter Wert.

Erweiterungs-Ideen

• User-Input-Variante: Reward mit User Input Required = aktiv. User schreibt Model-Namen ins Feld, Filter auf Allow-List anwenden.
• Random-Outfit: Random-Group mit mehreren Load-Model-Sub-Actions. Bei jedem Redeem zufällig ein Outfit.
• Tier-abhängige Models: bei Sub-Reward Tier-3-spezifisches Premium-Model laden via If/Else %subTier%.
• Outfit-of-the-Day: Variante ohne Auto-Reset, hält bis zur nächsten Einlösung.

Verwandt

• Expression ToggleMimik per Command.
• Webcam-Filter RewardOBS-Filter per Reward.
• Random ExpressionsZufällige Expression aus Pool.

Streamer.bot Import

Import-String folgt

Die Action ist 1:1 nach Anleitung oben nachbaubar.

Quellen

• Load Model by Name
• Get Current Model
• Update Redemption Status
• Refund-Pattern