Commands: Server security

The antiraid protects the server against raids, and against a staff member who would abuse their permissions or whose account got hacked.

The antiraid protects the server against raids, and against a staff member who would abuse their permissions or whose account got hacked. +secur shows all its settings, +secur on or +secur max turns them all on at once.

The protections
Each one is set to off, on or max: on blocks members who aren't whitelisted, max blocks everyone except the bot's owners.

+antibot: bots added to the server;
+antiwebhook, +antiupdate, +antichannel: creating webhooks, changing the server (name, icon…) and changing channels;
+antirole: changing roles, only dangerous roles by default (+antirole all for every role);
+antiunban: unbans;
+antiban, +antieveryone, +antideco: too many bans or kicks, @everyone mentions or voice disconnections in a short time. +antiban 3/1h allows 3 per hour.

When a protection fires, the bot undoes the action when it can and punishes its author: a kick by default, +punition antiban ban to ban them, +punition all derank to take their roles away whatever the protection. The same action repeated in a burst is punished and reported once.

Against mass joins

+antitoken on kicks newcomers when too many accounts join at once: 10 in 10 seconds by default, +antitoken 9/10 for 9 in 10 seconds. +antitoken lock closes the server completely.
+creation limit 7d kicks accounts created less than 7 days ago.

Whitelist and alerts

+wl @member (or a role) lets them bypass the antiraid, except in max. The whitelist gives no permission on the bot.
+raidlog on #raid-logs reports every antiraid action, +raidping @Staff mentions that role during a raid.
+blrank add @member puts a member in the rank blacklist: with +blrank on, they can no longer receive dangerous roles (+blrank all for every role).
+clear webhooks deletes every webhook of the server.

The step-by-step guide

Protecting your server with the antiraid walks you through it.

`+antitoken`

+antitoken <lock/on/off>: Turns on/off Antitoken. lock can be use to lock the server and prevent anyone to join
+antitoken <number>/<duration>: Sets the maximum number of joins allowed during a number of seconds before triggering Antitoken

When too many accounts join at once, the bot kicks the newcomers: 10 in 10 seconds by default. +antitoken 9/10s changes it to 9 accounts in 10 seconds; the second part is a duration (10s, 1m…). lock closes the server: every newcomer is kicked. +punition antitoken ban bans them instead of kicking them.
Examples: +antitoken on, +antitoken 9/10s, +antitoken lock

Default level: Owners

`+secur`

+secur [max/on/off]: Shows and/or modifies all antiraid settings on the server

On its own, +secur shows the state of every protection. on, max or off set them all at once (with max, the antitoken goes on).
Examples: +secur, +secur on

Default level: Owners · Other names: +security

`+antiupdate`

+antiupdate <max/on/off>: Turns on/off Antiupdate

Watches changes to the server: name, icon, banner, settings. on targets members who aren't whitelisted, max everyone except the bot's owners; the author is punished (+punition) and the action undone when possible.
Example: +antiupdate on

Default level: Owners

`+antichannel`

+antichannel <max/on/off>: Turns on/off Antichannel

Watches channels being created, deleted and edited, permissions included. on targets members who aren't whitelisted, max everyone except the bot's owners; the author is punished (+punition) and the action undone when possible.
Example: +antichannel on

Default level: Owners

`+antirole`

+antirole <max/on/off>: Turns on/off Antirole
+antirole <danger/all>: Selects whether Antirole is triggered only by dangerous roles or by all roles

Watches roles being created, deleted and edited, and dangerous roles given to members. A role is dangerous if it gives a bot permission (Perm 2 or higher) or a Discord moderation or administration permission; all extends the protection to every role. on targets members who aren't whitelisted, max everyone except the bot's owners; the author is punished (+punition) and the action undone when possible.
Examples: +antirole on, +antirole all

Default level: Owners

`+antiwebhook`

+antiwebhook <max/on/off>: Turns on/off Antiwebhook

Watches webhooks being created and edited, since they can send messages in bulk. on targets members who aren't whitelisted, max everyone except the bot's owners; the author is punished (+punition) and the action undone when possible.
Example: +antiwebhook on

Default level: Owners

`+antiunban`

+antiunban <max/on/off>: Turns on/off Antiunban

Watches unbans, so a banned member isn't quietly unbanned. on targets members who aren't whitelisted, max everyone except the bot's owners; the author is punished (+punition) and the action undone when possible.
Example: +antiunban on

Default level: Owners

`+antibot`

+antibot <max/on/off>: Turns on/off Antibot

