Wordlists (Banned Words)

REQUIRES: Manage messages

Filter.png

Banned word example

BanName.png

Banned word example with variables.

 

Banword/Unbanword

Bans a word by adding it to a specified wordlist. If no word list is specified, then banned words will be added to the "local" wordlist. You may upload a text file (.txt) with a list of words separated by a new line instead.

Command Descriptive Example

!banword word/phrase

!banword potato

 

- Bans the word and adds it to the "local" wordlist

!banword name ListName word/phrase

!banword name NaughtyWords nibba

 

- Unbans the word and adds it to the wordlist

!banword insert your regex here %regex

!banword b[il1]+t{2,}(er|a)' %regex

 

- Bans a custom regex

Regex is a complicated matter, which may result in unexpected filter behavior.

!unbanword word/phrase

 

 

 


!unbanword name ListName word/phrase

 

 

 

 


!unbanword id WordID#

 

 

 

!unbanword potato

 

- Unbans the word and removes it from the "local" wordlist

 


!banword name NaughtyWords nibba

 

 

- Unbans the word and removes it from the word list

 


 

!unbanword is 12345

 

- Unbans the word based on its unique ID number

 

Variables

Variable Description
%whole Only the exact match
%begin Only from the beginning of words
%end Only from the end of words
%case Case-sensitive (100% match only)
%mute Auto permanent mute
%mute # Auto mute for certain amount of minutes
%warn Auto warn
%kick Auto kick
%softban Auto softban
%ban Auto ban

%name

Only applies to names/nicknames

%regex

 

EXAMPLE:

!banword b[il1]+t{2,}(er|a)' %regex

Applies your given regex

 

EXAMPLE:

Blocks common variations of the word bitter

%notify


(REQUIRES: Notifications logging enabled)

Posts a log through the Notifications logging channel

%notifynd

 

(REQUIRES: Notifications logging enabled)

Posts a log through the Notifications logging channel

 

This will not delete the banned word.

You can filter usernames based on your banned words with !auto name which checks whenever someone joins your server or whenever a name is updated.
(Learn more)

 

Filter

Command Description
!filter ignore [invert] #channel url/invite/text/auto/activity

!filter ignore #general url

 

- Ignores url filters in the channel


!filter ignore invert #general text

 

- Ignores text filters in all channels except for #general

!filter recog [invert] #channel url/invite/text/auto/activity

!filter recog #general url

 

- Re-enables url filters in the channel


!filter recog invert #general invite

 

- Re-enables url filters in all channels except for #general

!filter view [ignores]

!filter view

 

- Displays currently active filters in the server


!filter view ignores

 

- Displays all currently active filter ignores in the server

!filter url/invite

!filter url

!filter invite

 

- Toggles the url or invite filter

 

 

Wordlist

Command Descriptive Example
!wordlist list

!wordlist list

 

- Displays the list of current wordlists in the server along with their info

!wordlist view name [serverid] [readable]

!wordlist view NaughtyWords 270438133584232449 readable

 

- Sends a list of banned words in an editable .json file

It is entirely optional to use a server ID and "readable" in the command. The server ID is primarily meant for cases in which the wordlist did not originate in your server, and that the wordlist is added to your server with the !wordlist add command.

Typing "readable" at the end of the command will output a .txt file instead of .json. This is easier for when you only want to look at it and not re-upload an edited version of the file.

!wordlist create ListName

!wordlist create NaughtyWords

 

- Creates a new wordlist with a name

It is possible to use an edited .json file, template can be found with !wordlist formfile, to ban words in bulk

!wordlist delete ListName

!wordlist delete NaughtyWords

 

- Deleted the wordlist form the server

!wordlist formfile

!wordlist formfile

 

- Sends a .json template for banning words in bulk when uploading a .json file

This is useful for when using the !wordlist create command.

!wordlist add/rem name serverid

!wordlist add NaughtyWords 270438133584232449

 

- Removes another server's non-locked wordlist to yours


!wordlist rem NaughtyWords 270438133584232449

 

- Removes another server's non-locked wordlist from yours

!wordlist merge/unmerge name serverid

!wordlist merge NaughtyWords 270438133584232449

 

-Merges another server's non-locked wordlist to yours


!wordlist unmerge NaughtyWords 270438133584232449

 

- Unmerges another server's non-locked wordlist from yours

 

 


Revision #18
Created Sun, Mar 29, 2020 11:38 AM by Tommyfoxy2
Updated Sat, Oct 23, 2021 11:40 PM by Fairy