Security
Automod
Filter words, links, invites and spam automatically.
Overview
The filter command group (alias f) is Solitary's word, link, invite and spam filter. It runs on every message and can warn, delete or punish members based on what it catches.
The older
automod / am command group is deprecated. It now only shows a migration notice, all configuration lives under filter instead.Word Filtering
| Command | Description |
|---|---|
filter add <word, word, ...> | Add one or more comma-separated words to the block list. |
filter remove <word, word, ...> | Remove words from the block list. |
| filter list | Show every custom blocked word. |
| filter blocked | Show which built-in categories are currently blocked. |
Short, purely alphabetic words are matched as exact words; longer or mixed words are matched anywhere inside a message to catch simple evasion.
Built-in Categories
| Command | Description |
|---|---|
filter invites <enable/disable> | Block Discord invite links. |
filter links <enable/disable> | Block links generally. Supports --allow gifs and --allow images flags to permit those specifically. |
filter spam [--strict] | Block repeated/spammy messages. |
| filter slurs | Toggle the built-in slur filter. |
| filter nsfw | Toggle the built-in NSFW-term filter. |
| filter swears | Toggle the built-in profanity filter. |
| filter harassment | Toggle the built-in harassment-language filter. |
| filter predatory | Toggle the built-in predatory-language filter. |
Punishments
| Command | Description |
|---|---|
filter state <true/false> | Turn the entire filter system on or off. |
filter punish <true/false> | Turn automatic punishment on or off (separate from message deletion). |
filter punishment <duration> | Set the punishment duration, e.g. 5m, 1h, 2d (minimum a few seconds, maximum 28 days). |
filter punishtype <type> | Set the punishment: jail, timeout/mute, striproles/strip, kick, or ban. |
filter log <channel> | Set the channel filter actions are logged to. |
Exemptions & Admins
| Command | Description |
|---|---|
filter whitelist add/remove <user> | Exempt a user from filtering entirely. |
filter exempt <channel/role> | Exempt a channel or role from filtering. |
filter unexempt <channel/role> | Remove an exemption. |
filter admin add/remove <user> | Grant or remove access to configure the filter. |
filter role add/remove <role> | Grant a role access to configure the filter. |
Monitoring
| Command | Description |
|---|---|
| filter show / status | Show the current filter configuration. |
| filter logs / incidents | Show recent filter actions. |
filter view <word> | Look up how a specific word is matched. |
| filter setup | Apply a sensible default configuration. |
| filter reset | Clear all filter configuration for the server. |