Verification Cog

The Verification cog provides a CAPTCHA-based system to prevent bot accounts from joining your server. New members must complete a verification challenge before gaining access.

Features

CAPTCHA System

  • Image CAPTCHAs: Generated text challenges
  • Number/Letter Options: Configurable character types
  • Length Control: Adjustable CAPTCHA complexity
  • Case Sensitivity: Optional case requirements

Verification Process

  • Automatic Assignment: New members get verification role
  • DM Delivery: CAPTCHA sent via direct message
  • Time Limits: Configurable completion windows
  • Retry System: Multiple attempt allowance

Access Control

  • Verified Role: Automatic role assignment on success
  • Channel Restrictions: Limit access until verified
  • Role Removal: Remove unverified roles
  • Kick Options: Remove unverified members

Logging & Monitoring

  • Verification Logs: Track all verification attempts
  • Success/Failure Stats: Monitor system effectiveness
  • Audit Trails: Complete verification history
  • Admin Alerts: Notify of verification issues

Features

CAPTCHA Verification System

  • Image-based CAPTCHA challenges to prevent bots
  • Configurable character types (alphanumeric or numbers-only)
  • Adjustable character count (6-15 characters)
  • Automatic role assignment on successful verification

Verification Process

  • New members automatically receive unverified role
  • CAPTCHA sent via direct message
  • Members complete challenge and submit response
  • Verified role automatically assigned on success

Access Control

  • Verified role grants full server access
  • Unverified members can be restricted from channels
  • Configurable timeout before kicking unverified users

Logging & Monitoring

  • Track all verification attempts
  • Success and failure statistics
  • Complete audit trail of verification events

Commands

Command Description
/verification view_config View current verification configuration

Configuration

  • Enabled: Toggle verification system
  • Numbers Only: Use numbers instead of letters
  • CAPTCHA Length: Number of characters (6-15)
  • Verified Role: Role granted on successful verification
  • Verification Channel: Where verification embed is posted
  • Log Channel: Where verification events are logged

Configuration

Set up verification in your server:

  • Enabled - Toggle verification system
  • Numbers Only - Use numbers only (no letters) for CAPTCHA
  • CAPTCHA Length - Number of characters in CAPTCHA (6-15)
  • Verified Role ID - Role granted upon successful verification
  • Verification Channel ID - Channel where verification embed appears
  • Log Channel - Channel for verification event logging

Process Flow

  1. User joins server
  2. Unverified role is automatically assigned
  3. CAPTCHA challenge sent via direct message
  4. User replies with CAPTCHA text
  5. System validates response
  6. Upon success, verified role is granted and unverified role removed

Best Practices

  1. Create a dedicated verification channel
  2. Set up a welcome channel explaining the verification process
  3. Configure a log channel to monitor attempts
  4. Choose appropriate CAPTCHA complexity for your community

  5. Use a verification role that grants access to other channels

  6. Clear Instructions: Explain verification process
  7. Reasonable Time Limits: Don’t frustrate legitimate users
  8. Accessible CAPTCHAs: Ensure readability
  9. Monitor Effectiveness: Track bot prevention success
  10. User Support: Help users with verification issues

Troubleshooting

  • DM Issues: Ensure bot can send DMs
  • Role Hierarchy: Check role permission hierarchy
  • CAPTCHA Generation: Verify image generation works
  • Time Limits: Adjust for user experience
  • False Positives: Review failed verifications

Statistics

  • Success Rate: Percentage of successful verifications
  • Average Time: Time to complete verification
  • Failure Reasons: Common failure causes
  • Bot Prevention: Estimated bots blocked