Verification

Overview

This system helps with security, organization, and onboarding. It has two main parts:

• Join Roles → Automatically give roles to users when they join.

• Verification System → Require users to verify before accessing the server.

---

Join Roles System

How It Works

• Automatic assignment → Users get the listed roles instantly on joining.

• Multiple roles → You can assign more than one role at once.

• Role restoration → If enabled, the bot remembers and restores previous roles when someone rejoins.

Role Restoration Settings

• Blacklist → Roles that will not be restored (e.g., muted/punished roles).

• Whitelist → Only these roles are restored.

If both are used → Whitelist always takes priority.

---

Verification System

Basic Configuration

Enable this system to force users to verify before gaining server access.

Verification Types

1

Button Verification (BUTTON)

• Easiest option: One click to verify.

• Great for casual servers and smooth onboarding.

2

Calculator Verification (CALCULATOR)

• Users must solve a random math problem (e.g., What is 7 + 3?).

• Wrong answers let them retry.

• Good balance of security vs. ease.

3

CAPTCHA Verification (CAPTCHA)

• Bot sends an image/text CAPTCHA.

• User must type the solution to verify.

• Strongest anti-bot protection.

---

Unverified Role System

When enabled:

• Bot creates an @Unverified role automatically.

• This role can only see the verification channel.

• Once verified, the role is removed and the user gets normal access.

Alternative: You can also set this role up manually.

---

Setup Examples

Basic Server Verification

• Use BUTTON for easy onboarding.

• Single @Member role is given after verification.

Security-Focused Server

• Use CAPTCHA or CALCULATOR.

• Add @Unverified role with restricted access.

• Whitelist role restoration to prevent restoring punished roles.

Community Server

• BUTTON or CALCULATOR for balance.

• Multiple join roles (e.g., @Introduced, @Community).

Gaming Server

• BUTTON + Role menu after verification.

• Gives @Player role automatically.

---

Common Issues & Solutions

“Verification not working”

• Make sure system is enabled.

• Check ChannelID is correct.

• Verify bot can send messages in that channel.

“Roles not being assigned”

• Replace all ROLE_ID with real IDs.

• Ensure bot’s role is higher than assigned roles.

“Users can’t see verification channel”

• Check @Unverified role permissions.

• Ensure @everyone can’t access other channels.

“Role restoration not working”

• Confirm RestoreRoles.Enabled: true.

• Check whitelist/blacklist setup.

“Calculator or CAPTCHA too difficult”

• Calculator only uses numbers 1–20 with addition/subtraction.

• CAPTCHA uses simple text recognition.

• Switch to BUTTON if you want less friction.

---

Security Considerations

• Anti-Bot Protection

  • BUTTON → easiest, least secure.

  • CALCULATOR / CAPTCHA → strongest security.

• Role Security

  • Don’t restore punishment roles (muted, banned).

  • Use whitelist for sensitive setups.

• Channel Security

  • Verification channel should be read-only except for bot.

  • Auto-delete verification attempts if needed.