Troubleshooting Guide

Solutions to common SAC Bot issues and problems

� Installation Issues

Bot won't join server
  • Verify you have Administrator permissions
  • 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
  • Make sure to grant Administrator permission for full functionality
  • 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
  • Ensure commands are enabled in your server settings
  • 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
  • Check if you have set up a moderator password using /safemode
  • Verify you're using the correct password
  • Check if 2FA is required and you have it set up
  • Ensure your session hasn't expired (default 15 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 to restart the process
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 (default 20 minutes)
  • 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 if spam filter is enabled: /spamfilter enabled:true
  • Adjust the sensitivity thresholds: /spamfilter max_repeats:3
  • Add custom spam patterns: /spampatterns action:add pattern:"test"
  • Check if users are on the bypass list
  • Monitor logs to see if the system is triggering
Anti-alt not filtering new accounts
  • Verify anti-alt is enabled: /antialt enabled:true
  • Check the minimum age threshold: /antialt min_age:48
  • 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
  • Review error logs if available
  • Ensure the bot has proper system resources
  • Contact support if the issue persists

� Data & Configuration Issues

Settings not saving
  • Check if the bot has proper database connectivity
    • li>Verify your Firebase credentials are correct
  • Try using /setup to reconfigure
  • Check if there are any error messages in logs
  • Contact support if database issues persist
Settings restore not offered after rejoin
  • Settings restore is only offered if the bot was removed less than 60 days ago
  • Check if the removal timestamp was recorded correctly
  • If 60+ days have passed, you'll need to reconfigure from scratch
  • This is a security feature to prevent stale configuration restoration
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 →