Anti-Nuke Protection

The Anti-Nuke system is a high-priority security module designed to prevent server destruction by compromised moderator accounts or rogue administrators.

How it Works

The system monitors sensitive administrative actions (e.g., channel deletion, role removal, mass kicks) and tracks the velocity of these actions. If an executor performs too many actions within a short time frame, the bot automatically revokes their permissions and alerts the server owner.

Key Protections

  • Channel Protection: Detects mass deletion or creation of text and voice channels.
  • Role Protection: Detects mass deletion, creation, or permission updates of roles.
  • Member Protection: Detects mass kicking or banning of members.
  • Webhook Protection: Detects unauthorized creation or deletion of webhooks.
  • Dangerous Permission Guard: Prevents dangerous permissions (e.g., Administrator, Manage Roles) from being granted to @everyone or configured Main Roles.

Executor Identification

The bot uses Discord Audit Logs to identify the specific person performing the action. This ensures that only the offender is punished, even if multiple people are active.

Commands

/antinuke status

Displays the current configuration, active protections, and status of the Anti-Nuke system.

/antinuke toggle

Usage: /antinuke toggle [enabled: On/Off] Globally enable or disable the Anti-Nuke module.

/antinuke whitelist

Usage: /antinuke whitelist [user: @user] [role: @role] Adds a user or role to the whitelist. Whitelisted entities are immune to Anti-Nuke detection and velocity tracking. Note: The Server Owner is always whitelisted automatically.

/antinuke unwhitelist

Usage: /antinuke unwhitelist [user: @user] [role: @role] Removes a user or role from the whitelist.

Punishment Actions

Admins can configure the bot's response via the Web Dashboard:

  • Quarantine: The bot removes all roles from the offender. An option exists to also apply the "Muted" role.
  • Kick: The offender is immediately kicked from the server.
  • Ban: The offender is permanently banned from the server.

Emergency Restoration

When a threshold is tripped, the bot sends an alert to the #automod channel. This alert includes a "Restore Deleted Items" button.

  • Retention: The bot stores snapshots of deleted items for 48 hours.
  • Scope: Restoration re-creates deleted channels (including categories) and roles (including permissions and colors).

Accuracy

Restoration is a best-effort feature. While names and core settings are restored, complex configurations like specific invite codes or external integration links may need manual fixing.

Web Dashboard

For advanced configuration, navigate to the Anti-Nuke section on the sidebar of the Web Dashboard. You can:

  1. Customize Velocity Thresholds (e.g., Change from 3 actions in 10s to 5 actions in 30s).
  2. Main Roles Protection: Select specific roles to be guarded against dangerous permission changes.
  3. Toggle specific protection types.
  4. Manage the whitelist with a more intuitive interface.