Verification

Verification is the door of your server. A member who just joined gets nothing — no roles, no channels, no welcome message — until they've pressed a button, typed a captcha or solved a small sum. Raid bots don't do any of those things, so they never make it past the panel.

Setting up Verification

There are two ways in. If you don't have a verified role or a verification channel yet, let serenity build the whole thing for you.

Let serenity build it

[prefix]verification create creates a verified role, an unverified waiting role, a #verify channel with the right permissions and posts the panel into it. Running it twice won't give you a second channel — anything that already exists is kept.

// Syntax
[prefix]verification create

// Example
;verification create

Use roles you already have

If you already have a member role, point verification at it instead. The channel is optional — leave it off and the panel goes into the channel you ran the command in.

// Syntax
[prefix]verification setup [role] (channel)

// Example
;verification setup @Verified #verify

Pick a Challenge

By default members only have to press a button. That already stops most self-bots, but you can ask for more.

// Syntax
[prefix]verification mode [button|captcha|math]

// Example
;verification mode captcha

Who has to Verify

The gate has two ways of working, and this is the setting people get wrong most often.

// Syntax
[prefix]verification gate [on|off]

// Example
;verification gate off

The Antinuke Quarantine Punishment

Antinuke's join-time modules — new accounts and default avatar — can use quarantine as their punishment, which drops the member at the verification gate instead of kicking them. That's the whole point of the gate being usable on its own.

But if the gate already holds every join, quarantining a member who was going to land there anyway does nothing. Serenity will tell you when your two settings cancel each other out.

Waiting Rules

Everything below decides who may verify, when, and what happens if they never do.

Require a Minimum Account Age

Accounts younger than this can't verify at all — they sit at the gate and are told when to come back. Handy against freshly made raid accounts.

// Syntax
[prefix]verification age [duration]

// Example
;verification age 7d

Make Members Wait

A hold makes members sit in the gate for a while before the button does anything. Raids are impatient — most bots are gone long before the timer is up.

// Syntax
[prefix]verification hold [duration]

// Example
;verification hold 10m

Kick Members who never Verify

Without a timeout, members can sit at the gate forever. With one, they get punished once it runs out.

// Syntax
[prefix]verification timeout [duration]

// Example
;verification timeout 30m

Limit the Attempts

How many wrong captcha or math answers a member gets before the punishment applies. The default is 3.

// Syntax
[prefix]verification attempts [number]

// Example
;verification attempts 5

Choose the Punishment

What happens to a member who runs out of attempts or out of time. The default is kick.

// Syntax
[prefix]verification punishment [kick|ban|none]

// Example
;verification punishment ban

Slow a Raid Down

Two settings exist for the moment a raid is actually happening.

Cap how many Members get in

The flood limit caps how many members may finish verifying per timeframe. Everyone over the cap isn't rejected — they stay in the gate and get told when the next slot opens.

// Syntax
[prefix]verification flood [amount] (per)

// Example
;verification flood 10 1h

Force a Captcha during a Raid

With raid mode on, serenity upgrades your challenge to a captcha for a while whenever it notices a mass join — or whenever your flood limit fills up, which is a raid signal in itself. Once it calms down, your normal mode comes back.

// Syntax
[prefix]verification raidmode [on|off]

// Example
;verification raidmode on

The Waiting Role

Members waiting at the gate can be given a role. It's what makes the panel channel visible to them and everything else invisible — [prefix]verification create sets one up for you, but you can point it at your own.

// Syntax
[prefix]verification unverifiedrole [role]

// Example
;verification unverifiedrole @Unverified

Run the command without a role to stop handing one out.

Customize the Panel

The panel is a normal embed script, so it takes the same variables as everything else in serenity.

// Syntax
[prefix]verification message set [code]

// Example
;verification message set {embed}{title: Welcome!}{description: Press the button to get in}

To check what you currently have, use [prefix]verification message view. To go back to the default panel, use [prefix]verification message reset. Both repost the panel for you.

Move or Repost the Panel

[prefix]verification channel [channel] moves the panel somewhere else — the old message is deleted and the channel permissions are fixed up in the process.

// Syntax
[prefix]verification channel [channel]

// Example
;verification channel #entry

If the panel is just gone, [prefix]verification panel sends it again.

Logging

Set a channel and serenity logs every verification, quarantine, stripped role, throttled member and failure into it.

// Syntax
[prefix]verification logs [channel]

// Example
;verification logs #verify-logs

Run the command without a channel to turn logging off.

Managing Members

Send someone back through the Gate

Takes the member role back off a member and puts them in front of the panel again — the manual version of antinuke's quarantine punishment.

// Syntax
[prefix]verification quarantine [member] (reason)

// Example
;verification quarantine eivoran ban evasion

Verify someone yourself

Lets a member through without them touching the panel. Moderator approvals ignore the flood limit, so you're never held up by your own throttle.

// Syntax
[prefix]verification approve [member]

// Example
;verification approve eivoran

List everyone Waiting

Shows who is at the gate, how long they've been there, how many attempts they've used and which system sent them.

// Syntax
[prefix]verification pending

// Example
;verification pending

Check your Setup

One command shows the whole configuration, plus how many members are waiting and how many have verified so far.

// Syntax
[prefix]verification settings

// Example
;verification settings

Turning Verification off

// Syntax
[prefix]verification disable

// Example
;verification disable