Variations.
One event, different reactions. Variations let a single alert play a bigger version for a Tier 3 sub, a special look for a 1,000-bit cheer, or a unique design when someone buys a specific piece of merch.
How it works
An alert has a base design and any number of variations. Each variation has criteria that decide when it can fire, plus the changes it makes on top of the base (different colors, text, sound, animation, even different blocks).
When an event arrives, OverlayThing looks at every variation whose criteria match. The most specific match wins. If two are equally specific, a weighted chance picks between them. If nothing matches, the base design plays.
Criteria
Each variation has one or more criteria, combined with match all (every criterion must be true) or match any (at least one). A criterion is a field, an operator, and a value.
| Operator | Means |
|---|---|
| at least / at most | Numeric thresholds, like bits at least 1,000. |
| is / is not | Exact match, like tier is 3. |
| greater than / less than | Strict numeric comparison. |
| matches | A text pattern, like a username or message. |
| is one of | Matches any value in a list, like sub type is one of resub or gifted. |
| includes any / all / none | For lists such as merch collections or products in an order. |
What you can match on
| Alert | Fields you can match |
|---|---|
| Subscriber | Sub type (new, resub, gifted, prime), tier, months, gift count, whether it is gifted or anonymous. |
| Cheer | Bits amount, whether it is anonymous, whether it has a message. |
| Tip | Amount and currency. |
| Raid | Viewer count. |
| Channel Points | Which reward, the point cost, the message. |
| Merch | Order total, item count, collections and products in the order. |
Examples
- Tier 3 subs get a gold version with a different sound.
- Cheers of 1,000 bits or more roll out a bigger animation.
- A merch order that includes anything from your "Limited" collection plays a special alert.
Only play when a variation matches
By default the base plays whenever no variation matches. Turn on Only play when a variation matches (in the alert's Variations panel) and the alert stays silent unless one of its variations matches. This is how you fire an alert at only certain Hype Train levels (say, a variation for level >= 50) without it going off on every level. Off by default, so existing alerts are unchanged.
Persistent widgets can use variations as well, including thresholds on progress, so a goal bar can change look once it passes 50%.