A bot added to the server is kicked right away. on lets through those added by a whitelisted member (the log then offers a button to kick it anyway), max kicks them all.
Examples: +antibot on, +antibot max

Default level: Owners

`+antiban`

+antiban <max/on/off>: Turns on/off Antiban
+antiban <number>/<duration>: Sets the maximum number of kicks or bans during a specific duration

Counts the bans and kicks made by one member: 3 per minute by default. +antiban 3/1h changes it to 3 per hour. Beyond that, the author is punished (+punition). The bot's own +ban and +kick count too.
Examples: +antiban on, +antiban 3/1h

Default level: Owners

`+antieveryone`

+antieveryone <max/on/off>: Turns on/off Antieveryone
+antieveryone <number>/<duration>: Sets the maximum number of everyone mentions in a specific duration

Counts the @everyone and @here mentions made by one member, and those of roles holding a large part of the members: 3 per hour by default. Beyond that, the author is punished (+punition).
Examples: +antieveryone on, +antieveryone 2/1d

Default level: Owners

`+antideco`

+antideco <max/on/off>: Turns on/off Antideco
+antideco <number>/<duration>: Sets the maximum number of disconnection during a specific duration

Counts the members one member disconnects from voice: 3 per minute by default. Beyond that, the author is punished (+punition).
Examples: +antideco on, +antideco 5/10m

Default level: Owners

`+punition`

+punition <antiraid> <derank/kick/ban>: Sets the punishment for one antiraid feature
+punition all <derank/kick/ban>: Modifies the punishment for all antiraid features

Each protection has its punishment: derank (takes their roles away), kick (the default) or ban. Give the protection's name, or all for every one. If the author has already left the server, ban still bans them; kick and derank have nothing left to do, and the log says so.
Examples: +punition antiban ban, +punition all derank

Default level: Owners

`+creation limit`

+creation limit <off/duration>: Defines how old the account of a user should be to be allowed to join the server

An account created less than this long ago is kicked as soon as it joins: often a throwaway account. off turns it off.
Examples: +creation limit 7d, +creation limit off

Default level: Owners

`+blrank`

+blrank <max/on/off>: Turns on/off Blacklist rank
+blrank <danger/all>: Triggers Blacklist rank only for dangerous roles or for all roles
+blrank <add/del> <member>: Adds a member to the Blacklist rank
+blrank: Shows Blacklist rank

A member of the rank blacklist must not receive dangerous roles, or no role at all with all. With on, whoever gives them one is punished unless whitelisted; with max, everyone except the owners. +addrole also refuses to give them a role. Adding or removing a member takes a level strictly higher than theirs.
Examples: +blrank add @member, +blrank on

Default level: Owners

`+clear blrank`

+clear blrank: Removes every member from the Blacklist rank

The rank blacklist is emptied; the protection stays set as before.

Default level: Owners

`+raidlog`

+raidlog <on/off> [channel]: Turns antiraid logs on (in a channel) or off

Every antiraid action is reported there: who, what, the punishment. The same action repeated in a burst is reported once. Without a channel, on picks the one you're in.
Examples: +raidlog on #raid-logs, +raidlog off

Default level: Owners

`+raidping`

+raidping <role>: Sets roles to be mentioned in case of raid
+raidping: Stops mentioning roles in case of raid

The role is mentioned in the antiraid logs when it fires; give it by its mention, its ID or its name. On its own, +raidping removes the mention.
Examples: +raidping @Staff, +raidping

Default level: Owners

`+clear webhooks`

+clear webhooks: Deletes all webhooks from the server

The command is handy after a webhook raid. Useful webhooks (announcement feeds, integrations) are deleted too: they will need creating again.

Default level: Owners · Other names: +clear webhook

`+wl`

+wl <member/role>: Adds a member or a role to the whitelist of the server (they will not be affected by the antiraid anymore)
+wl: Displays the whitelist of the server

A whitelisted member or role bypasses the antiraid (except in max) and can write text in selfie channels. It isn't a permission on the bot. Give it by its mention or its ID only: for safety, a name isn't accepted.
Examples: +wl @member, +wl @Admin

Default level: Owners

`+unwl`

+unwl <member/role>: Removes a member or a role from the whitelist of the server

Give it by its mention or its ID only: for safety, a name isn't accepted.
Example: +unwl @member

Default level: Owners

`+clear wl`

+clear wl: Removes all members from the whitelist of the server

Nobody is whitelisted on this server any more: the antiraid applies to everyone again except the owners.

Default level: Owners

The levels and names shown are the original ones: your server may have changed them (permissions, +alias). Every Gestion V2 command