Reference
Mapping options
Every field on the event mapping form, grouped by what it controls.
The mapping form on the Events tab is split into When this happens and Do this. This lists every field in both halves.
VFINITYv1.5.0VTSTIK
When this happens
Event Type
Gift Name
RosePickMinimum gifts
10Do this
Action Type
VTS Hotkey
WaveDuration (seconds)
—Empty means permanent
Hold (s)
0How often it can run
Quantity Behavior
Count Mode
Count from all viewersMax Triggers
3Time Window (seconds)
10Rate limitAction Queue
Delay (ms)
0DashboardEventsThrowingOverlaySettings
When this happens
| Field | Applies to | Meaning |
|---|---|---|
| Event Type | All | Gift, Like, Follow, Share, Chat message, or API trigger |
| Gift Name | Gift | The gift to match. Use Pick to choose from the catalog so it matches on the gift's numeric id |
| Minimum gifts | Gift | How many have to arrive before the action runs |
| Minimum likes | Like | Likes arrive in bursts; this is the count that has to accumulate |
| Minimum count | Follow, Share | The threshold for those events |
| Trigger Text | Chat | The text to match against a comment |
| Match mode | Chat | Exact, Contains, or Starts with. Use Starts with for commands |
| Case sensitive | Chat | Off by default, and usually best left off |
| Trigger Name | API | Matched against the name field in your JSON payload, case-insensitively |
Do this
| Field | Applies to | Meaning |
|---|---|---|
| Action Type | All | VTS Hotkey, Move Model or VFX Preset |
| VTS Hotkey | Hotkey | Read live from VTube Studio, or entered by hand |
| VFX Preset Name | VFX | Must match the VTube Studio preset name exactly |
| Fade Time (seconds) | VFX | Crossfade length |
| Position X, Position Y, Size | Move | Where and how big |
| Transition (s) | Move | How long the move takes |
| Hold (s) | Move, Hotkey | How long it stays before returning or toggling off |
| Return to original position | Move | Sends the model back afterwards |
| Duration (seconds) | Hotkey, VFX | Empty means permanent. A number auto-switches it off |
| Delay (ms) | All | Waits before running |
How often it can run
| Field | Meaning |
|---|---|
| Quantity Behavior | For gift combos: Once per gift event, Repeat the action xN, or Extend the duration xN |
| Action Queue | On, the action waits its turn in one queue shared by every queued mapping. Off, it runs immediately |
| Count Mode | Count from all viewers accumulates a threshold across everyone. Count per viewer makes each viewer reach it alone |
| Max Triggers | The cap, when the rate limit is on |
| Time Window (seconds) | The window the cap applies over |
Extend the duration xN needs a duration or hold above zero. Vfinity refuses to save the mapping otherwise, because there is nothing to extend.
Managing the list
| Control | What it does |
|---|---|
| Search triggers | Filters the list by trigger name |
| Type filter | Narrows to one event type |
| Per-row toggle | Disables a rule without deleting it |
| Duplicate this mapping | Copies a rule so you can vary one field |
The list works with VTube Studio disconnected, marked Offline editing. Hotkeys have to be entered by hand in that state, since the live list comes from VTube Studio.