Skip to main content

​
Setup & Configuration Guide

Complete setup guide for configuring the Velveta Discord Bot in your server with all features and systems.
This guide covers initial setup, configuration options, and best practices for optimal bot performance and security.

​
Initial Setup

Required Permissions:
  • Send Messages
  • Embed Links
  • Manage Messages
  • Manage Roles
  • Read Message History
  • Use Slash Commands
  • Manage Webhooks (for verification)
1. Use bot invitation link with required permissions
2. Select target server (Manage Server permission required)
3. Review and confirm permission requests
4. Complete OAuth2 authorization
5. Bot will join and initialize basic settings
Insufficient permissions will cause command failures. Ensure the bot role has adequate permissions and proper hierarchy placement.

​
Core Configuration

Configure fundamental bot settings for your server:
• Set moderation log channel
• Configure verification system
• Set up welcome/farewell channels
• Configure role assignments
• Set prefix preferences (= default)
Basic configuration is required before advanced features like AI moderation and premium embeds will function properly.
Automated Role Management:
• Create verified role (for verification system)
• Set up moderation roles (for staff)
• Configure premium roles (optional)
• Set auto-role assignments
• Configure role hierarchy

​
Moderation System Setup

Complete Moderation Setup:
• Warning system with AI analysis
• Automated timeout management
• Ban/kick with case tracking
• Forced nickname system
• Channel management tools

​
AI-Powered Moderation

The moderation system includes AI-powered case analysis:
• Automatic warning analysis
• Context-aware risk assessment
• Pattern recognition for repeat offenders
• Suggested moderation actions
• Cross-server reputation tracking

​
Verification System Setup

Comprehensive Verification Setup:
• External verification website integration
• CAPTCHA and fraud protection
• Role-based access control
• Cross-server passport system
• Security monitoring

​
Security Features

Configure enhanced security features:
• VPN/proxy detection
• Account age requirements
• IP-based restrictions
• Rate limiting configuration
• Suspicious activity monitoring

​
Premium Features Setup

Premium Tier Setup:
• Advanced embed system
• Enhanced AI capabilities
• Welcome/farewell automation
• Booster recognition
• Priority support access

​
Embed System Configuration

Configure the premium embed system:
• Template management
• Variable substitution
• Auto-reply integration
• Reaction automation
• Custom styling options

​
Integration Setup

External Integration Setup:
• Verification completion notifications
• Moderation action logging
• Premium status updates
• Security alerts
• Custom integrations
External API Configuration:
• OpenAI for AI features
• Verification service API
• Premium billing integration
• Analytics and monitoring
• Third-party services

​
Channel Configuration

Recommended Channel Structure:
#verification - User verification
#mod-logs - Moderation logging
#welcome - New member welcomes
#farewells - Member departure messages
#announcements - Server announcements

​
Channel Permissions

Configure appropriate permissions for each channel:
• @everyone: Read Messages, Send Messages
• Unverified: Send Messages (verification command only)
• Bot: Full permissions
• Staff: Manage Messages

​
Testing & Validation

Comprehensive Testing Checklist:
✓ Bot responds to commands
✓ Permissions are working
✓ Logging is functional
✓ Roles are assignable
✓ Messages send properly

​
Test Commands

Use these commands to validate setup:
=ping - Check bot responsiveness
=help - Verify command accessibility
=serverinfo - Test embed functionality
=userinfo @user - Test user analysis

​
Maintenance & Updates

Regular Maintenance Tasks:
• Review moderation logs
• Check verification statistics
• Monitor AI usage metrics
• Update embed templates
• Review security alerts

​
Troubleshooting

Frequent Problems and Solutions:
Problem: Commands not working
Solution: Check bot role hierarchy and permissions

Problem: Cannot assign roles
Solution: Ensure bot role is above target roles

Problem: Missing embeds
Solution: Grant "Embed Links" permission

​
Best Practices

Recommended Practices for Optimal Performance:
• Regular permission audits
• Monitor verification attempts
• Review moderation logs daily
• Keep configurations updated
• Test features after changes