Mataru
matarudocs

Security

Antinuke

Set restrictions on your staff to prevent harm from being done on your server.

Documentation›Security›Antinuke

What is antinuke?#

Antinuke is a system that automatically limits the number of destructive actions your staff can perform. If that limit is exceeded, the offending user is punished and the action is auto-reversed, keeping your server safe from both external attacks and rogue staff.

⚠
The server owner and whitelisted users are automatically exempt from antinuke restrictions. Antinuke tracks actions within a 60-second rolling window. Thresholds are per-action-type per-user (e.g. each user has their own ban counter). Antinuke must be explicitly enabled and each module must be configured separately.
ℹ
Available punishments: ban, kick, timeout (5 minutes), strip (dangerous roles only), stripstaff (staff roles only), jail. No messages are deleted by antinuke — only the action is blocked and the user is punished.

Allowing users to edit the antinuke settings.#

By default, only the server owner can manage the antinuke configuration. Using the !extraowner command, you can add up to 2 other users who can configure antinuke settings.

⚠
This is a risky command — it grants the user full control over the antinuke configuration. Use it only for highly trusted individuals. Maximum of 2 extra owners can be set per server.
Command
!extraowner add @user

To remove an extra owner, use the same command:

Command
!extraowner remove @user
!extraownerManage extra owners for antinuke accessGuild Owner Only
Syntax!extraowner <add|remove|show> [@user]
Example
!extraowner add @4nks
Aliases
extraownersaddowner

Whitelisting users from the antinuke#

By default, everyone is subject to being affected by the antinuke. To exempt a user, simply whitelist them using the !whitelist command. This is a risky command, as it allows the whitelisted user to perform any action without being punished.

!whitelistManage antinuke whitelisted users and rolesServer Owner
Syntax!whitelist <add|remove|show|reset|addrole|removerole|showroles|resetroles> [@user]
Examples
!whitelist add @4nks!whitelist addrole @Admins
Aliases
wl

To whitelist multiple users at once, use !multiwhitelist:

!multiwhitelistAdd or remove multiple users from the whitelist at onceServer Owner
Syntax!multiwhitelist <add|remove> @user1 @user2 ...
Example
!multiwhitelist add @4nks @user2
Aliases
multiwlmwl

Configuring the antinuke#

Configure the antinuke using these commands. Use !antinuke to view all settings at any time. Make sure to enable antinuke with !antinuke enable after setup.

!antinukeMain antinuke control commandServer Owner
Syntax!antinuke <enable|disable|setup|status|logchannel|modules|punishment>
Examples
!antinuke setup!antinuke enable
Aliases
an

Subcommands#

SubcommandDescription
!antinuke setupQuick setup — enables protection, creates log channel, enables all modules
!antinuke enableEnable antinuke protection
!antinuke disableDisable antinuke protection
!antinuke statusView current protection status and all module states
!antinuke logchannel #chSet the channel where antinuke actions are logged
!antinuke modulesBrowse and toggle individual protection modules
!antinuke punishment <ban|kick>Set what happens to violators
ℹ
The punishment setting applies to all modules except memberRoleUpdate, which always only strips dangerous roles regardless of this setting.

Setting up antinuke modules.#

Each module can be individually toggled on or off. Use !antinuke modules toggle <key> to enable or disable a specific module, or use !antinuke modules to open the paginated interactive panel.

Available Modules#

Module KeyModule NameWhat it protects
guildUpdateGuild UpdateServer name, icon, and settings changes
banAddMass BanBulk member bans
kickAddMass KickBulk member kicks
channelCreateChannel CreateRapid channel creation
channelDeleteChannel DeleteMass channel deletion
channelUpdateChannel UpdateRapid channel permission changes
roleCreateRole CreateRapid role creation
roleDeleteRole DeleteMass role deletion
roleUpdateRole UpdateDangerous permission grants to roles
memberRoleUpdateMember Role UpdateStrips dangerous roles only — never bans or kicks
webhookCreateWebhook CreateUnauthorized webhook creation
webhookDeleteWebhook DeleteMass webhook deletion
everyonePingAnti-Everyone PingUnauthorized @everyone pings
herePingAnti-Here PingUnauthorized @here pings
✓
Tip: Run !antinuke setup to enable all modules at once with sensible defaults. You can fine-tune individual modules afterward.