Word Filter

Deletes messages containing banned words or phrases, with a separate stricter list for substring matches and a guided first-run setup.

Setup

$wordfilter

Also $filterword. The first time it's run on a server, flagged messages are set to be deleted (the only mode available).

Every run of $wordfilter opens the status panel: Word Filter: On/Off and List Words buttons. Turning it off asks for confirmation first.

Managing words

$wordfilter add <word>
$wordfilter remove <word>
$wordfilter strict add <word>
$wordfilter strict remove <word>
$wordfilter strict list

Two separate lists. The main list matches on word boundaries (ass won't catch class). The strict list matches substrings anywhere, including inside other words - built for things you want caught no matter how they're embedded. Max 100 characters per word/phrase.

$wordfilter import merge
$wordfilter import overwrite
$wordfilter import merge strict
$wordfilter import overwrite strict

Attach a .txt file (one word per line, max 512KB) - merge adds to the existing list, overwrite replaces it entirely. Targets the main list by default; add strict at the end to import into the strict list instead. Same for /wordfilter import, which has an explicit list option (main/strict) rather than a trailing word.

$wordfilter clear

Wipes the main wordlist - asks for confirmation twice before doing it.

Settings

$wordfilter wildcard on/off
$wordfilter channelexcludeadd <#channel>
$wordfilter channelexcluderemove <#channel>
$wordfilter channelexcludelist

Wildcard mode (off by default) makes the main list match substrings too, the same way the strict list already does - e.g. bad would also catch baddd or thisisverybad. Turning it on effectively removes the distinction between the two lists. Excluded channels are skipped entirely, for both lists.

Letting other roles manage it

$addwftrole <@role>
$removewftrole <@role>

A separate, word-filter-specific trusted-role list (not the fakeperms system) - anyone with a trusted role can use $wordfilter and manage words without needing Manage Guild.