Event types
Every TikTok event Vfinity receives, what it carries, and which ones you can map.
Vfinity receives events from your TikTok LIVE room and from the trigger API. Some can start an event mapping; the rest feed the counters, leaderboards and overlay widgets.
Events you can map
These appear in the Event Type list on the Events tab.
| Event | Fires when | Threshold field |
|---|---|---|
| Gift | A viewer sends a gift | Minimum gifts |
| Like | Likes arrive. TikTok sends them in bursts, not one at a time | Minimum likes |
| Follow | Someone follows you | Minimum count |
| Share | Someone shares the stream | Minimum count |
| Chat message | A comment matches your trigger text | Match mode, not a threshold |
| API trigger | Your own tool sends a matching message | None |
Events Vfinity receives but does not map
These arrive from the bridge and drive the counters, feeds and leaderboards.
| Event | Carries |
|---|---|
| Room stats | The current viewer count |
| Subscribe | A new subscriber |
| Join | A viewer entering the room |
| Emote | An emote sent in chat |
| Treasure box | A treasure box event |
| Follower count | The room's follower total |
Gifts in detail
A gift event carries the gift's numeric id, its name, its diamond value, and a repeat count for combos.
Combos matter. When a viewer taps a gift ten times, TikTok streams partial updates and then a final event with the total. Vfinity acts on the final count and ignores the in-progress updates, so a combo fires your mapping once with the right number rather than ten times with the wrong ones.
Diamond value drives several things: the Minimum diamonds to throw gate, Scale size by diamonds, the points economy, and any diamond-based goal or ticker.
Colours in the event log
The Dashboard's event log and the overlay feeds colour events by kind, and the colours are themeable:
| Event | Token |
|---|---|
| Gift | --color-event-gift |
| Chat | --color-event-chat |
| Like | --color-event-like |
| Follow | --color-event-follow |
| Share | --color-event-share |
| Room | --color-event-room |
Simulating them
The Event Simulator on the Dashboard fires gifts, likes, follows, shares, chat, subscribe, join and room stats. Nothing has to be live.
Use it to check a mapping before your stream rather than after.