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

# XRYPTON Anti-Nuke and Anti-Raid Commands Reference

> Full reference for XRYPTON's Anti-Nuke and Anti-Raid systems — configure modules, punishments, thresholds, and whitelists to protect your server.

XRYPTON provides two complementary protection layers: **Anti-Nuke** watches audit logs in real time and punishes users who exceed action thresholds for destructive events, while **Anti-Raid** monitors join patterns and account attributes to stop bot waves before they take hold. Both systems are independent and can be tuned separately.

## Anti-Nuke

Anti-Nuke must be enabled before any module can be configured. Once active, it tracks nine threat categories — each with its own toggle, action threshold, and punishment.

**Available modules:** `Ban`, `Kick`, `Bot`, `Roles`, `Vanity`, `Webhook`, `Channels`, `Permissions`, `Massmention`

**Available punishments:** `ban`, `kick`, `warn`, `strip`

<Note>
  Only the server owner or users designated as Anti-Nuke Admins can run these commands. Anti-Nuke Admin is a separate privilege from Discord's server Administrator permission.
</Note>

| Command                | Usage                                   | Description                                                                                          | Required Permission |
| ---------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------- | ------------------- |
| `antinuke`             | `antinuke`                              | Display the Anti-Nuke help menu. Alias: `an`.                                                        | Administrator       |
| `antinuke enable`      | `antinuke enable`                       | Enable Anti-Nuke for the server. Also creates default module records if none exist yet.              | Administrator       |
| `antinuke disable`     | `antinuke disable`                      | Disable Anti-Nuke entirely and stop all protection.                                                  | Administrator       |
| `antinuke settings`    | `antinuke settings`                     | View the current status, punishment, and threshold for every module. Alias: `config`.                | Administrator       |
| `antinuke toggle`      | `antinuke toggle <module>`              | Enable or disable a specific module (e.g. `antinuke toggle Ban`).                                    | Administrator       |
| `antinuke threshold`   | `antinuke threshold <module> <number>`  | Set how many threshold-breaking actions a user can take in 60 seconds before the punishment fires.   | Administrator       |
| `antinuke action`      | `antinuke action <module> <punishment>` | Set the punishment for a module. Accepts `ban`, `kick`, `warn`, or `strip`. Alias: `punishment`.     | Administrator       |
| `antinuke whitelist`   | `antinuke whitelist <user>`             | Toggle whitelist status for a user — whitelisted users are fully exempt from Anti-Nuke. Alias: `wl`. | Administrator       |
| `antinuke whitelisted` | `antinuke whitelisted`                  | Show all users currently whitelisted in this server.                                                 | Administrator       |
| `antinuke admin`       | `antinuke admin <user>`                 | Grant or revoke Anti-Nuke Admin status for a user. Anti-Nuke Admins can run all `antinuke` commands. | Administrator       |
| `antinuke admins`      | `antinuke admins`                       | Show all users currently designated as Anti-Nuke Admins.                                             | Administrator       |

<Warning>
  The `strip` punishment removes all roles that carry dangerous permissions (ban, kick, administrator, manage channels, etc.). It does not ban or kick the user — combine it with another punishment type if you need removal.
</Warning>

### Module Behavior Reference

| Module        | Trigger Event                                                    |
| ------------- | ---------------------------------------------------------------- |
| `Ban`         | Audit log: member ban or unban                                   |
| `Kick`        | Audit log: member kick                                           |
| `Bot`         | A bot joins the server (fires immediately on join, no threshold) |
| `Roles`       | Audit log: role create or delete                                 |
| `Vanity`      | Guild vanity URL changed                                         |
| `Webhook`     | Audit log: webhook create or delete                              |
| `Channels`    | Audit log: channel create, delete, or update                     |
| `Permissions` | A member has an Administrator role added to them                 |
| `Massmention` | A message uses `@everyone` or `@here`                            |

<Tip>
  Start with a threshold of `3` on destructive modules like `Ban`, `Channels`, and `Roles`. This gives legitimate admins room to work in bulk while still catching malicious actors who move fast.
</Tip>

***

## Anti-Raid

Anti-Raid operates on join events and has three independent modules: **Mass Join**, **New Accounts**, and **Default Avatar**. Each module is configured and toggled individually. There is no global enable/disable switch — disabling all three modules effectively turns off Anti-Raid.

| Command                          | Usage                                                           | Description                                                                                                                                                                       | Required Permission |
| -------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------- |
| `antiraid`                       | `antiraid`                                                      | Display the Anti-Raid help menu.                                                                                                                                                  | Manage Server       |
| `antiraid settings`              | `antiraid settings`                                             | View the current state of all three modules. Aliases: `stats`, `config`.                                                                                                          | Manage Server       |
| `antiraid whitelist`             | `antiraid whitelist <member>`                                   | Add a member to the Anti-Raid whitelist, exempting them from all raid checks. Alias: `wl`.                                                                                        | Manage Server       |
| `antiraid unwhitelist`           | `antiraid unwhitelist <member>`                                 | Remove a member from the Anti-Raid whitelist. Alias: `unwl`.                                                                                                                      | Manage Server       |
| `antiraid whitelist view`        | `antiraid whitelist view`                                       | List all users currently on the Anti-Raid whitelist.                                                                                                                              | Manage Server       |
| `antiraid massjoin enable`       | `antiraid massjoin enable --do <ban\|kick> --threshold <joins>` | Enable the Mass Join module. Set the punishment and the number of joins within 10 seconds that triggers it. Alias: `on`.                                                          | Manage Server       |
| `antiraid massjoin disable`      | `antiraid massjoin disable`                                     | Disable the Mass Join module. Alias: `off`.                                                                                                                                       | Manage Server       |
| `antiraid newaccounts on`        | `antiraid newaccounts on --do <ban\|kick> --threshold <days>`   | Enable New Accounts protection. Accounts younger than `<days>` days will be actioned on join. Alias: `enable`.                                                                    | Manage Server       |
| `antiraid newaccounts disable`   | `antiraid newaccounts disable`                                  | Disable New Accounts protection. Alias: `off`.                                                                                                                                    | Manage Server       |
| `antiraid newaccounts whitelist` | `antiraid newaccounts whitelist <user>`                         | Allow a specific user to join even if their account is younger than the threshold. Alias: `wl`.                                                                                   | Manage Server       |
| `antiraid defaultavatar enable`  | `antiraid defaultavatar enable --do <ban\|kick>`                | Enable Default Avatar protection. Members who join without a custom profile picture are actioned immediately. Aliases for group: `dav`, `defaultpfp`; alias for subcommand: `on`. | Manage Server       |
| `antiraid defaultavatar disable` | `antiraid defaultavatar disable`                                | Disable Default Avatar protection. Alias: `off`.                                                                                                                                  | Manage Server       |

<Warning>
  Mass Join punishment applies retroactively to **all** members in the cache when the threshold is crossed — not just the most recent joiner. Make sure your threshold is high enough to avoid false positives during legitimate membership surges (e.g., after a promotional post).
</Warning>

<Note>
  The `antiraid newaccounts whitelist` command is distinct from `antiraid whitelist`. The former exempts a user only from the New Accounts age check; the latter exempts them from all three modules.
</Note>