Reference
Throwing options
Every setting on the Throwing tab, by sub-tab, with what its numbers mean.
The Throwing tab has three sub-tabs. Most sliders sit behind the Advanced switch, which remembers where you left it.
Setup
Calibration
| Setting | Meaning |
|---|---|
| Show hitbox | Reveals the body-part hitboxes in the OBS browser source so you can line them up |
| Reanchor | Snapshots the current model pose as the calibration anchor |
| Reference image | A screenshot of your model, used here for alignment only. Never shown on stream |
| Opacity | How strongly the reference image shows in the editor |
Body parts
| Setting | Meaning |
|---|---|
| Add part | Draws one new hitbox |
| Add avatar preset | Adds head, body and feet in one go |
| Hitbox color | The colour of the box in the editor |
| Hit sound URL | Played when something lands on this part |
| Reaction on hit | A VTS hotkey, a VFX preset name, or a model move. Needs VTube Studio connected |
| Cooldown (ms) | Minimum gap between consecutive reactions for this part, so a combo cannot spam one hotkey |
| Face follow strength | 0 is static, 1 matches VTube Studio face tracking, 2 exaggerates it |
Auto-throw
| Setting | Meaning |
|---|---|
| Auto-throw gifts from TikTok LIVE | Throw an item for every incoming gift |
| Throw unmapped gifts too (generic sprite) | With gift mappings present, also throw gifts that match none of them. Off means only mapped gifts throw |
| Minimum diamonds to throw | Only throw gifts worth this many diamonds or more. 0 throws everything |
Minimum diamonds to throw applies to gift mappings as well as to auto-thrown gifts. Most gifts are 1 to 10 diamonds, so anything above about 10 quietly blocks nearly all of them.
Behaviour
| Setting | Meaning |
|---|---|
| Follow the VTube model | The hitbox tracks your model's position. Needs VTube Studio connected |
| Aim at the hitbox | Items arc toward the hitbox centre. Off gives a random diagonal throw |
| Model flinches on hit | Triggers a head bonk when an item lands |
| Knockback force | 100% is the default flinch, 0% is none |
| Send test throws to the OBS overlay only | Skips the in-app preview |
| Show the floor (debug) | Draws a visible floor bar. Turn it off before going live |
Gifts
Each gift mapping is one gift with its own look and feel.
| Setting | Meaning |
|---|---|
| Sprite URL | The image thrown for this gift |
| Spawn sound URL | Played when the item appears |
| Hit sound URL | Played when it lands |
| Scale, Weight | Per-gift size and mass |
| Spawn count | How many items one gift throws |
| Sound volume | Applies to the throwing sounds. At 0, everything is silent |
More options adds per-gift overrides, each off by default:
| Override | Meaning |
|---|---|
| Throw force | How hard this gift is thrown. Off uses the scene's throw speed |
| Aim at | A named body part, Random body part, or Auto (whole model) |
| Time on screen (s) | This gift's lifetime. Off uses the scene's |
| Comes in from | Left, Right, Both sides, or Above (drops down) |
| Spin | 0 no tumble, 1 normal, 3 fast |
Gifts are matched by TikTok gift id when set, falling back to a case-insensitive name match.
Physics
| Setting | Meaning |
|---|---|
| Throw style | Gentle, Normal, Chaos, or Custom once you change anything |
| Gravity | 0 floats, 1 Earth-like, 4 a heavy thud |
| Throw speed | High punches items across the screen, low gives a gentle arc |
| Bounciness | 0 sticks on contact, 1 is a full elastic bounce |
| Item size | Base scale, with a small random jitter per item |
| Scale size by diamonds | About 1.6x at 100 diamonds, 2.2x at 10,000, on a log curve |
| Lifetime (s) | How long items stay before fading |
| Keep items on screen (pile up) | Items never fade. This makes Lifetime do nothing |
| Enable floor | Items rest or bounce at the bottom instead of falling off screen |
| Floor bounce | 0 sticks, 1 is a trampoline |
| Enable walls | Invisible side walls keep items in frame |
| Burst combos | Expand the spawn count to match a gift's combo size |
| Burst max items | Caps a burst. Items past the cap are dropped |
| Burst stagger (ms) | Gap between items in a burst |
Diagnostics
Needs attention at the top of the tab lists every reason nothing is being thrown, each with a Fix button:
| Note | Cause |
|---|---|
| The scene is off | Enabled is switched off |
| No OBS source is receiving throws | The browser source is missing or the URL is stale |
| Nothing will throw yet | No gift mappings and auto-throw off |
| A diamond minimum is blocking gifts | Minimum diamonds to throw is above what your gifts are worth |
| A gift aims at a deleted body part | It falls back to the whole model |
| VTube Studio is not connected | Follow the VTube model cannot track, so the hitbox stays put |
| Only mapped gifts throw | Throw unmapped gifts too is off |
| Items pile up forever | Keep items on screen is on, so lifetime does nothing |
| A burst is capped | The gift spawns more items than Burst max items allows |
| Sound is muted | Sound volume is 0 |
| TikTok LIVE is not connected | No real gifts will arrive |