Build an event
Pick a trigger, add the steps it runs, test it, and put it back if you delete it by mistake.
An event is a rule: when something happens on stream, Vfinity runs a list of
steps. A Rose can say thank you, a follow can play a sound, and !dance can
press a VTube Studio hotkey.
How an event is built
Every event has three parts. The trigger is what it waits for. The rules decide who can set it off and how often. The action steps are what happens.
One event covers every platform you connect. A gift event reacts to TikTok gifts, and to Twitch, Kick and YouTube events that count as gifts, such as a Super Chat.
Choose the Simple editor or a Blueprint
Events open in the Simple editor, where the steps form a list. For an event that has to decide for itself, turn on Blueprint mode on the Events tab and build it as a graph of nodes and wires instead.
A list of action steps that run in order, all at once, or one at random. This page covers it.
Nodes wired together, with branches, loops, math, text and variables. See Blueprint events.
Both kinds sit side by side in the list, with the same triggers and rules, and an event can switch between them.
Create an event
Open a new event
Click Events in the dock, then New Event. The editor opens beside the list; with Blueprint mode on, a Blueprint opens instead. To start from a ready-made event, click Recipes.
Choose the trigger
Under When this happens, open Event Type and pick what the event waits for. The fields below it change to match: a gift asks for a gift, a chat message asks for the text to look for.
Add the action steps
Under Do this, click Add a step and pick a step type, such as Speak text or VTS Hotkey. Fill in its fields. Add more steps the same way.
Save it
Click Add Mapping. The event appears in the list, switched on and ready.
Pick an event type and a step type. The fields change with them, as they do in the app.
An event you have not saved stays in the editor when you switch to another tab, so you can check a setting and come back. Vfinity won't save a step that is switched on but not set up; it names the step so you can finish it, switch it off or remove it.
Choose how the steps run
With two or more steps, Run the steps appears above the list.
| Choice | What happens |
|---|---|
| In order | One after another, each after its own delay. |
| All at once | Every step starts together; each still waits its own delay. |
| One at random | Vfinity picks one step by its Weight. Higher is picked more often, and 0 is never picked. |
Every step has Wait first (ms), a delay before it starts, and a switch to turn it off without deleting it. A Group step holds a small list of its own with its own run mode, so an event can play a sound and a hotkey together and then speak.
Arrange the steps
Drag a step by its grip to move it, or focus the grip and press Up or Down. Right-click a step for everything else: Duplicate, Move to top, Change to another step type, Add step below, or Delete.
Copy step and Paste step carry a step to another event or to a Quick Deck pad, with all its settings.
Test an event
Point at an event's row and click its play button, or right-click it and choose Test it now. The event runs at once, as a test, even past its rate limit. If nothing can run, because Vfinity is paused or the event is switched off, the Events tab says why.
A test run skips the event's rules. To check the whole path, rules included, send a pretend gift, like or chat from Event Simulator on the Dashboard.
VTube Studio closed?
You can still edit events. The Events tab shows Offline editing and offers the hotkeys VTube Studio last sent. Steps that don't need VTube Studio, like sounds and speech, still run while it is closed.
Turn events on and off
Each row has a switch. An event that is off stays in the list and does nothing. Duplicate makes a copy that starts switched off, so you can change it before it fires.
Right-click empty space in the list to turn every shown event on or off at once, or to show only one kind of trigger.
Delete an event, and undo it
Delete an event with the trash button on its row or its right-click menu. A notice appears with Undo, which puts the event back where it was, switched on or off as before, with all its steps.
Delete several in a row and each one gets its own Undo.