AutoMod
MJ Bot's AutoMod system automatically detects and acts on rule-breaking messages so your moderators do not have to catch everything manually. Configure filters, set thresholds, and add custom auto-responses.
Commands
| Command | Description | Usage |
|---|---|---|
/automod setup | Run the interactive AutoMod setup wizard | /automod setup |
/automod settings | View the current AutoMod configuration | /automod settings |
/automod disable | Disable AutoMod entirely | /automod disable |
/autoresponse add | Add a custom auto-response trigger | /autoresponse add <trigger> <response> |
/autoresponse remove | Remove an auto-response trigger | /autoresponse remove <trigger> |
/autoresponse list | List all auto-response triggers | /autoresponse list |
/logs | Configure the AutoMod log channel | /logs [#channel] |
Dashboard Configuration
The AutoMod section of the dashboard gives you full control over every filter and setting.
Filters
Enable and configure individual filters with custom thresholds and actions.
| Filter | Description |
|---|---|
| Spam | Detects rapid message sending and duplicate messages |
| Links | Blocks messages containing URLs (with optional whitelist) |
| Caps | Flags messages with excessive capital letters |
| Mentions | Limits the number of user or role mentions in a single message |
Each filter supports the following actions when triggered:
- Delete the message
- Warn the member
- Mute the member for a specified duration
- Kick the member
Banned Words
Maintain a list of words and phrases that are automatically blocked. Messages containing any banned word are deleted instantly.
You can use wildcard matching for banned words. For example, adding *badword* will match any message containing that word as a substring.
Auto-Responses
Create automatic replies that trigger when a message matches a specific keyword or phrase. Auto-responses are useful for FAQs, fun interactions, or quick information.
Example:
| Trigger | Response |
|---|---|
!rules | Please read the rules in #rules |
hello bot | Hey there! How can I help? |
Features
Customizable Thresholds
Fine-tune each filter to match your server's needs:
- Spam filter: Set the number of messages within a time window that triggers detection (e.g., 5 messages in 3 seconds).
- Caps filter: Set the minimum message length and maximum caps percentage (e.g., flag messages longer than 10 characters that are over 70% caps).
- Mentions filter: Set the maximum number of mentions allowed per message.
- Links filter: Toggle between blocking all links or only links not on your whitelist.
Whitelist Channels and Roles
Exclude specific channels or roles from AutoMod enforcement. Members with whitelisted roles and messages sent in whitelisted channels bypass all filters.
Whitelists apply globally across all filters. If you need per-filter exceptions, manage them through the dashboard.
Auto-Response Triggers
Auto-responses support:
- Exact match -- Triggers only when the message matches the trigger exactly
- Contains -- Triggers when the message contains the trigger phrase anywhere
- Starts with -- Triggers when the message begins with the trigger phrase
Be careful with short or common trigger phrases in "contains" mode. They may fire more often than expected.