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 Phrases you define what the bot should react to (at least one phrase is required).

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).

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).
  • 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.
Triggers | ByteMate Docs