,filter
Switch each message filter on, set its threshold and choose the punishment.
How to use it
Type it in any channel where the bot can read messages. The prefix is , on this server and can be changed with ,prefixes.
,filter <channel> <role> <amount>
,filter spam enable,filter spam threshold 5,filter word add badword,filter links exempt @Staff,filter statusArguments
Square brackets are optional, angle brackets are required — the same legend ,help filter prints in Discord.
| Parameter | Kind | What it takes |
|---|---|---|
channel | required | a channel mention, name or id |
role | required | a role mention, name or id |
amount | required | a number |
Before you run it
What the command itself checks before it does anything, read from the src/commands/security/filter.js source.
- Permissions
- Manage Server
- Reads
- role, channel mentions
- Replies with
- a plain message, paginated when it runs long
- Cooldown
- 4s per member, per server
Every subcommand
Call the command with no argument inside Discord and the bot draws one page per subcommand, exactly like this.
| Subcommand | What it does |
|---|---|
,filter setup | turn the usual modules on with sane defaults |
,filter panel | post the filter panel with a button per module |
,filter status | show every module and whether it is on |
,filter list | every filtered word, link, invite and emoji limit |
,filter spam<enable|disable|threshold|exempt|unexempt> | catch repeated messages |
,filter word<add|remove|list|enable|disable> [word] | filter words you choose |
,filter mentions<enable|disable|threshold|exempt|unexempt> | cap how many members one message may ping |
,filter walloftext<enable|disable|threshold|exempt|unexempt> | catch very long messages |
,filter links<enable|disable|threshold|exempt|unexempt> | catch links |
,filter invites<enable|disable|threshold|exempt|unexempt> | catch Discord invites |
,filter emoji<enable|disable|threshold> | cap how many emoji one message may hold |
,filter exempt<@role|#channel> | spare a role or channel from every module |
,filter unexempt<@role|#channel> | put them back under the filters |
,filter punishment<none|delete|warn|timeout|kick|ban> | what happens when a filter trips |
,filter logs<#channel> | send detections to a channel |
In Discord
What a member sees when they run it. The reply is sent as a Components V2 panel on the server's accent colour, paginated when it is long.
More security commands
Commands that usually get used alongside ,filter.
Ready to put bleh in your server?
Add it in a couple of clicks, run ,setup, then fine-tune everything from the dashboard.