Auto-Moderation

The Auto-Moderation module automatically filters messages based on configurable rules. Each filter works independently with its own thresholds and actions — no slash commands needed.

Enabling the Module

Enable the module

Dashboard → Your server → toggle Auto-Moderation

Configure filters

Click Edit to open the settings panel. Enable individual filters and configure thresholds.

Set up logging (optional)

In the Logs module, enable the Auto-Moderation log tile and select a channel.

Filters

Anti-Spam

Detects users sending too many messages in a short time window.

Option	Type	Default	Description
`max_messages`	number	`5`	Maximum messages allowed in the interval
`interval_seconds`	number	`5`	Time window in seconds

Anti-Flood

Detects repeated/duplicate messages from the same user.

Option	Type	Default	Description
`max_duplicates`	number	`3`	Maximum identical messages in the interval
`interval_seconds`	number	`30`	Time window in seconds

Caps Lock

Blocks messages with excessive uppercase characters.

Option	Type	Default	Description
`threshold_percent`	number	`70`	Minimum percentage of uppercase to trigger
`min_length`	number	`10`	Minimum alphabetic characters for the filter to apply

Mass Mentions

Limits the number of user/role mentions in a single message.

Option	Type	Default	Description
`max_mentions`	number	`5`	Maximum user + role mentions per message

Link Filter

Blocks URLs with an optional domain whitelist.

Option	Type	Default	Description
`allowed_domains`	string[]	`[]`	Domains that are never blocked (e.g. `youtube.com`, `github.com`)

Invite Filter

Blocks Discord invite links (discord.gg/..., discord.com/invite/...).

No additional configuration — just enable/disable and choose the action.

Actions

Each filter has an independent action setting:

Action	What happens
Delete only	Message is deleted silently
Delete + Warn	Message is deleted and a warning is recorded in the moderation system
Delete + Mute	Message is deleted and the user is timed out (configurable duration)

When Delete + Mute is selected, you configure the mute duration (1–1440 minutes) per filter.

Whitelist

Exempt Roles

Add roles to the whitelist — members with any of these roles bypass all automod filters.

Exempt Channels

Add channels to the whitelist — messages in these channels are never filtered.

Automatic Exemptions

The following are always exempt from auto-moderation:

Server owner
Members with moderation roles (configured in the Moderation module)
Bots

How It Works

Message sent
     ↓
Check: Is cog enabled for this guild?
     ↓
Check: Is author whitelisted? (role, channel, mod role, owner, bot)
     ↓
Run filters in order: spam → flood → caps → mentions → links → invites
     ↓
First violation triggers the configured action
     ↓
Log sent to configured automod log channel

Only the first triggered filter takes action — filters don't stack.

Logging

Actions logged by Logs under the automod category:

User who triggered the filter
Channel where it happened
Which filter was triggered
What action was taken
Preview of the deleted message

Dashboard Configuration

The dashboard panel shows:

Whitelist section at the top (exempt roles and channels)
Filter cards in a 2-column grid — each with toggle, thresholds, action selector, and mute duration

All changes use the UnsavedBar pattern — configure everything, then save once.

Tips

Recommended Setup

Start with Delete only action and monitor logs before enabling warns/mutes
Set Anti-Spam to 5 messages / 5 seconds as a baseline
Add common link domains to the whitelist (YouTube, Twitter, etc.) if you use the link filter
Exempt bot command channels from all filters

No Commands

Auto-Moderation is entirely event-based — it has no slash commands. All configuration is done through the dashboard.

On this page