Trigger Words

The trigger words feature allows moderators to set specific words or phrases that, when used in the server, will trigger a notification. This notification includes a ghost ping to all moderators and a direct message to them with the message content and a jump link.

Setup

1. Add a trigger word: ;triggerword add badword

2. (Optional) Remove a trigger word: ;triggerword remove badword

3. View all trigger words: ;triggerword list

Example Use Case: A server wants to monitor when users mention a competitor's server name, "RivalServer".

1. Run ;triggerword add RivalServer

2. When a user mentions "RivalServer" in chat, all moderators receive a ghost ping and a DM alert with the message link.

Configuration

• triggerwords: A list of words or phrases that will trigger a notification when used in a message. The system is case-insensitive.

Available Variables (for internal logging/DM alerts - implied):

• {word} - The trigger word used.

• {user} - The user who used the word.

• {channel} - The channel where the word was used.

• {jump_link} - A link to the message.

Common Issues:

• Moderators are not receiving DMs → Ensure the moderator has DMs enabled for the bot.

• Ghost pings are not working → Ensure the bot has Send Messages permission in the channel where the word was used.

• Too many alerts are sent → The system has a 5-minute cooldown per word per channel to prevent spam.

Usage

When a message containing a configured trigger word is sent:

1. All users with the Manage Messages permission will receive a ghost ping in the channel.

2. Each of these moderators will also receive a direct message containing the full message content, the author, and a jump link to the original message.

There is a 5-minute cooldown per word to prevent spamming notifications.

Related Commands

• ;triggerword - Main command for managing trigger words.