Common Issues

Bot Not Responding

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

Roles Not Being Assigned

Most Common Cause: Bot's role is positioned below the roles it is attempting to assign

Correct Role Hierarchy

Navigate to Server Settings > Roles
Drag the bot's role above all roles you want it to manage
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

Command Errors

Refer to the Troubleshooting Guide for a complete list of error messages and solutions.

Reactions Missing

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

XP System Not Working

Most Common Cause: XP system is disabled by default and must be enabled by server administrators

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

Voice Permissions Not Working

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

Welcome/Goodbye System Not Working

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