The Twitch Bits commands feature allows you create dedicated commands for when certain amounts of Twitch Bits are cheered.
Commands can be set up to either trigger when a specific amount of bits are cheered or when a range of bits are cheered. When bits are cheered in your channel, commands for specific amounts are checked first to see if any match. After that, commands with ranges are checked in order of increasing range amount. This can allow you to have multiple commands that overlap in both specific amounts and ranges, with priority being given to the smallest ones.
For example, let's say you have three commands in total:
Command A: Specific Amount: 50
Command B: Range: 40 - 60
Command C: Range: 1 - 100
If 50 bits are cheered, then Command A will be triggered because it matches the specific amount. If 51 bits are cheered, then Command B will be triggered because it is the smallest range that encompasses that amount of bits. If 80 bits are cheered, then Command C will be triggered because it is the last remaining range that is applicable.
Twitch Bits commands provide the following additional Special Identifiers:
- $bitsamount = The number of bits cheered
- $message = An optional message that the user can supply when cheering bits
- $messagenocheermotes = An optional message that the user can supply when cheering bits, but with all cheermotes removed.