Contribution Purchase

• Alert key: throne-contributionPurchase
• Source: Throne
• Event list label: Contribution Purchase

Default message template

{{username}} contributed {{amount}} {{currency}} toward {{itemName}} on Throne. {{message}}

Template variables

Use any of these in alert text, TTS, or chat templates. The same names appear under data.extraSettings.* when you subscribe via Overlay.on('alert').

Template variable	Overlay payload field	Description
{{username}}	data.extraSettings.username	The username of the sender
{{displayname}}	data.extraSettings.displayname	The display name of the sender
{{message}}	data.extraSettings.message	The message text sent by the user
{{itemName}}	data.extraSettings.itemName	No description available yet.
{{itemThumbnailUrl}}	data.extraSettings.itemThumbnailUrl	No description available yet.
{{amount}}	data.extraSettings.amount	The amount sent
{{currency}}	data.extraSettings.currency	The currency used
{{creatorUsername}}	data.extraSettings.creatorUsername	TikTok battle creator username
{{raw}}	data.extraSettings.raw	The raw data that comes in through the platform for the alert. This is useful for custom code when data is needed that we don't provide by default.

Example payloads

Each scenario below mirrors what Lumia emits in Overlay.on('alert', (data) => …).

$10

{
  "alert": "throne-contributionPurchase",
  "dynamic": {
    "value": 10,
    "currency": "USD"
  },
  "extraSettings": {
    "username": "lumiastream",
    "displayname": "lumiastream",
    "message": "Happy to contribute!",
    "itemName": "AirPods Max",
    "itemThumbnailUrl": "https://m.media-amazon.com/images/I/81jqUPkIVRL._AC_SX522_.jpg",
    "amount": 10,
    "currency": "USD",
    "creatorUsername": "lumiastream",
    "raw": ""
  }
}

Variation conditions

Dimensions you can branch on when configuring alert variations:

• RANDOM
• EQUAL_CURRENCY_NUMBER - Donation Amount is equal to
• GREATER_CURRENCY_NUMBER - Donation Amount is greater than or equal to
• EQUAL_VARIABLE

Related

• Alert Explorer - live preview of every alert
• Overlay Type Definitions - full AlertEvent TypeScript type