# Censor

Censor plugin allows you to control if users can self-advertise or send blacklisted words. We will be going through all the properties after seeing and example, as usual:

When something triggers this module, the message is deleted and sent to the logs channel with the `CENSOR` tag in the include section.

```yaml
censor:
  whitelist_level: 40

  filter_invites: true
  invites_codes_whitelist:
    - 'minecraft'
    - 'aUNhdFD'
  invites_guilds_whitelist:
    - 'Guild ID 1'
  invites_channels_whitelist: []
  invites_roles_whitelist: []
  invites_users_whitelist: []
  invites_categories_whitelist: []

  filter_links: true
  links_domains_whitelist:
    - 'google.com'
    - 'twitch.tv'
  links_channels_whitelist:
    - 'Channel ID 1'
    - 'Channel ID 2'
  links_roles_whitelist: []
  links_users_whitelist: []
  links_categories_whitelist: []

  filter_tokens: true
  tokens_blacklist:
    - 'Token 1'
    - 'Token 2'
  tokens_channels_whitelist:
    - 'Channel ID 1'
    - 'Channel ID 2'
    - 'Channel ID 3'
  tokens_roles_whitelist: []
  tokens_users_whitelist: []
  tokens_categories_whitelist: []

  filter_words: true
  words_blacklist:
    - 'Word 1'
    - 'Word 2'
  words_channels_whitelist: []
  words_roles_whitelist: []
  words_users_whitelist: []
  words_categories_whitelist: []
```

**Level Whitelist:** here you set the level the module will affect to. If the user has [level](https://tp.tutoclub.xyz/configuration/modules/levels) 50 and censor is set to 40, the user won't activate the filter. It will only be triggered if the user has the same level or lower.

{% tabs %}
{% tab title="Invites" %}
**Filter Invites:** Whether Discord servers invites should be censored or not. It can be `true` or `false`.

**Invites Codes Whitelist:** list of specific invites that won't be deleted. Make sure you just put the invite code.

**Invites Guilds Whitelist:** list of servers which invites won't be deleted, this means that, if an X server is there, none of the invites belonging to it will be censored.

**Invites Channels Whitelist:** list of channels where this section of the module will be disabled. Any invite will be allowed.

**Invites Roles Whitelist:** list of roles that will be ignored.

**Invites Users Whitelist:** list of users that will be ignored.

**Invites Categories Whitelist:** whole categories where no invites will be censored.
{% endtab %}

{% tab title="Links" %}
**Filter Links:** Whether URLs that are not invites should be censored or not. It can be `true` or `false`.

**Links Domains Whitelist:** list of domains that will be ignored by TutoPro.

**Links Channels Whitelist:** list of channels where this section of the module will be disabled. Any URL will be allowed.

**Links Roles Whitelist:** list of roles that will be ignored.

**Links Users Whitelist:** list of users that will be ignored.

**Links Categories Whitelist:** whole categories where no links will be censored.
{% endtab %}

{% tab title="Words" %}
**Filter Words:** Whether blacklisted words should be censored or not. It can be `true` or `false`.

**Words Blacklist:** list of words that will be censored by the bot.

**Words Channels Whitelist:** list of channels where this section of the module will be disabled.

**Words Roles Whitelist:** list of roles that will be ignored.

**Words Users Whitelist:** list of users that will be ignored.

**Words Categories Whitelist:** whole categories where no words will be censored.
{% endtab %}

{% tab title="Tokens" %}
**Filter Tokens:** Whether blacklisted tokens should be censored or not. It can be `true` or `false`.

**Tokens Blacklist:** list of tokens that will be deleted.

**Tokens Channels Whitelist:** list of channels where this section of the module will be disabled. Any token will be accepted.

**Tokens Roles Whitelist:** list of roles that will be ignored.

**Tokens Users Whitelist:** list of users that will be ignored.

**Tokens Categories Whitelist:** whole categories where no tokens will be censored.
{% endtab %}
{% endtabs %}

{% hint style="info" %}

## What is the difference between words and tokens?

If it's your first time using one bot of this type, we understand your confusion.

### Words

Words are always **separated by one space** on each side. If `Hello` was a blacklisted word:

Hello I'm PhoDit -> Would be deleted.

Hello, I'm PhoDit -> Wouldn't be deleted.

### Tokens

Tokens can be anywhere inside a message. If `Hello` was a blacklisted token:

Hello I'm PhoDit -> Would be deleted.

Hello, I'm PhoDit -> Would be deleted.

I like sayingthetoken**Hello**lol -> Would be deleted.
{% endhint %}

{% hint style="warning" %}
Remember that words and tokens are case insensitive.
{% endhint %}