Error Codes Reference

Complete reference for all Nexi Bot error codes. Use this guide to quickly identify and resolve issues.

How to Use: Error codes appear in bot responses. Find your error code below for specific solutions and determine if support is needed.

Database Error Codes (DB_XXX)

Error Code	Description	What to Do	Support Required
DB_001	Database connection failed	Wait 2-3 minutes and retry	Contact support if persists >5 minutes
DB_002	Database query failed	Try the command again	Contact support if happens repeatedly
DB_003	Database operation timed out	Wait 1 minute and retry	Normal during high load
DB_004	Database schema mismatch	Contact support immediately	Immediate support required
DB_005	Database permission denied	Contact support	Immediate support required
DB_006	Database connection failed	Wait and retry	Contact support if persists

Error Code	Description	What to Do	Support Required
CMD_001	Command not found	Use `/help` to see available commands	Check documentation first
CMD_002	Permission denied	Check bot and user permissions	Admin action needed
CMD_003	Invalid command arguments	Review command syntax	Check documentation
CMD_004	Command execution failed	Try again in 30 seconds	Contact support if persists
CMD_005	Command cooldown active	Wait for cooldown to expire	Normal behavior

Error Code	Description	What to Do	Support Required
MUS_001	Music play failed	Check URL or try different song	Contact support if all songs fail
MUS_002	Music search failed	Try different search terms	Contact support if always fails
MUS_003	Skip command failed	Check if you're in voice channel	Normal behavior
MUS_004	Stop command failed	Rejoin voice channel	Contact support if persists
MUS_005	Pause command failed	Check music permissions	Ensure bot can speak in VC
MUS_006	Resume command failed	Try stopping and replaying	Contact support if broken
MUS_007	Volume change failed	Check bot permissions	Admin action needed
MUS_008	Now playing display failed	Retry command	Contact support if UI broken
MUS_009	Queue command failed	Check if queue has songs	Normal if queue empty
MUS_010	Shuffle failed	Ensure queue has multiple songs	Normal behavior
MUS_011	Clear queue failed	Retry command	Contact support if persists
MUS_012	Lyrics fetch failed	Song may not have lyrics	Try different song
MUS_013	Song info failed	Try different song	Contact support if all fail
MUS_014	Skip to position failed	Check queue position	Ensure valid position
MUS_015	Radio mode failed	Check internet connection	Contact support if always fails

Error Code	Description	What to Do	Support Required
SYS_001	Interaction timeout	Command took too long, retry	Contact support if always slow
SYS_002	Rate limit exceeded	Wait 60 seconds before retry	Normal during high usage
SYS_003	Maintenance mode active	Wait for maintenance to complete	Check status page
SYS_004	Feature unavailable	Check feature status	Contact support if needed
SYS_005	Unexpected system error	Try again in 30 seconds	Contact support with details

Error Code	Description	What to Do	Support Required
CFG_001	Module not found	Retry `/config` command	Contact support if persists
CFG_002	Configuration update failed	Check permissions and retry	Admin action needed
CFG_003	Invalid configuration value	Review input format	Check documentation
CFG_004	Permission denied	Ensure Administrator permission	Admin action needed
CFG_005	Feature disabled	Enable feature in `/config`	Server admin action

Error Code	Description	What to Do	Support Required
PRM_001	Premium feature disabled	Upgrade to premium access	Purchase premium
PRM_002	Premium subscription expired	Renew premium subscription	Purchase renewal
PRM_003	Premium access denied	Check premium status	Contact support with receipt
PRM_004	Premium limit exceeded	Upgrade plan or wait	Consider higher tier
PRM_005	Premium integration failed	Check API keys	Contact support

Need More Help? If your error code isn't listed or the suggested solutions don't work, join our support server for assistance.