Actions
The three things an event mapping can do to your VTube Studio model, and the fields each one takes.
Every event mapping ends in one action. All three need VTube Studio connected and authenticated.
Throwing is not on this list. It is configured on the Throwing tab and does not use event mappings at all.
Trigger a hotkey
Presses a hotkey you have defined in VTube Studio.
| Field | Meaning |
|---|---|
| VTS Hotkey | Picked from a list read live from VTube Studio. If the list is empty, either Vfinity is not connected or the loaded model has no hotkeys |
| Duration (s) | Leave empty for a permanent toggle, or set seconds to fire the hotkey again afterwards and toggle it off |
| Hold (s) | Holds the action queue for this long, then triggers the hotkey again |
Hold holds the queue, not the animation. A VTube Studio animation may finish sooner than the hold, and the hotkey still fires again at the end of it.
You can also enter a hotkey id or name by hand, which is useful when you are configuring Vfinity with VTube Studio closed.
Move Model
Moves the model to a position and size, then optionally puts it back.
| Field | Meaning |
|---|---|
| Position X, Position Y | Where the model moves to |
| Size | The model's scale at the destination |
| Transition (s) | How long the move takes |
| Hold (s) | How long it stays there before returning |
| Return to original position | Sends the model back afterwards. Usually what you want for a reaction |
Without Return to original position, the move is permanent until something else moves the model. That is occasionally what you want, and much more often a surprise.
VFX Preset
Switches VTube Studio to one of its post-processing presets.
| Field | Meaning |
|---|---|
| VFX Preset Name | Has to match the preset name in VTube Studio exactly |
| Fade Time (seconds) | How long the crossfade takes |
| Duration (seconds) | Leave empty to stay on the preset, or set seconds to switch back |
Fields shared by all three
| Field | Meaning |
|---|---|
| Delay (ms) | Waits this long before running. Useful for lining up with a sound in OBS |
| Action Queue | On means the action waits its turn in one shared first-in, first-out queue across every queued mapping. Off means it runs immediately |
| Quantity Behavior | For gift combos: once, repeat the action, or extend the duration |
Extend the duration needs a duration or hold above zero. Vfinity refuses to save a mapping that asks to extend nothing.
Body-part reactions
The Throwing tab has its own reaction setting per body part, offering the same three actions. It runs when something lands on that hitbox, with its own cooldown. It is configured separately from event mappings and does not appear on the Events tab.