> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeonbot.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Automod Overview

> Automatically moderate your server's chat with advanced heuristic filters.

The Automod system acts as your server's first line of defense against spam, toxic behavior, and chat abuse. It actively scans every message sent in your server against 13 distinct filters, applying automatic punishments like Mutes, Kicks, or Bans when members break the rules.

<Note>
  **Required Permission:** `is_server_owner` — Only the Server Owner and Extra Owners can configure Automod settings.
</Note>

***

## Setup Guide

Follow these steps to fully configure your Automod system.

<Steps>
  <Step title="Enable Automod">
    ```bash theme={null}
    .automod enable
    ```

    This initializes the Automod system and applies standard default heat settings to all filters.
  </Step>

  <Step title="Toggle Filters">
    ```bash theme={null}
    .automod manage
    ```

    Use the interactive dropdown menu to enable the specific filters you want active (e.g., Anti Link, Anti Spam, Anti Caps).
  </Step>

  <Step title="Configure Punishments">
    ```bash theme={null}
    .automod settings
    ```

    Open the Master Settings panel to configure exactly what happens when a filter triggers. You can set the Punishment Type (`Mute`, `Kick`, `Ban`, or `Auto Mute`), the Mute Duration, and the Heat value per filter.
  </Step>

  <Step title="Set Logging Channel">
    ```bash theme={null}
    .automod logging #automod-logs
    ```

    Assign a channel where the bot will log every deleted message and automatic punishment.
  </Step>
</Steps>

***

## Whitelisting

If you want specific users, roles, or channels to bypass certain Automod filters (e.g., allowing a `#media` channel to bypass the Anti-Link filter), use the Whitelist system.

| Command                       | Description                                              |
| :---------------------------- | :------------------------------------------------------- |
| `.automod whitelist @user`    | Opens a menu to select which filters the User ignores    |
| `.automod whitelist @role`    | Opens a menu to select which filters the Role ignores    |
| `.automod whitelist #channel` | Opens a menu to select which filters the Channel ignores |
| `.automod wlshow`             | Displays a list of all currently active whitelists       |

***

## Management Commands

| Command            | Description                                             |
| :----------------- | :------------------------------------------------------ |
| `.automod disable` | Disables the Automod system without deleting settings   |
| `.automod reset`   | Completely resets and deletes all Automod configuration |