Choose action steps
What an event can do, from sounds and speech to VTube Studio, OBS, keys, webhooks and app commands.
Action steps are what an event does when it fires. Add as many as you need, up to 20, and mix them freely: a sound, a spoken line and a VTube Studio hotkey can all answer one gift.
Pick a step type
Under Do this in the event editor, click Add a step and choose a type.
| To… | Use |
|---|---|
| Say something out loud | Speak text |
| Play a sound, or one from a pool | Play sound |
| Show an image, GIF or video on stream | Show media |
| Throw items at your model | Throw items |
| Press a VTube Studio hotkey | VTS Hotkey |
| Change your model's look or pose | Expression, Colour tint, VTS item, Switch model, Parameter, Move Model, VFX Preset |
| Switch a scene or show a source in OBS | OBS |
| Press keys in another program | Press keys |
| Tell another app | HTTP webhook, Streamer.bot action |
| Pause between steps | Wait |
| Run a few steps as one | Group |
| Run anything Vfinity can do by name | App command |
Each step runs on its own. A step that doesn't need VTube Studio still runs while VTube Studio is closed, and a step that fails is reported without stopping the rest.
A Blueprint event runs the same steps from Action nodes, all except Wait and Group: a Delay node waits instead, and Sequence, Parallel and Random nodes do what a group does.
Speak and play sounds
Speak text reads a line in your text-to-speech voice. Write it with
placeholders, such as Thanks {name} for {count} {gift}!, and Vfinity fills
them in from the trigger. Characters per minute limits how much one event
can say each minute, across all viewers.
A spoken line follows the Events volume and speed set in SettingsAudioVoice. Turn on Own volume and speed to give one line its own Volume and Speed, such as a louder thank-you for a big gift.
Play sound holds a Sound pool of up to 10 files and picks one each time, by Weight. Play through sends it to This app only, OBS only, or OBS and this app.
Turn on Wait until finished on either step to hold the next step until it ends.
React with your model
VTS Hotkey presses a hotkey from the model loaded in VTube Studio. Set Duration (s) to press it again after that long, which turns a toggle back off.
The other VTube Studio steps work without hotkeys:
- Expression turns an expression on, off or toggles it, with a fade.
- Colour tint paints the whole model or chosen ArtMeshes, or runs a rainbow, and can reset after a few seconds.
- VTS item places an item from VTube Studio or an image of your own, optionally pinned to an ArtMesh.
- Switch model loads another model, and can switch back.
- Parameter moves a parameter on top of face tracking, or takes it over.
Put something on stream
Show media plays an image, GIF or video on your overlay. It appears in the Actions media widget, so add that widget to OBS as a browser source first; see Overlays.
Throw items throws at your model from any trigger: a configured item, the viewer's avatar, or a chat emote, up to 50 at a time.
OBS switches the scene, shows or hides a source, turns a filter on or off, or writes into a text source. Put back after undoes the change after a few seconds. See OBS control.
Reach other programs
Press keys sends a key combination to whichever program has focus. Turn it on first with Allow Events to press keys in SettingsAutomation & rulesKeyboard actions. Some games ignore simulated keys.
HTTP webhook sends a request to a web address, with placeholders in its JSON body. Streamer.bot action runs an action in Streamer.bot once it is connected; see Streamer.bot.
Control Vfinity itself
App command runs any command Vfinity offers: press a Quick Deck pad, add time to the timer, skip an alert, or run another event with Run an Events mapping. Events that set each other off stop after four hops, so a loop can never run forever.
Wait pauses for a set time, up to 10 minutes. Group holds a short list of its own with its own run mode, one level deep.
Example: a jackpot
The Jackpot recipe shows how steps combine. It fires on any gift worth 1,000 diamonds or more and runs three steps in order:
1. Play sound a fanfare you pick
2. Show media a clip you pick
3. Speak text WOW! {name}, thank you so much for the {gift}!Switch Run the steps to All at once and all three start together.
Reuse a step
Right-click a finished step and choose Copy step, then Paste step in another event or a Quick Deck pad. It arrives with every setting.