Message Variables for Alerts and TTS
In the Text Format field (Show Alert) and the Voice Format field (Read Text / TTS), you can insert variables that get replaced automatically with data about the viewer who triggered the action.
For example:
Thanks {username} for the {giftname}, worth {coins} coins!
comes out as:
Thanks budi123 for the Rose, worth 5 coins!
General variables
Usable in Show Alert, Read Text (TTS), Simulate Keystrokes, and Execute Minecraft Command.
| Variable | Replaced with |
|---|---|
{username} | The viewer's TikTok username, without @ |
{nickname} | The viewer's display name |
{giftname} | The name of the gift sent |
{prize} | The prize won, for features that have one |
{repeatcount} | The gift combo repeat count |
{coins} | Total coin value of the gift, already multiplied by the combo |
{likecount} | Number of likes sent in one go |
{totallikecount} | Total likes for the whole live session |
{comment} | The viewer's comment text |
{submonth} | How many months the viewer has been subscribed |
Donation-only variables
Only populated for donation triggers (Saweria, Sociabuzz, Trakteer, Tako, BagiBagi, Sibagi, TipTap).
| Variable | Replaced with |
|---|---|
{nickname} | The donor's name |
{message} | The message the donor wrote |
{amount} | The donation amount |
Minecraft-only variable
| Variable | Replaced with |
|---|---|
{playername} | The player name set in the Connection menu. If left blank it becomes @a (every player on the server) |
Writing rules
- Type them exactly as shown in the table: all lowercase, inside curly braces, no spaces.
{username}works.{Username}and{ username }are not replaced. - A variable with no data is replaced with empty text, not an error. If your alert renders with a missing word, it's usually because that variable isn't relevant to the trigger, for example
{giftname}on a follow-triggered Activity. - You can use several variables in one sentence.
Testing without going live
Use the Simulator Panel in the Interaction Center. The Gift tab fills {giftname}, {coins}, and {repeatcount}. The Comment tab fills {comment}, and the Donation tab fills {message} and {amount}.
Ready-to-use examples
| Situation | Text Format |
|---|---|
| Gift alert | Thanks {nickname} for the {giftname} x{repeatcount}! |
| Gift TTS | Thank you {username} for sending {giftname} |
| Follow alert | Welcome {nickname}, thanks for following! |
| Subscribe alert | {nickname} has subscribed for {submonth} months! |
| Comment TTS | {nickname} says, {comment} |
| Donation alert | {nickname} donated {amount} - {message} |
| Like milestone | Total likes already at {totallikecount}! |