> For the complete documentation index, see [llms.txt](https://chat.advancedplugins.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chat.advancedplugins.net/features/auto-moderation.md).

# Auto Moderation

Auto Moderation serves as a vigilant guardian of your server's chat, ensuring continuous oversight and integrity in communications, even during your absence. This system automates the enforcement of chat rules, dealing with spam and other infractions by issuing warnings, kicks, mutes, or bans to offenders based on predefined thresholds.

## Configuration: `config.yml`

#### Customization

This feature allows for significant customization to fit the specific needs and policies of your server. You can set up different actions (warn, kick, mute, ban) to be executed at various thresholds of warnings, tailoring the moderation intensity and response to your community's standards.

#### Benefits

* **Continuous Moderation**: Keeps your chat clean and aligned with your community's values, even when moderators are offline.
* **Automated Rule Enforcement**: Automatically handles violations, saving time and ensuring consistent rule application.
* **Flexible Configuration**: Easily adjust thresholds and responses to find the perfect balance for your server's culture.

### Warning Thresholds

The warning system plays a crucial role in moderating chat by tracking the number of violations each player accumulates. Once a player reaches a certain threshold, predefined actions are automatically triggered.

### **Example Configuration**

{% code title="config.yml" %}

```yaml
warn:
  thresholds:
    3:
      commands:
        - "kick %player% Excessive warnings"
    4:
      commands:
        - "mute %player% 10m Excessive warnings"
```

{% endcode %}

In this example, the server is configured to automatically kick a player after they receive their third warning for rule violations. Upon their fourth warning, the player will be muted for 10 minutes, with the reason being "Excessive warnings".


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://chat.advancedplugins.net/features/auto-moderation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
