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

Commands

Command Description Permissions
/verify Start verification process None
/verification stats View verification statistics Administrator
/verification reset <user> Reset user’s verification Administrator

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

Process Flow

  1. Member Join: User joins server
  2. Role Assignment: Gets unverified role (restricts access)
  3. DM CAPTCHA: Receives verification challenge
  4. Response Submission: User replies with CAPTCHA text
  5. Validation: System checks response
  6. Role Update: Verified role assigned on success

Security Features

  • Unique CAPTCHAs: Each challenge is unique
  • Time Limits: Prevent prolonged attempts
  • Attempt Limits: Maximum verification tries
  • IP Tracking: Prevent abuse from same source
  • Logging: Complete audit trail

Integration

Works with:

  • Tiers: Post-verification XP bonus
  • Economy: Verification rewards
  • Moderation: Verification status checking
  • Vor Sentinel: Enhanced bot detection

Best Practices

  1. Clear Instructions: Explain verification process
  2. Reasonable Time Limits: Don’t frustrate legitimate users
  3. Accessible CAPTCHAs: Ensure readability
  4. Monitor Effectiveness: Track bot prevention success
  5. 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