Triggers

Triggers automatically react to specific words or phrases in chat and then send a predefined reply.

Dashboard overview

On this page you define triggers, control cooldowns and roles, and set the conditions for when a trigger is active.

Create a trigger

When creating one, give it a unique name, set the status, define the response, and configure global/user cooldowns. You can also choose whether it is active only online, only offline, or always, require a minimum amount of bits, and allow or exclude roles. Under Source you pick what the trigger reacts to: a chat message or a power-up.

Source: chat or power-up

• Chat is the default. Under Phrases you define what the bot should react to (at least one phrase is required).
• Power-up makes the trigger fire when a viewer redeems a specific power-up. You pick it from a list – your own custom power-ups plus the three built-in effects (gigantify an emote, celebration, message effect). There are no phrases here; the trigger matches the selected power-up directly.

For power-up triggers, Min. bits counts the cost of the power-up – useful for the built-in effects, where the viewer picks the price. Role settings (allow/exclude) are hidden here, because a power-up redemption carries no role information.

Power-up triggers require affiliate or partner status. If you switch an existing chat trigger over to power-up, its phrases are deleted.

Phrases (match)

For phrases you can choose match types like contains, exact, starts with, ends with, or RegEx. Partial word OK lets hello also trigger in helloworld, while Whole word requires a standalone word. With Case-sensitive, uppercase/lowercase matters.

RegEx

RegEx is for advanced patterns. Write the pattern without slashes, e.g. ^https?:// or hello|hi. The Case-sensitive option applies to RegEx too. Whole word only applies to normal matches, not RegEx. If a RegEx fails or is risky, the phrase is ignored.

Response text and variables

Your response can contain these variables: {user}, {login}, {channel}, {message}, {bits}. Outputs that look like commands are sanitized (e.g. no !command).

Power-up triggers add {title} (the power-up's name) and {input} (the viewer's input). {input} is only filled by a custom power-up that asks for input – it stays empty for the built-in effects. For power-up triggers, {message} holds the same text as {input}.

How execution works

• Phrases are matched against the message (whitespace is normalized).
• At most one trigger fires per message (the first hit in the priority list). The same applies per redemption for power-ups.
• More specific triggers are checked first (RegEx, exact, longer phrases, whole word).
• Command-like messages are ignored (e.g. !so).
• The bot's own messages are ignored.
• Dedupe: the same message is processed only once.

Notes

• /timeout and /ban cannot be used as responses here. Use word filters for that.