Warning

This document is for Red's development version, which can be significantly different from previous releases. If you're a regular user, you should read the Red documentation for the current stable release.

Filter

This is the cog guide for the filter cog. You will find detailed docs about usage and commands.

[p] is considered as your prefix.

Note

To use this cog, load it by typing this:

[p]load filter

Usage

This cog is designed for “filtering” unwanted words and phrases from a server.

It provides tools to manage a list of words or sentences, and to customize automatic actions to be taken against users who use those words in channels or in their name/nickname.

This can be used to prevent inappropriate language, off-topic discussions, invite links, and more.

Commands

filter

Note

This command is locked to the mod role.

Syntax

[p]filter

Description

Base command to add or remove words from the server filter.

Use double quotes to add or remove sentences.

filter add

Syntax

[p]filter add [words...]

Description

Add words to the filter.

Use double quotes to add sentences.

Examples:
  • [p]filter add word1 word2 word3

  • [p]filter add "This is a sentence"

Arguments:

  • [words...] The words or sentences to filter.

filter channel

Syntax

[p]filter channel

Description

Base command to add or remove words from the channel filter.

Use double quotes to add or remove sentences.

filter channel add

Syntax

[p]filter channel add [words...]

Description

Add words to the filter.

Use double quotes to add sentences.

Examples:
  • [p]filter channel add #channel word1 word2 word3

  • [p]filter channel add #channel "This is a sentence"

Arguments:

  • <channel> The text, voice, stage, or forum channel to add filtered words to.

  • [words...] The words or sentences to filter.

filter channel clear

Syntax

[p]filter channel clear

Description

Clears this channel’s filter list.

filter channel list

Syntax

[p]filter channel list

Description

Send a list of the channel’s filtered words.

filter channel remove

Syntax

[p]filter channel remove <channel> [words...]

Description

Remove words from the filter.

Use double quotes to remove sentences.

Examples:
  • [p]filter channel remove #channel word1 word2 word3

  • [p]filter channel remove #channel "This is a sentence"

Arguments:

  • <channel> The text, voice, stage, or forum channel to add filtered words to.

  • [words...] The words or sentences to no longer filter.

filter clear

Syntax

[p]filter clear

Description

Clears this server’s filter list.

filter delete

Syntax

[p]filter delete [words...]

Tip

Aliases: filter remove, filter del

Description

Remove words from the filter.

Use double quotes to remove sentences.

Examples:
  • [p]filter remove word1 word2 word3

  • [p]filter remove "This is a sentence"

Arguments:

  • [words...] The words or sentences to no longer filter.

filter list

Syntax

[p]filter list

Description

Send a list of this server’s filtered words.

filter names

Syntax

[p]filter names

Description

Toggle name and nickname filtering.

This is disabled by default.

filterset

Note

This command is locked to the admin role.

Syntax

[p]filterset

Description

Base command to manage filter settings.

filterset ban

Syntax

[p]filterset ban <count> <timeframe>

Description

Set the filter’s autoban conditions.

Users will be banned if they send <count> filtered words in <timeframe> seconds.

Set both to zero to disable autoban.

Examples:
  • [p]filterset ban 5 5 - Ban users who say 5 filtered words in 5 seconds.

  • [p]filterset ban 2 20 - Ban users who say 2 filtered words in 20 seconds.

Arguments:

  • <count> The amount of filtered words required to trigger a ban.

  • <timeframe> The period of time in which too many filtered words will trigger a ban.

filterset defaultname

Syntax

[p]filterset defaultname <name>

Description

Set the nickname for users with a filtered name.

Note that this has no effect if filtering names is disabled (to toggle, run [p]filter names).

The default name used is John Doe.

Example:
  • [p]filterset defaultname Missingno

Arguments:

  • <name> The new nickname to assign.