# Moderation

## Automatic Moderation Settings

### General

{% hint style="info" %}
Each filter has its own settings.
{% endhint %}

### Punishments for Violations

You have three types of punishments to choose from: **Timeout**, **Kick**, **Ban**.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FydH4hilDZaTjbEtZMh3u%2Fopera_cEOjeR4wFd.gif?alt=media&#x26;token=1029d151-a98a-47f8-b874-cdbea7fde78d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can only set a duration for the "Timeout" type of punishment.
{% endhint %}

{% hint style="warning" %}
Time Format: \
d - days \
h - hours \
m - minutes \
s - seconds

Example: 21d15h9m20s \
The punishment will be applied for 21 days, 15 hours, 9 minutes, 20 seconds.
{% endhint %}

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FHq0LoYOl0TaTZexA3sIU%2Fopera_RIxoc8pPAo.gif?alt=media&#x26;token=1717d351-5cea-40df-adbe-7cabd08788ae" alt=""><figcaption></figcaption></figure>

#### Result:

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FDSfwRGuUvo4SzaeBfC8d%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5_2023-11-12_111354530.png?alt=media&#x26;token=bf517d89-15ab-44d5-a6d8-836aab95902a" alt=""><figcaption></figcaption></figure>

### Ignoring Channels

Imagine you have a dedicated text channel for sending links, and you don't want to apply any sanctions to users in that channel.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2Fmy24XxHltmarGj6lbudH%2Fopera_FPSOdGGTJN.gif?alt=media&#x26;token=44b75b17-bfcb-4f8f-80af-62e2febf1b20" alt=""><figcaption></figcaption></figure>

### Ignoring Roles

Imagine you have members with certain roles who should be allowed to send links, and you don't want to apply any sanctions to them.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2Fcsy84Wd2ya8yMx6glKeJ%2Fopera_wSMFcu5sFf.gif?alt=media&#x26;token=2b6829a1-8cde-4dd3-b16c-78dd9127d46f" alt=""><figcaption></figcaption></figure>

### Notify Member about Violation

Members may not understand what happened, so we recommend notifying them about violations they may not be aware of.

{% hint style="info" %}
There are two notification options:&#x20;

* The channel where the violation occurred.
* Direct messages.
  {% endhint %}

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FpoedkF3qaquHeGQZUrkK%2Fopera_WNWnhsMV0P.png?alt=media&#x26;token=cee9fea8-70ea-44c0-9ae1-38ca8c6f69ed" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
There is no default violation message, so you need to specify the text yourself.&#x20;

Both plain text and [JSON ](https://docs.asagi.xyz/guides/json-builder-in-the-asagi-bot)code are supported.&#x20;

[Variables](https://docs.asagi.xyz/other/message-templates/variables) are also available.
{% endhint %}

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2F5R7Oh0ldTn8kNb8eL9vC%2Fopera_uDwNWTaEMl.gif?alt=media&#x26;token=bb778e60-a2e2-4181-9d2a-ecfac3a67247" alt=""><figcaption></figcaption></figure>

## Automatic Moderation Filters

### Links

The default penalty type is "<mark style="color:yellow;">Timeout</mark>" for <mark style="color:yellow;">15 minutes</mark> when any link is found.

#### How does it work?

This filter reacts to messages containing any links.

You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2F6KMSELwsAocqlNNdazUu%2Fopera_oKG3Bn0UKu.gif?alt=media&#x26;token=55ee7815-66ae-4fe4-a755-9b08171b25c4" alt=""><figcaption></figcaption></figure>

#### How do I enable this filter?

To enable this filter, type the command <mark style="color:blue;">`/settings`</mark> and choose *Moderation*.&#x20;

In the dropdown menu, select "<mark style="color:yellow;">Links</mark>".

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FYdUY8UdohVOIbMWKBV8N%2Fopera_bPw6vBa6LD.gif?alt=media&#x26;token=80943d48-9645-4fca-94f3-bf946a5f06b1" alt=""><figcaption></figcaption></figure>

### Invitations

The default penalty type is "<mark style="color:yellow;">Timeout</mark>" for <mark style="color:yellow;">15 minutes</mark> when any Discord invitation found.

#### How does it work?

This filter reacts to messages containing any Discord invitation.

You can configure: message deletion, punishment type, notifying the member, ignoring channels, and ignoring roles.

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FDPOtmUaEeFcjmqMzLVwS%2FXrHjhQHtIu.gif?alt=media&#x26;token=eb2e8e4c-6469-4b7a-90f0-7ccf383cb61a" alt=""><figcaption></figcaption></figure>

#### How do I enable this filter?

To enable this filter, type the command <mark style="color:blue;">`/settings`</mark> and choose *Moderation*.&#x20;

In the dropdown menu, select "<mark style="color:yellow;">Invitations</mark>".

<figure><img src="https://3927572991-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0Hy8ldYgZJ9GQJFAuYLR%2Fuploads%2FWpR0PlfFexjJatrHmZ7c%2Fopera_pCoZAlApNV.gif?alt=media&#x26;token=17805453-18d9-43c3-af50-329c1be564fa" alt=""><figcaption></figcaption></figure>