Throwing
Gifts fly onto your model, bounce off its body parts and make it react
When a viewer sends a gift, its picture arcs across your stream and lands on your VTube Studio model. Each body part it hits can play a sound and make the model react.
Try switching between Gentle, Normal and Chaos in the picture above. Everything on this page lives on the Throwing tab.
Put throws on your stream
Throws are drawn by their own OBS browser source. On the Throwing tab, make sure
the scene's switch is on, then click Copy URL and paste it into a new Browser
Source in OBS. The address ends in #throwing, for example
http://127.0.0.1:21424/#throwing.
If no OBS source is receiving throws, the Needs attention panel at the top of the tab says so. It lists every reason nothing is being thrown, each with a Fix where one exists.
Line the hitboxes up with your model
Show the hitboxes
On the Setup tab, under 1 · Calibrate, click Show hitbox. The OBS source draws the throwing zone and every body part over your model.
Add a reference picture
Under 2 · Reference Image, click Upload screenshot and choose a screenshot of your model from OBS. It is only used for lining things up here and is never shown on stream.
Drag the zone onto your model
In the preview, drag the dashed zone over your model and drag its corners to resize it. Then drag the body parts inside it into place.
Check the aim
Click Simulate gift send and watch where it lands. Click Hide hitbox when you are done, before you go live.
Add body parts
Under 3 · Body Parts, click + Part to add one, or + Avatar preset to add a head, body and feet in one go. Each body part has a Label, a Color for the preview, and its own reaction.
- Reaction on hit fires a VTube Studio hotkey, switches a VFX preset or moves the model for a moment. VTube Studio has to be connected.
- Hit sound URL plays a sound when an item lands there.
- Cooldown (ms) is the shortest time between two reactions on this part, so one big combo does not fire the same hotkey over and over.
- Face follow strength sets how closely the hitbox follows face tracking, from 0 (still) to 2 (exaggerated).
Keep the hitboxes on a moving model
With Advanced on, the Advanced Hitbox section can make the hitboxes follow your model, so a throw lands where the model is now and not where you calibrated it.
Follow the model
Turn on Follow the VTube model. VTube Studio has to be connected, and the throwing scene switched on.
Record its resting pose
With the model at rest where you lined the hitboxes up, press ⌖ Re-anchor to the current pose. The hitboxes now move and resize as the model does.
Follow your head too
Turn hitboxes with the model tilts the zone and every body part as the model turns. Follow head tracking moves them when you lean or tilt your head, which VTube Studio doesn't report as a model move. Both start on.
Head: sideways, Head: up and down and Head: tilt set how far the hitboxes move with your head, from -2 to 2. At 1 they move the built-in amount, and 0 ignores that direction. If they go the wrong way, slide below 0.
Under the re-anchor button, a live readout shows what VTube Studio is sending right now: the model's position, size and turn, and your head's position and tilt. If it says there is no live position, the hitboxes have nothing to follow, so connect VTube Studio and turn the throwing scene on.
The preview on the Throwing tab follows the live model too, the way the OBS source does. Press Show hitbox to calibrate, and the boxes hold still again so you can drag them.
Choose which gifts throw
On the Gifts tab, turn on Auto-throw gifts from your platforms to throw incoming gifts. Once you add a gift mapping, only mapped gifts throw, unless you also turn on Throw unmapped gifts too (with Advanced on).
Twitch, Kick and YouTube throw as well: cheers, Kicks, Super Chats, Super Stickers, gifted subscriptions and memberships, and reward redemptions count as gifts worth the diamonds you set in SettingsPoints, so one setup covers every platform.
Minimum diamonds to throw skips small gifts. Pick All gifts, a tier such as 10+ diamonds, or Custom…. It applies to your gift mappings as well as to auto-throw, and a Rose is 1 diamond, so keep it low.
Click + Mapping to give one gift its own throw. A mapping can throw from a pool of items, each with its own picture, sounds, size and how often it comes up, and a Miss chance makes some throws sail past. More options sets the throw force, what it aims at, the time on screen, the edge it comes in from and its spin. On impact chooses whether items Bounce, Stick to the model, Explode or Replace sprite, with optional particles and a decal.
The Item library keeps throwables you can share across gifts. Rename or replace an item once and every gift that throws it follows. Export saves items as a pack for another PC, and Import adds a pack to your library without replacing anything.
Pick a throw style
On the Physics tab, Throw style sets the physics in one click:
| Style | Feel |
|---|---|
| Gentle | Soft, floaty arcs that settle quickly. |
| Normal | Balanced throws, the default feel. |
| Chaos | Fast throws with large items and lots of bounce. |
Tune any slider yourself and the style reads Custom. Turn on Advanced to see every tuning setting, such as gravity, the floor and walls, and keeping items on screen.
Test without going live
| Button | What it checks |
|---|---|
| Simulate gift send | A gift through the real path: matching, size and sounds. |
| Simulate 10x combo | A combo, which throws only when it finishes. |
| Throw a shape (renderer only) | Drawing only, not gift matching. |
| Clear items | Removes every item from OBS and the preview, and stops a combo in flight. |
Throw from any event
Throwing is not only for gifts. The Throw items action step can throw a configured item, the viewer's avatar or a chat emote from any trigger, such as a chat command or a follow. See Action steps.
Pause and Panic
While Vfinity is paused, gifts throw nothing and a combo in flight stops. Panic
clears every item, and so does the throw.clear command from a hotkey.