Common Issues

Verify Bot Status

• Confirm the bot is online
• Execute /ping to test bot responsiveness

Verify Permissions

• Bot requires "Send Messages" and "View Channel" permissions
• Verify channel-specific permissions

Check Role Position

• Bot's role must be positioned above roles it manages
• Navigate to Server Settings > Roles to verify hierarchy

Correct Role Hierarchy

1. Navigate to Server Settings > Roles
2. Drag the bot's role above all roles you want it to manage
3. Test role assignment again

Verify Role Names

• Ensure role names in the command match exactly
• Role names are case-sensitive

Verify Bot Permissions

• Bot requires "Manage Roles" permission

Verify Emoji Format

• Custom server emojis (including animated) are supported
• Unicode emojis (🎮📚🎵) are also supported
• Ensure the bot has access to custom server emojis

Verify Bot Permissions

• Bot requires "Add Reactions" and "Manage Messages" permissions
• Verify channel-specific permissions

Refresh Reactions

• Contact support to refresh reactions for a specific message
• This resolves most reaction-related issues

Enable XP System

1. Execute /xp settings command
2. Click the toggle to enable the XP system
3. Verify all XP types are enabled (message, command, role, voice)

Verify Cooldowns

• Message XP: 60-second cooldown between messages
• Command XP: 30-second cooldown between commands
• Users will not earn XP if they are in cooldown

Verify Activity

• Users must be actively messaging or using commands
• Voice activity requires users to be in voice channels
• Role assignments grant 50 XP per role

Verify Bot Permissions

• Bot requires "Move Members" permission to disconnect users
• Bot requires "Mute Members" permission to mute users
• Verify permissions in Server Settings > Roles > Bot Role

Verify Role Permissions

• Role must have "Connect" permission disabled to disconnect users
• Role must have "Speak" permission disabled to mute users
• Check role permissions in Server Settings > Roles

Test Voice Restrictions

• Assign a restrictive role to a test user
• Have the user join a voice channel
• Bot should automatically disconnect or mute them

Verify System Status

• Execute /welcome settings or /goodbye settings to verify it is enabled
• System may be disabled in settings
• Verify channel configuration

Verify Channel Permissions

• Bot requires "Send Messages" permission in the configured channel
• Bot requires "Embed Links" if using embed format
• Verify channel-specific permissions

Test Configuration

• Use test functionality if available
• Verify message format and placeholders
• Verify auto-role assignment if configured