Verification

The verification system provides two main features: Join Roles (automatic role assignment when users join) and Verification System (require users to verify before accessing the server).

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.

Hint: 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.