Loading documentation...

2xl

Troubleshooting

Common issues & solutions

Find solutions to common issues and get help with bot configuration, permissions, and functionality.

Diagnose Issues

🔍 Quick Diagnosis

Start here to identify and resolve common issues

Bot Status Check

First, verify the bot is online and responsive:

• Use/pingto test latency

• Check bot status in member list

• Verify bot has online status

Permission Check

Most issues are caused by missing permissions:

• Check bot role position in Server Settings › Roles

• Verify channel-specific permissions

• Ensure bot has necessary permissions enabled

🚨 Common Issues

Solutions to the most frequently encountered problems

Bot Not Responding

Commands are sent but bot doesn't reply

Possible Causes:

• Bot is offline or restarting
• Missing message permissions
• Commands disabled in channel
• Bot is rate limited

Solutions:

• Check bot status and uptime
• Verify "Send Messages" permission
• Try commands in different channels
• Wait a few minutes and retry

Music Not Playing

Music commands work but no audio plays

Possible Causes:

• Missing voice channel permissions
• Lavalink not configured (self-hosted)
• Voice channel is full
• Unsupported audio format

Solutions:

• Grant "Connect" and "Speak" permissions
• Check Lavalink status and configuration
• Try different voice channels
• Use supported audio sources

Commands Not Working

Specific commands fail or give errors

Possible Causes:

• Insufficient user permissions
• Command disabled in settings
• Syntax errors in command usage
• Bot lacks required permissions

Solutions:

• Check your role permissions
• Verify command is enabled in dashboard
• Review command syntax
• Check bot role permissions

Dashboard Not Loading

Cannot access the web dashboard

Possible Causes:

• Browser cache issues
• Discord authentication problems
• Server maintenance
• Network connectivity issues

Solutions:

• Clear browser cache and cookies
• Try incognito/private browsing
• Re-authorize with Discord
• Check internet connection

XP Not Updating

Members aren't gaining XP

Possible Causes:

• XP system disabled
• Channel excluded from XP
• Cooldown active
• Database connection issues

Solutions:

• Enable XP in dashboard settings
• Check channel XP settings
• Wait for cooldown period
• Contact support if persistent

Auto-Mod Not Working

Auto-moderation filters aren't triggering

Possible Causes:

• Filters not enabled
• Missing manage messages permission
• User/role exemptions
• Channel exclusions

Solutions:

• Enable filters in dashboard
• Grant required permissions
• Check exemption settings
• Review channel settings

🔧 Advanced Troubleshooting

Bot Permissions Audit

Complete permissions checklist:

General Permissions

• View Channels ✓

• Send Messages ✓

• Embed Links ✓

• Read Message History ✓

• Use Slash Commands ✓

Moderation Permissions

• Manage Messages ✓

• Manage Roles ✓

• Kick Members ✓

• Ban Members ✓

• Moderate Members ✓

Channel-Specific Issues

• Check channel permission overrides

• Verify bot is not muted in channel

• Ensure bot can see the channel

• Check for conflicting permissions

Role Hierarchy

• Bot role must be above roles it manages

• Check role positions in Server Settings

• Ensure bot has necessary role permissions

Voice Permissions

• Connect ✓

• Speak ✓

• Use Voice Activity ✓

• Priority Speaker ✓

🖥️ Self-Hosting Issues

Database Connection

• Verify database credentials

• Check database server status

• Ensure proper network access

• Review connection string format

Lavalink Setup

• Verify Lavalink is running

• Check Lavalink configuration

• Ensure proper port binding

• Review Lavalink logs for errors

Environment Variables

• Check all required env vars are set

• Verify token formats

• Ensure proper file paths

• Check variable naming

🆘 Getting Help

Support Resources

Discord Server

Join our support server

📚

Documentation

Check other sections of this docs

❓

FAQ

Visit our FAQ page

GitHub

Report issues on GitHub

What to Include in Support Requests

• Bot version and hosting type

• Exact error messages

• Steps to reproduce the issue

• Server permissions screenshot

• Relevant log entries

🛡️ Preventive Maintenance

Regular Checks

• Monitor bot uptime and performance

• Review permission settings periodically

• Keep bot and dependencies updated

• Backup configuration and data

• Test critical features regularly

Best Practices

• Set up proper role hierarchies

• Use channel-specific permissions wisely

• Configure auto-moderation carefully

• Monitor resource usage

• Have backup bot access

🚨 Emergency Procedures

If Bot Goes Offline

Check hosting provider status

Verify payment status

Check server resource usage

Review recent changes

Contact hosting support if needed

Data Recovery

• Check backup systems

• Verify database integrity

• Review recent exports

• Contact support for assistance

Still having issues? Join our Discord support server for personalized help.

🔗 Related Categories

Getting Started

Setup and installation guide

Bot Features

Explore all bot capabilities

Auto-Moderation

Automated moderation setup

