# AI Moderation System

<figure><img src="https://2332958363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQ8vYo6tbmfhqpjmHKTO%2Fuploads%2Fbkjc0he65iPkxbhDVJgz%2Fimage.png?alt=media&#x26;token=cd6de5d9-cf73-4c71-b1e6-71ba590eec24" alt=""><figcaption><p>Experience whole new texts and images Auto Moderation power by AI</p></figcaption></figure>

***

<figure><img src="https://2332958363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQ8vYo6tbmfhqpjmHKTO%2Fuploads%2FwS28nyPmJSUTKMYTsQ6V%2Fimage.png?alt=media&#x26;token=3f3e0763-741a-483b-a650-43a90b174a46" alt=""><figcaption></figcaption></figure>

## 📄 General Settings

#### 🖊️ Log Channel

Select a channel where moderation actions (timeouts, bans, etc.) will be logged. This is helpful for transparency and recordkeeping.

* Example: `#server-log`

#### 🛡️ Message Handling Options

* **DM User**: Notifies the user via direct message when moderation action is taken.
* **Same Channel Notification**: Shows moderation results in the same channel where the violation occurred.
* **Delete Flagged Messages**: Automatically removes messages that violate moderation rules.

#### 🔍 Ignored Elements

* **Channels**: Add channels to be excluded from moderation.
* **Users**: List user IDs that should be excluded (Developer Mode needed to get IDs).
* **Roles**: Define roles that will bypass moderation.

***

<figure><img src="https://2332958363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQ8vYo6tbmfhqpjmHKTO%2Fuploads%2FKfdIvdFfi0EFOdtn9H2E%2Fimage.png?alt=media&#x26;token=f9da3d93-b815-42cc-93c7-d1e872120f2c" alt=""><figcaption></figcaption></figure>

## 🔎 Content Filters

#### 🔗 URL Filtering

* **Mode**: You can choose to enable or disable URL filtering.
* **Web Risk Detection**: Uses Google Web Risk API to identify harmful URLs (e.g., phishing, malware).

#### 🔒 Content Moderation Thresholds

Each category can be toggled ON/OFF and configured with sensitivity:

* **Sexual Content**
* **Sexual Content (Minors)**
* **Harassment**
* **Threatening Harassment**
* **Hate Speech**
* **Threatening Hate Speech**

Sensitivity range: `0% (Less Sensitive)` to `100% (More Sensitive)`.

***

<figure><img src="https://2332958363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQ8vYo6tbmfhqpjmHKTO%2Fuploads%2FPVOItFJmTiz2hpuPMOcc%2Fimage.png?alt=media&#x26;token=0f4594f1-fb75-4f0b-affc-c36a088b8171" alt=""><figcaption></figcaption></figure>

## 🔨 Actions

Enable automated disciplinary actions based on user warnings:

#### Placeholders Available

* `{username}`: User’s name
* `{user_id}`: User’s ID
* `{moderator}`: Moderator’s name
* `{duration}`: Timeout/ban length
* `{reason}`: Reason for action
* `{now}`: Current time/date

#### ⏱ Timeout

* **Warnings Before**: 2
* **Duration**: 30 minutes
* **Enabled**: ✅

#### 🚫 Temporary Ban

* **Warnings Before**: 3
* **Duration**: 1 day
* **Enabled**: ✅

#### ❌ Permanent Ban

* **Warnings Before**: 4
* **Warning**: Cannot be reversed automatically.
* **Enabled**: ✅

***

<figure><img src="https://2332958363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQ8vYo6tbmfhqpjmHKTO%2Fuploads%2FsPgfuerKdarYkvIOpic7%2Fimage.png?alt=media&#x26;token=8e1c818f-e389-42c6-b867-acd1ec86ea70" alt=""><figcaption></figcaption></figure>

## 🔔 Events

Each moderation action is logged with:

* **ID**: Unique event ID
* **Action**: (e.g., Warning, Timeout)
* **User**: Targeted user
* **Moderator**: Who triggered the action (e.g., AI Moderation)
* **Timestamp**: When the action occurred
* **Details**: View breakdown of moderation reasoning

***

## 🔧 Saving & Enabling

* Use the **Save Settings** button to apply all configurations.
* Toggle the **Enabled** switch to activate or deactivate moderation enforcement.

***

## 🛡️ Required Permissions

The bot needs specific permissions to operate the moderation system. If any are missing, the module may not function.

* **Administration** *(Optional but Recommended)*:\
  Granting this overrides the need to manually assign the individual permissions below.

If **Administration** is not enabled, you **must** enable the following **server-wide** permissions:

* `Kick Members` *(Required)*
* `Ban Members` *(Required)*
* `Moderate Members` *(Required)*
* `Manage Messages` *(Required)*

{% hint style="success" %}
You can use command `/diagnose` to check which feature/module is eligible to use in your server
{% endhint %}

{% hint style="warning" %}
**NYX cannot moderate members who have a higher or equal role position.** Make sure the bot’s highest role is placed **above** the roles of any members you want it to moderate.
{% endhint %}

***

## Defaulted Ignored Moderation

this follow list are defaulted ignored moderation, they are not able to modified by server admin

* Users with administration permission
* Bot doesn't have required permission

***

### Self-Harm Build-In Detector

We priorities user mental state and maintain safety to all user make sure everyone is safe! \
When we detect self-harm messages even texts or images we will send you this embed to the user DMs

<figure><img src="https://2332958363-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfQ8vYo6tbmfhqpjmHKTO%2Fuploads%2FwkCU109Ctkjxzpa88EKb%2Fimage.png?alt=media&#x26;token=731de02d-29b8-462c-a9ab-3c5b0c7835bd" alt=""><figcaption></figcaption></figure>
