Troubleshooting Guide

Bot isn't responding to commands

Symptoms: Commands are ignored, no reactions or replies

Quick checks:

1. Verify the bot is online: Check the member list - is the bot's status green?
2. Check the prefix: Default is !. Try !ping to test.
3. Permissions: Does the bot have "Send Messages" and "Embed Links" in the channel?
4. Role hierarchy: Bot's role must be above roles it needs to manage.

Solutions:

• Check service status for outages
• Re-invite the bot with proper permissions
• Check Discord's server outage status
• Use the dashboard to verify configuration

Moderation commands not working

Symptoms: !kick, !ban, !mute fail or show permission errors

Required permissions:

• !kick needs: Kick Members
• !ban / !unban need: Ban Members
• !mute needs: Moderate Members (timeout)
• !warn needs: Send Messages + Embed Links

Solutions:

1. Go to Server Settings → Roles → Sloth Lee
2. Enable required permissions listed above
3. Make sure bot role is above the roles it needs to moderate
4. Verify moderator roles are configured: !modrole list

Note: The bot cannot moderate members with higher roles than itself, including server owners.

Tickets not creating channels

Symptoms: Users click ticket button but nothing happens

Checklist:

1. Did you run setup? !ticketsetup must be run first
2. Permissions: Bot needs "Manage Channels" and "Manage Permissions"
3. Category limit: Discord allows max 50 channels per category. Check if category is full.
4. Channel limit: Discord allows max 500 channels per server.

Solutions:

• Run !ticketsetup to reconfigure
• Check bot permissions in Server Settings → Roles
• Clean up old ticket channels: !ticketcleanup
• Verify categories exist: !ticketcategory list

Music commands failing

Symptoms: !play errors, no audio, or bot disconnects

Requirements:

• Bot needs "Connect" and "Speak" permissions in voice channels
• You must be in a voice channel when using commands
• FFmpeg must be installed on the host (server-side, not user-side)

Solutions:

1. Join a voice channel first, then !play
2. Check voice channel permissions for the bot role
3. Try a different URL or search query
4. If self-hosting: verify FFmpeg installation

Automod not triggering

Symptoms: Spam/raids not being caught, no automatic actions

Verify configuration:

• !automodstatus - Check if automod is enabled
• !antispam - Verify spam detection settings
• !antiraid - Check raid protection settings

Common issues:

1. Whitelisted users/roles: Admins and whitelisted roles bypass automod
2. Thresholds too high: Lower detection thresholds for more sensitivity
3. Bot role position: Bot cannot moderate users with equal or higher roles
4. Missing permissions: Bot needs "Kick Members" or "Ban Members" for actions

Recommended settings:

Dashboard not loading or showing errors

Symptoms: Dashboard page blank, login fails, or data not displaying

Quick fixes:

1. Clear browser cache and cookies
2. Try incognito/private browsing mode
3. Re-authorize Discord OAuth connection
4. Check status page for service issues

Login issues:

• Make sure you have "Manage Server" permission in your Discord server
• Verify the bot is in your server
• Try logging out and back in to Discord

Anti-nuke accidentally banned someone

Symptoms: Legitimate admin/mod was banned by anti-nuke protection

Immediate recovery:

1. Server owner can use !approveappeal <appeal_id>
2. Or manually unban via Server Settings → Bans
3. Add them to whitelist: !whitelist @user

Prevention:

• Whitelist all trusted admins: !whitelist @Admin
• Whitelist admin roles: !whitelist @Administrator
• Adjust thresholds: !antinukeset role_creates 10
• Review configuration: !antinukeinfo