Loading documentation...

Troubleshooting

Common issues & solutions

Find solutions to common issues and get help with bot configuration, permissions, and functionality.

Diagnose Issues

🔍 Quick Diagnosis

Start here to identify and resolve common issues

Bot Status Check

First, verify the bot is online and responsive:

• Use/pingto test latency

• Check bot status in member list

• Verify bot has online status

Permission Check

Most issues are caused by missing permissions:

• Check bot role position in Server Settings › Roles

• Verify channel-specific permissions

• Ensure bot has necessary permissions enabled

🚨 Common Issues

Solutions to the most frequently encountered problems

Bot Not Responding

Commands are sent but bot doesn't reply

Possible Causes:

• Bot is offline or restarting
• Missing message permissions
• Commands disabled in channel
• Bot is rate limited

Solutions:

• Check bot status and uptime
• Verify "Send Messages" permission
• Try commands in different channels
• Wait a few minutes and retry

Music Not Playing

Music commands work but no audio plays

Possible Causes:

• Missing voice channel permissions
• Lavalink not configured (self-hosted)
• Voice channel is full
• Unsupported audio format

Solutions:

• Grant "Connect" and "Speak" permissions
• Check Lavalink status and configuration
• Try different voice channels
• Use supported audio sources

Commands Not Working

Specific commands fail or give errors

Possible Causes:

• Insufficient user permissions
• Command disabled in settings
• Syntax errors in command usage
• Bot lacks required permissions

Solutions:

• Check your role permissions
• Verify command is enabled in dashboard
• Review command syntax
• Check bot role permissions

Dashboard Not Loading

Cannot access the web dashboard

Possible Causes:

• Browser cache issues
• Discord authentication problems
• Server maintenance
• Network connectivity issues

Solutions:

• Clear browser cache and cookies
• Try incognito/private browsing
• Re-authorize with Discord
• Check internet connection

XP Not Updating

Members aren't gaining XP

Possible Causes:

• XP system disabled
• Channel excluded from XP
• Cooldown active
• Database connection issues

Solutions:

• Enable XP in dashboard settings
• Check channel XP settings
• Wait for cooldown period
• Contact support if persistent

Auto-Mod Not Working

Auto-moderation filters aren't triggering

Possible Causes:

• Filters not enabled
• Missing manage messages permission
• User/role exemptions
• Channel exclusions

Solutions:

• Enable filters in dashboard
• Grant required permissions
• Check exemption settings
• Review channel settings

🔧 Advanced Troubleshooting

Bot Permissions Audit

Complete permissions checklist:

General Permissions

• View Channels ✓

• Send Messages ✓

• Embed Links ✓

• Read Message History ✓

• Use Slash Commands ✓

Moderation Permissions

• Manage Messages ✓

• Manage Roles ✓

• Kick Members ✓

• Ban Members ✓

• Moderate Members ✓

Channel-Specific Issues

• Check channel permission overrides

• Verify bot is not muted in channel

• Ensure bot can see the channel

• Check for conflicting permissions

Role Hierarchy

• Bot role must be above roles it manages

• Check role positions in Server Settings

• Ensure bot has necessary role permissions

Voice Permissions

• Connect ✓

• Speak ✓

• Use Voice Activity ✓

• Priority Speaker ✓

🖥️ Self-Hosting Issues

Database Connection

• Verify database credentials

• Check database server status

• Ensure proper network access

• Review connection string format

Lavalink Setup

• Verify Lavalink is running

• Check Lavalink configuration

• Ensure proper port binding

• Review Lavalink logs for errors

Environment Variables

• Check all required env vars are set

• Verify token formats

• Ensure proper file paths

• Check variable naming

🆘 Getting Help

Support Resources

Discord Server

Join our support server

📚

Documentation

Check other sections of this docs

❓

FAQ

Visit our FAQ page

GitHub

Report issues on GitHub

What to Include in Support Requests

• Bot version and hosting type

• Exact error messages

• Steps to reproduce the issue

• Server permissions screenshot

• Relevant log entries

🛡️ Preventive Maintenance

Regular Checks

• Monitor bot uptime and performance

• Review permission settings periodically

• Keep bot and dependencies updated

• Backup configuration and data

• Test critical features regularly

Best Practices

• Set up proper role hierarchies

• Use channel-specific permissions wisely

• Configure auto-moderation carefully

• Monitor resource usage

• Have backup bot access

🚨 Emergency Procedures

If Bot Goes Offline

Check hosting provider status

Verify payment status

Check server resource usage

Review recent changes

Contact hosting support if needed

Data Recovery

• Check backup systems

• Verify database integrity

• Review recent exports

• Contact support for assistance

Still having issues? Join our Discord support server for personalized help.

🔗 Related Categories

Getting Started

Setup and installation guide

Bot Features

Explore all bot capabilities

Auto-Moderation

Automated moderation setup