Documentation

AutoMod

AutoMod is a weighted, multi-signal system, not a simple list of banned words. Anti-Link, Anti-Swear, Anti-Mass-Mention, Anti-Spam, Anti-Ping, and bot raid detection all feed into one accumulating infraction score per member, so a pattern across different behaviors gets punished together instead of each violation being judged in isolation.

Weighted Infraction System

Different behaviors carry different weights (profanity is low, a bot raid pattern is very high), and points decay over time. The default punishment ladder:

PointsAction
0-1Delete message
2-31 minute timeout
4-55 minute timeout
6-710 minute timeout
8-1030 minute timeout
11-141 hour timeout
15-196 hour timeout
20-2412 hour timeout
25+Quarantine

Filters

Anti-Link

Detects Discord invites, external links, and suspicious or phishing-style URLs, with trusted-domain and trusted-media allowlisting so GIFs, MP4s, and links from Tenor, Giphy, and Klipy are never treated as suspicious.

Anti-Swear with Evasion Detection

Normalizes text before matching, catching homoglyph substitutions and common formatting tricks used to dodge word filters. Matched words are logged to the incident record for review.

Anti-Spam with FingerprintingEXCLUSIVE

Covers message-rate bursts (default: 5 messages in 2 seconds), repeated and near-duplicate messages, mention spam, and Zalgo abuse. Near-duplicate detection normalizes message structure.

Reach-Aware Anti-PingEXCLUSIVE

Ember estimates how many members a ping would actually reach. Pinging 3 people and pinging 80% of the server lead to very different outcomes, and large-enough reach can override the normal ladder to quarantine immediately.

Bot Raid Detection

Bot behavior is judged separately from human behavior. A bot producing a cross-channel mass-ping pattern (not just one bad message, but a correlated pattern across multiple channels, timing, and repeated activity) is classified as a raid and gets immediate containment, with a fallback to stripping dangerous roles if a ban isn't possible.

Admin Role-Stripping + Auto-RestoreEXCLUSIVE

Discord's administrator permission can block a clean timeout. When AutoMod needs to punish a compromised admin account, Ember snapshots their removable roles, strips them to make the timeout possible, applies it, then automatically restores every role once the timeout ends. The restore worker survives bot restarts and retries failures with backoff.

Shadow Mode

AutoMod supports a dry-run mode: it detects violations, calculates what it would have done, and logs the evidence, without actually punishing anyone. Use it to safely tune a new configuration before turning enforcement on.

Every meaningful incident records an incident ID, the detector and trigger type, confidence, evidence quality, active points, and the exact punishment selected, so you can see why AutoMod acted, not just that it did.

Whitelists exist at multiple levels: users, roles, channels, categories, and a dedicated settings-panel access list, all managed with &modwhitelist.

Command Reference

CommandSyntaxDescriptionPermissionsExample
&automod&automod or /automodOpens the interactive AutoMod Control Panel to toggle Anti-Link, Anti-Swear, Anti-Spam, Anti-Mention, Anti-Ping, and bot raid detection.Administrator or Bot Owner&automod
&modwhitelist&modwhitelist <target> or /modwhitelistExempts a user, role, channel, or category from AutoMod checks. Whitelisted actors are still monitored for machine-speed abuse.Administrator or Bot Owner&modwhitelist #announcements