Antiraid
DocsProtection

Antiraid

Detect suspicious joins and message raids without treating ordinary busy chat as a raid.

Protection modes

Antiraid can check default avatars, fresh accounts, mass joins, and coordinated message raids. Turning on one of these checks also enables antiraid.

security

,antiraid avatar

Punishes members who join using a default Discord profile picture, a common trait of throwaway raid accounts. Turning this on also switches antiraid on.

,antiraid avatar [state]
Example,antiraid avatar enable
Arguments
stateOptional
User permissionsManage Guild
Open in command browser
security

,antiraid newaccounts

Punishes members whose Discord account was created within the last X minutes, defaulting to 1440 (24 hours) and accepting 1 to 43200 (30 days). Aimed at freshly registered raid accounts. Turning this on also switches antiraid on.

,antiraid newaccounts [state] [minutes]
Example,antiraid newaccounts enable 10
Arguments
stateOptional
minutesOptional
User permissionsManage Guild
Open in command browser
security

,antiraid massjoin

Detects a burst of members joining at once and punishes them. Defaults to 5 joins within 10 seconds; the window must be between 3 and 120 seconds. Turning this on also switches antiraid on.

,antiraid massjoin [state] [limit] [seconds]
Example,antiraid massjoin enable 10 10
Arguments
stateOptional
limitOptional
secondsOptional
User permissionsManage Guild
Open in command browser
security

,antiraid spam

Detects a message raid in a channel and locks every text channel in the server when one is found. Detection is per channel and needs many distinct users, so ordinary busy chat does not set it off. Undo a lockdown with `antiraid reset`. Turning this on also switches antiraid on.

,antiraid spam [state]
Example,antiraid spam enable
Arguments
stateOptional
User permissionsManage Guild
Open in command browser

Start with measured thresholds

Mass join defaults to 5 joins in 10 seconds and accepts a 3 to 120 second window. New-account protection defaults to 1440 minutes and accepts 1 to 43200 minutes. Choose values that match the server's normal traffic.

Example mass-join setting
,antiraid massjoin enable 10 10
Example new-account setting
,antiraid newaccounts enable 1440

Message-raid lockdown

Message-raid detection is per channel and requires many distinct users. When detected, it locks every text channel. antiraid reset clears the raid state and restores saved permission overwrites without deleting your antiraid configuration.

security

,antiraid reset

Clears the current raid state and unlocks any channels that a message-raid lockdown locked, restoring their saved permission overwrites. Your antiraid settings are kept.

,antiraid reset
User permissionsManage Guild
Bot permissionsManage Channels
Open in command browser

One-time whitelist

The antiraid whitelist is a one-time join pass, not the permanent antinuke whitelist. Use it when a known account would otherwise match an active join check.

security

,antiraid whitelist

Shows how to grant someone a one-time pass through antiraid checks so they can join.

,antiraid whitelist
User permissionsManage Guild
Open in command browser
security

,antiraid whitelist view

Lists the user IDs currently holding a one-time antiraid whitelist pass.

,antiraid whitelist view
User permissionsManage Guild
Open in command browser
security

,antiraid config

Shows every antiraid setting for the server at once: whether it is on, and the current state of avatar, new-account, mass-join, and message-raid protection along with their thresholds.

,antiraid config
User permissionsManage Guild
Open in command browser
security

,antiraid state

Turns antiraid on or off for the server, or shows the current state with no argument - including whether the server is currently flagged as under raid. Turning it off also clears any active raid state.

,antiraid state [state]
Example,antiraid state enable
Arguments
stateOptional
User permissionsManage Guild
Open in command browser