Troubleshooting Guide

Solutions to common SAC Bot issues and problems

Installation Issues

Bot won't join server
  • Verify you can manage apps and bots in the server, and review any error Discord shows during authorization
  • Check if the bot is already in the server
  • Ensure the server isn't bot-limited by Discord
  • Try the invite link again after a few minutes
  • Check if the bot has been banned from the server
Invite link is invalid
  • Use the official invite link from our support server
  • Ensure you're using the correct client ID: 1509876788875231242
  • Check if Discord is experiencing service issues
  • Try refreshing the page and attempting again
Permissions not granted correctly
  • Review the permissions shown by Discord and ensure they match the features you have enabled; check the bot's role hierarchy and channel-specific permissions too.
  • Re-authorize the bot with the correct permissions
  • Check server verification level requirements
  • Ensure you have permission to manage bots in the server

⚡ Command Issues

Commands not responding
  • Check if the bot has the necessary permissions
  • Confirm the command appears in the current slash-command catalog; some prefix commands only redirect users to slash commands
  • Verify you're in a channel where commands are allowed
  • Check if the bot is online and connected
  • Try typing the command manually instead of using autocomplete
"Unknown command" error
  • Ensure you're using slash commands (not text commands)
  • Check if the bot has synced commands (try restarting Discord)
  • Verify the command name matches exactly (case-sensitive)
  • Check if the command requires specific permissions you don't have
Setup wizard not appearing
  • Try running /setup in a different channel
  • Check if the bot has permissions to create channels
  • Ensure you have the necessary role permissions
  • Check if the bot is rate-limited by Discord
  • Try using /start command instead

Security & Authentication Issues

Safe Mode not working
  • Run /safemode; first use may ask you to set a Safe Mode password
  • Verify you're using the correct password
  • Check if 2FA is required and you have it set up
  • Check the configured Safe Mode duration; the default is 30 minutes
  • Try using /status to check your status
2FA setup failing
  • Ensure you're using a compatible TOTP app (Google Authenticator, Authy, etc.)
  • Check that your device time is synchronized
  • Verify you're entering the code within the time window
  • Try scanning the QR code again if setup failed
  • Use /2fa action:setup, scan the QR, then confirm with /2fa action:confirm code:123456
Staff login not working
  • Verify your password was set correctly by an admin
  • Check if 2FA is required for staff login
  • Ensure your staff session hasn't expired (20 minutes)
  • If the server requires 2FA, the login form also needs your current authenticator code
  • Use /login to check your login status
  • Contact an admin to reset your password if needed

Security System Issues

Spam filter not detecting spam
  • Check spam and mention controls in /setup → Spam & Flood
  • For flood thresholds, use /floodprotect and the window_seconds option
  • Review available anti-spam controls in the Setup wizard; there is no separate /spampatterns slash command
  • Check if users are on the bypass list
  • Monitor logs to see if the system is triggering
Anti-alt not filtering new accounts
  • Verify Account Age is enabled in /setup → Security Settings
  • Check the minimum age threshold and action in the Setup wizard
  • Ensure the action is configured correctly
  • Check if users are on the bypass list
  • Test with a known new account to verify functionality
Lockdown not activating
  • Manually activate lockdown: /lockdown status:on
  • Check if lockdown is configured for automatic activation
  • Verify the bot has permission to manage channels
  • Check if users on bypass list can still send messages
CAPTCHA not sending
  • Configure CAPTCHA using /captchasetup
  • Ensure the CAPTCHA channel is set correctly
  • Check if CAPTCHA is enabled in settings
  • Manually send CAPTCHA: /captcha action:send
  • Verify the bot has permission to send messages in the channel

⚡ Performance Issues

Bot responding slowly
  • Check if Discord is experiencing API issues
  • Monitor bot status in our support server
  • Check if the bot is rate-limited by Discord
  • Review your server size and activity level
  • Consider disabling some security systems if performance is critical
Bot crashing or going offline
  • Check the bot's status in our support server
  • Contact support if the issue persists

Data & Configuration Issues

Settings not saving
  • Re-run /setup to reconfigure
  • Check that the bot has the required permissions in your server
  • Contact support with the time the problem occurred
Settings restore not offered after rejoin
  • Settings restore is only offered if the bot was removed recently
  • If you removed SAC Bot recently, re-add it within 60 days to see whether a settings backup is available. See the Privacy Policy retention details.
  • Contact support if you believe this is an error
Team management not working
  • Access team management through /setup wizard
  • Select "Team Management" from the setup wizard
  • Ensure you have admin permissions to manage team
  • Check if user IDs are being entered correctly
  • Verify the bot has permission to manage roles

💚 Getting Help

If you're still experiencing issues after trying these solutions:

  • Join our Support Server for direct assistance
  • Use the /faq command to search our knowledge base
  • Check the FAQ for common questions
  • Contact our support team through the support server
  • Provide detailed information about your issue including error messages and steps to reproduce
/faq question:"bot not responding"
/dashboard
/status
← FAQ Back to Documentation Home →