,filter

Filters words, links, emotes, etc

User permissions: Manage Messages
Cooldown: none
Other surface: /filter · 19 slash subs vs 13 prefix
Anchor: #filter

Forms

Syntax

,filter <invites|links|words|mp3|mentions> on <channel|all> [++punish <punishment>]

/filter <subcommand>

<required> · [optional]

Example

,filter links on all ++punish ban

Subcommands

13 prefix subcommands

Read from the prefix .sub/ tree, the canonical shape. Every entry has a permanent anchor of its own.

,filter addaka a

filters out words

,filter add <word> [punishment] [++exact]

,filter add loser ban ++exact

#filter-add

,filter clearaka c, reset

clear filtered list

,filter clear

#filter-clear

,filter inviteaka invites

filters out invites

,filter invites on <channel/all> [++punish <punishment>]

,filter invites on aall ++punish ban

#filter-invite

,filter linkaka links

filters out all links

,filter links on <channel/all> [++punish <punishment>]

,filter links on all ++punish ban

#filter-link

,filter mentionaka massmention, mentions

filters out mass mentions in a channel

,filter mention on <channel/all> [++punish <punishment>] [++threshold <number>]

,filter mention on all ++punish ban ++threshold 7

#filter-mention

,filter mp3aka musicfiles, musicfile, mp3s

filters out all music files in a channel

,filter mp3 on <channel/all> [++punish <punishment>]

,filter mp3 on all ++punish ban

#filter-mp3

,filter removeaka r

removes word from filter

,filter remove <word>

,filter remove loser

#filter-remove

,filter test

Simulates the filters against text — deletes and punishes nothing

,filter test <text> [@member]

,filter test youre a loser @Nick

#filter-test

,filter typeaka types, t

list all types of filters

,filter type

#filter-type

,filter whitelistaka wl, exempt

exempts a user, a role, or staff, from some or all message filters

,filter whitelist <add|remove|scope|list|clear|on|off> <user|role|staff> [kind ...]

,filter whitelist add @Staff links,invites

#filter-whitelist

,filter wordaka words

filters out words/sentences in a channel

,filter words on <channel/all> [++punish <punishment>]

,filter words on all ++punish ban

#filter-word

Slash leaves

19 leaves

Read from the registered slash builder: groups are flattened, so a grouped leaf reads “group leaf” and anchors with a hyphen between the two words.

Two trees, not one view of one

This command registers 19 leaves on the slash surface against 13 subcommands in its prefix tree. Both lists are on this page in full; neither is a summary of the other.

/filter panel

Open the interactive filter management panel

#filter-panel

/filter add

Add a word to the filter

/filter addword*punishmentexact

Parameter	Type	Default	Detail
`word`required	String	—	Word to filter
`punishment`	String	—	Punishmentban · mute · jail · warn · stripstaff · kick
`exact`	Boolean	—	Whole-word match only, not a substring (e.g. "ass" no longer catches "class")

#filter-add

/filter remove

Remove a word from the filter

/filter removeword*

Parameter	Type	Default	Detail
`word`required	String	—	Word to remove

#filter-remove

/filter clear

Clear all filtered words

#filter-clear

/filter list

List all filtered words

#filter-list

/filter type

List filter types enabled

#filter-type

/filter test

Simulate the filters against text — deletes and punishes nothing

/filter testtext*member

Parameter	Type	Default	Detail
`text`required	String	—	Text to test
`member`	User	—	Simulate as this member instead of yourself

#filter-test

/filter invites

Toggle invite filter

/filter invitesmode*channel*punishment

Parameter	Type	Default	Detail
`mode`required	String	—	on/offon · off
`channel`required	String	—	Channel ID or "all"
`punishment`	String	—	Punishmentban · mute · jail · warn · stripstaff · kick

#filter-invites

/filter links

Toggle link filter

/filter linksmode*channel*punishment

Parameter	Type	Default	Detail
`mode`required	String	—	on/offon · off
`channel`required	String	—	Channel ID or "all"
`punishment`	String	—	Punishmentban · mute · jail · warn · stripstaff · kick

#filter-links

/filter mp3

Toggle mp3/music file filter

/filter mp3mode*channel*punishment

Parameter	Type	Default	Detail
`mode`required	String	—	on/offon · off
`channel`required	String	—	Channel ID or "all"
`punishment`	String	—	Punishmentban · mute · jail · warn · stripstaff · kick

#filter-mp3

/filter mention

Toggle mass-mention filter

/filter mentionmode*channel*punishmentthreshold

Parameter	Type	Default	Detail
`mode`required	String	—	on/offon · off
`channel`required	String	—	Channel ID or "all"
`punishment`	String	—	Punishmentban · mute · jail · warn · stripstaff · kick
`threshold`	Integer	—	Mention threshold

#filter-mention

/filter words

Toggle word filter

/filter wordsmode*channel*punishment

Parameter	Type	Default	Detail
`mode`required	String	—	on/offon · off
`channel`required	String	—	Channel ID or "all"
`punishment`	String	—	Punishmentban · mute · jail · warn · stripstaff · kick

#filter-words

/filter whitelist addgroup whitelist

Exempt a user, a role, or staff, from filters — give exactly one

/filter whitelist adduserrolestafffilters

Parameter	Type	Default	Detail
`user`	User	—	User to exempt
`role`	Role	—	Role to exempt
`staff`	Boolean	—	Exempt everyone holding a staff role (,staff add)
`filters`	String	—	Filter kinds to exempt, blank for every filterautocompletes as you type: no fixed list

#filter-whitelist-add

/filter whitelist removegroup whitelist

Remove a user, role, or staff, from the whitelist

/filter whitelist removetarget*

Parameter	Type	Default	Detail
`target`required	String	—	User, role, or staff, to removeautocompletes as you type: no fixed list

#filter-whitelist-remove

/filter whitelist scopegroup whitelist

Change which filters an existing entry bypasses — give exactly one target

/filter whitelist scopeuserrolestafffilters

Parameter	Type	Default	Detail
`user`	User	—	User to rescope
`role`	Role	—	Role to rescope
`staff`	Boolean	—	Rescope the staff entry
`filters`	String	—	Filter kinds to bypass, blank for every filterautocompletes as you type: no fixed list

#filter-whitelist-scope

/filter whitelist listgroup whitelist

List the whitelist

#filter-whitelist-list

/filter whitelist cleargroup whitelist

Clear the whitelist

#filter-whitelist-clear

/filter whitelist ongroup whitelist

Turn the whitelist back on

#filter-whitelist-on

/filter whitelist offgroup whitelist

Suspend the whitelist — every entry stops being honoured

#filter-whitelist-off