Pick gifts from the catalog
Browse the TikTok gift list by region, refresh it, and use it so gift matching works on ids rather than names.
Vfinity keeps a copy of the TikTok gift list with each gift's name, image and diamond value. You reach it from the Pick button anywhere a gift name is wanted: the event mapping form, the throwing gift mappings, and the event simulator on the Dashboard.
Why picking beats typing
When you choose a gift from the catalog, Vfinity stores its numeric id. Matching then happens on that id, which is exact.
Type the name instead and matching falls back to a case-insensitive name comparison. That works until TikTok shows the gift under a different name in a viewer's region, and then the mapping silently stops firing.
Pick from the catalog. It takes the same number of clicks.
Regions
Gift catalogues differ by country. Vfinity defaults to the US catalog and lets you change it.
Open the region picker from the gift selector and choose your country. The catalog reloads for that region.
If a gift a viewer sends is not in your selected region's catalog, Vfinity still receives the event; it just has no stored image or diamond value for it.
Refreshing
The catalog is fetched and cached, so it works offline and does not hit the network on every launch. TikTok adds gifts, so refresh it now and then.
Refresh gift list on the TikTok LIVE card, or the refresh button inside the gift picker, forces a new fetch. The picker shows when the list was last updated, and marks it as out of date once it has aged.
The picker also labels where each gift came from: from live for gifts seen on your current stream, from catalogue for the cached list, and built-in list for the small set that ships with the app.
Diamond values
Every gift has a diamond value, and several settings use it:
- Minimum diamonds to throw on the Throwing tab gates which gifts become physical objects
- Scale size by diamonds makes expensive gifts throw bigger items
- The points economy pays out per diamond
- Diamond-based goals and the diamond ticker count them
For scale: a Rose is 1 diamond. Most common gifts are between 1 and 10.