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

# Antinuke

> Limit destructive staff actions and react to suspicious audit-log activity.

## How protection works

Antinuke watches actions such as bans, kicks, role deletion, channel changes, emoji deletion, bot additions, and webhooks. Each module has its own configuration. Actions are counted per actor and module within that module's rolling window.

<Warning>
  Modules are disabled by default. The model's default window is 10 seconds; it is not a fixed 60-second window.
</Warning>

## Configure modules

Enable a module, then choose its threshold and punishment. Supported punishment names include warn, jail, kick, ban, and stripstaff. Inspect the configuration before testing enforcement.

```text theme={null}
,antinuke config
,antinuke channel on --threshold 3 --do stripstaff
,antinuke ban on --threshold 3 --do ban
```

## Administrators and exemptions

The server owner configures antinuke access. Super administrators and whitelisted users are managed separately. Whitelisting exempts a user or bot from checks.

```text theme={null}
,antinuke admins
,antinuke whitelist @trusted-bot
```

## Command and permission detection

Ban, kick, and role modules can watch qualifying bot commands with `--command`. The permissions subcommand selects a watched permission and whether to detect grants or removals.

```text theme={null}
,antinuke ban on --threshold 3 --do stripstaff --command on
,antinuke permissions grant administrator
```

## Command reference

Examples use the default comma prefix. Required inputs use angle brackets; optional inputs use square brackets. Each command notes whether it is also registered in Discord's slash menu.

<AccordionGroup>
  <Accordion title=",antinuke" icon="terminal">
    Impose restrictions on moderators to prevent destructive behavior.

    ### antinuke config

    View the antinuke configuration.

    ```text Prefix syntax theme={null}
    ,antinuke config
    ```

    ### antinuke list

    View modules and whitelisted users.

    ```text Prefix syntax theme={null}
    ,antinuke list
    ```

    ### antinuke admin

    Toggle a user as an antinuke super admin.

    ```text Prefix syntax theme={null}
    ,antinuke admin <user>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | User to toggle |

    ### antinuke admins

    View antinuke super admins.

    ```text Prefix syntax theme={null}
    ,antinuke admins
    ```

    ### antinuke whitelist

    Toggle a user or bot as exempt from antinuke.

    ```text Prefix syntax theme={null}
    ,antinuke whitelist <user>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `user` | Yes | User or bot to toggle |

    ### antinuke permissions

    Toggle a watched permission grant or removal.

    ```text Prefix syntax theme={null}
    ,antinuke permissions <direction> <permission>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `direction` | Yes | Permission change direction Choices: `grant`, `remove`. |
    | `permission` | Yes | Permission to watch Choices: `administrator`, `ban_members`, `mention_everyone`, `kick_members`, `moderate_members`, `manage_guild`, `manage_channels`, `manage_roles`, `view_audit_log`, `manage_webhooks`, `manage_expressions`. |

    ### antinuke vanity

    Punish members for changing the vanity URL

    ```text Prefix syntax theme={null}
    ,antinuke vanity <status> [flags]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |
    | `flags` | No | `--threshold` 3 `--do` ban `--command` on |

    ### antinuke botadd

    Prevent unauthorized bots from being added

    ```text Prefix syntax theme={null}
    ,antinuke botadd <status>
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |

    ### antinuke ban

    Prevent members from being mass banned

    ```text Prefix syntax theme={null}
    ,antinuke ban <status> [flags]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |
    | `flags` | No | `--threshold` 3 `--do` ban `--command` on |

    ### antinuke kick

    Prevent members from being mass kicked

    ```text Prefix syntax theme={null}
    ,antinuke kick <status> [flags]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |
    | `flags` | No | `--threshold` 3 `--do` ban `--command` on |

    ### antinuke role

    Prevent roles from being mass deleted

    ```text Prefix syntax theme={null}
    ,antinuke role <status> [flags]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |
    | `flags` | No | `--threshold` 3 `--do` ban `--command` on |

    ### antinuke channel

    Prevent channels from being mass created or deleted

    ```text Prefix syntax theme={null}
    ,antinuke channel <status> [flags]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |
    | `flags` | No | `--threshold` 3 `--do` ban `--command` on |

    ### antinuke emoji

    Prevent emojis from being mass deleted

    ```text Prefix syntax theme={null}
    ,antinuke emoji <status> [flags]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |
    | `flags` | No | `--threshold` 3 `--do` ban `--command` on |

    ### antinuke webhook

    Prevent webhooks from being mass created

    ```text Prefix syntax theme={null}
    ,antinuke webhook <status> [flags]
    ```

    | Parameter | Required | Description |
    | - | - | - |
    | `status` | Yes | Turn this module on or off Choices: `on`, `off`. |
    | `flags` | No | `--threshold` 3 `--do` ban `--command` on |
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.