On User Message Trigger

Message triggers allow you to execute a custom command when a message matches a specific condition.

message triggers can detect different types of messages, such as messages starting with specific text, messages containing attachments, polls, mentions, Discord system messages, and more.

Example

How message triggers work

When creating a message trigger, you can choose how the message should be matched.

The available options are:

Starts with

The Starts with option triggers when a message begins with the specified text.

For example, if the trigger is:

!hello

and if the response code is

Hello $username!

The command will trigger when a message starts with !hello.

However, a message where !hello appears later will not trigger the command.

This is useful for traditional commands such as !help, ?report, or !hug.

Ends with

The Ends with option triggers when a message ends with the specified text.

For example, with the trigger:

good morning

and if the response code is

Good morning, $username!

The command will trigger when the message ends with good morning.

A message where the text appears in the middle will not trigger the command.

Contains

The Contains option triggers when the specified text appears anywhere in the message.

For example, using:

banana

and if the response code is

🍌 Banana detected!

will trigger whenever banana appears in the message.

The text does not need to be at the beginning or end of the message.

Advanced (Regex)

The Advanced (Regex) option allows you to use regular expressions for more advanced matching.

Regex is useful when a normal text match is not enough.

For example, the following expression detects a Discord user mention:

/<@!?\d{18,}>/

and if the response code is

You have mentioned $username[$mentioned]! 

This can detect mentions such as:

Regex can be used to create much more advanced message matching rules.

Contains attachment

The Contains attachment option triggers when a message contains an attachment.

This can be useful for creating commands that automatically react to images, files, videos, or other uploaded attachments.

For example:

The message does not need to contain any particular text.

Discord Pin Message

The Discord Pin Message option triggers when Discord sends a system message indicating that a message was pinned.

For example:

This can be useful for automatically responding when someone pins a message.

Discord Thread Created Message

The Discord Thread Created Message option triggers when Discord sends a system message indicating that a thread was created.

For example:

This can be useful for automatically responding to newly created threads.

Contains Sticker

The Contains Sticker option triggers when a message contains a sticker.
You can find the sticker id with $messageStickers, which can be used to get more information like name through $sticker

For example:

$sticker[$messageStickers;name]

This example will show you the sticker name.

Has User Mention/Ping

The Has User Mention/Ping option triggers when a message contains a mention of a Discord user.

For example:

The mention can appear anywhere in the message.

For example, all of these can trigger the command:

Forwarded Message

The Forwarded Message option triggers when a message contains a forwarded Discord message.

For example:

This allows you to create commands that react specifically to forwarded messages without needing to inspect their text.

Discord AutoMod Action Message

The Discord AutoMod Action Message option triggers when Discord AutoMod takes action on a message.

For example, when a user sends a message that violates an AutoMod rule:

The user who triggered the AutoMod action is considered the executor of the command.

This allows you to build custom responses or logging systems around Discord AutoMod actions.

Every Message

The Every Message option triggers for every message received by the bot.

It does not matter what the message contains.

For example, a command configured with Every Message could automatically respond to messages:

This can be useful for automatic responses, message logging, counters, or other systems that need to process every message.

Parameters

Message parameters are separated by spaces and can be accessed using the $message[] function.

For example, if a user sends:

!hug @user

The message is split into parameters:

• $message[1] → !hug
• $message[2] → @user

Each parameter is assigned a number based on its position in the message:

!hug hello world
 │    │     │
 │    │     └── $message[3]
 │    └──────── $message[2]
 └───────────── $message[1]

You can also use + to get a parameter and everything after it.

For example:

!announce Hello everyone, welcome!

• $message[1] → !announce
• $message[2] → Hello
• $message[2+] → Hello everyone, welcome!
• $message[3+] → everyone, welcome!

This is useful when you want to accept a message or sentence as a single parameter.

For example:

!hug @user
!report @user spam in the chat
!announce Hello everyone, welcome to the server!

For !report @user spam in the chat, you could use:

$message[2]  → @user
$message[3+] → spam in the chat

In short:

$message[1]  → first word
$message[2]  → second word
$message[3]  → third word
$message[n]  → nth word

$message[2+] → second word + everything after it
$message[3+] → third word + everything after it

Combining message conditions

The different trigger types are designed for different kinds of message detection.

For example:

Choose the simplest option that matches what you are trying to detect. Regex should generally only be used when the other matching options cannot accomplish the desired behavior.

Summary