/antispam settings
Overview
/antispam settings opens an interactive dashboard for detecting and punishing message spam, including flood, duplicate messages, excessive caps, gibberish, and blocked words.
Required Permissions
- Administrator
Subcommands
settings
No options. Running the command opens a dashboard with five pages: Overview, Limits, Punishment, Allowlist, and Other.
Dashboard settings
The dashboard is split into five pages: Overview, Limits, Punishment, Allowlist, and Other.
Overview page
A master toggle turns anti-spam on or off. Below it, detection toggles turn individual checks on or off:
| Detection | Default | Catches |
|---|---|---|
| Flood | On | Sending messages too quickly |
| Duplicate | On | Repeated or copy-pasted messages |
| Spam pattern | On | Gibberish and random-character messages |
| Caps | On | Excessive uppercase ("shouting") |
| Long messages | On | Messages over the configured length |
| Ghost ping | On | Pinging a member then deleting the message quickly |
| Links | On | Link spam |
| External commands | On | Spam from other bots' commands |
Limits page
Four settings groups, each edited through a form:
- Core limits: message threshold before a warning (default 5), the time window that threshold applies to (default 5 seconds), and warnings allowed before punishment (default 3).
- Filters: minimum gibberish length to flag (default 8 characters), repeated-character threshold (default 8), and the message length that counts as "long" (default 800 characters, 100–32,000 allowed).
- Caps: minimum message length before the caps check applies (default 10 characters), minimum word count (default 3), and the percentage of uppercase characters that triggers it (default 70%, 10–100 allowed).
- Link and command limits: link count and time window before link spam triggers (defaults 5 links / 60 seconds), and the same pair for external bot commands (defaults 5 / 60 seconds).
Punishment page
Choose what happens when a member crosses the warning limit: mute (default), kick, ban, or quarantine (strips roles and applies a quarantine role).
- If mute is selected, choose a duration from presets (1 minute, 5 minutes, 15 minutes, 1 hour, 28 hours) or enter a custom duration up to 7 days.
- If quarantine is selected, choose the role to apply. BetterAntiSpam creates the role automatically if it doesn't already exist.
Allowlist page
- Add users, roles, or channels that are exempt from anti-spam checks.
- Add trusted domains that bypass link detection, entered as a comma or space-separated list.
Other page
- Edit the blocked-word list (comma-separated). Set how many blocked-word hits within a time window (default 5 within 60 seconds) trigger punishment.
Behavior
- A Reset all button restores every anti-spam setting to its default after a confirmation step.
- Anti-nuke and anti-raid share the same quarantine role setting as anti-spam. Changing it in one dashboard changes it everywhere.
- Only the admin who opened the dashboard can interact with it.