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

# Automod

> Word filters, anti-spam, anti-raid, and more, configured together.

## Overview

Automod is one command, `!automod`, covering several independent checks. Each has its own enable toggle, so turning one on doesn't affect the others. Arguments are positional and space-separated.

## Word filter

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod word-filter toggle <enabled> [action]
  !automod word-filter add <word>
  !automod word-filter remove <word>
  !automod word-filter list
  ```

  ```javascript Example theme={null}
  !automod word-filter toggle true mute
  !automod word-filter add slur
  ```

  ```text Result theme={null}
  ✅ Word filter enabled.
  Action: mute (10 minutes)
  ```
</CodeGroup>

`action` is `warn` (default), `mute` (10 minutes), `kick`, or `delete` (removes the message, no sanction).

## Anti-spam

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod spam <enabled> [max_mentions]
  ```

  ```javascript Example theme={null}
  !automod spam true 5
  ```
</CodeGroup>

Also catches repeat messages, excessive caps, and unauthorized Discord invite links, alongside mass mentions.

### Allowed invites

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod invites allow <code>
  !automod invites disallow <code>
  !automod invites list
  ```

  ```javascript Example theme={null}
  !automod invites allow abc123
  ```
</CodeGroup>

Add your own server's invite code (or any partner server's) so anti-spam doesn't flag it.

## Anti-raid

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod raid <enabled> [threshold] [window_seconds] [action]
  ```

  ```javascript Example theme={null}
  !automod raid true 6 10 kick
  ```
</CodeGroup>

Defaults: 6 joins within 10 seconds. `action` is `alert` (default, staff-only notice) or `kick`.

## Anti-alt

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod anti-alt <enabled> [min_age_days] [action]
  ```

  ```javascript Example theme={null}
  !automod anti-alt true 7 kick
  ```
</CodeGroup>

Flags or kicks accounts younger than `min_age_days` (default 7) on join. `action` is `kick` (default) or `flag` (logs only, no action taken).

## Link scanning

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod link <url>
  ```

  ```javascript Example theme={null}
  !automod link https://suspicious-link.com
  ```
</CodeGroup>

A one-off manual check, not a passive filter, runs a URL through Google Safe Browsing for phishing/malware.

## Immune roles

Roles that bypass the word filter and anti-spam checks entirely.

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod immune add <role>
  !automod immune remove <role>
  !automod immune list
  ```

  ```javascript Example theme={null}
  !automod immune add @Staff
  ```
</CodeGroup>

## Silent channels

A channel where **any** message counts as a violation, regardless of content.

<CodeGroup>
  ```javascript Syntax theme={null}
  !automod silent-channel add <channel> [action]
  !automod silent-channel remove <channel>
  !automod silent-channel list
  ```

  ```javascript Example theme={null}
  !automod silent-channel add #announcements mute
  ```
</CodeGroup>

`action` is `warn` (default), `mute` (30 minutes), or `kick`.

## Related

<Card title="Anti-Nuke" icon="bomb" href="/moderation/anti-nuke">
  A separate, more serious layer for mass-destructive actions.
</Card>