Passa al contenuto principale

Troubleshooting Custom-Bot Issues

This guide helps you resolve common issues with your SCNX Custom-Bot. If your issue is related to a specific module, check the module-specific troubleshooting section below.

General issues​

Bot is offline​

The bot is not online on Discord
  • Open your Bot Status Panel and check if the bot is running.
  • If the bot is stopped, click "Start bot" to bring it online.
  • If the bot shows as running but appears offline in Discord, wait a few minutes - Discord can take up to 5 minutes to update the status.
  • Try restarting the bot from the Bot Status Panel.
  • Check the error log in your dashboard for any startup errors.

Bot is not responding to commands​

The bot does not respond when using slash commands
  • Make sure the bot is online (see Bot is offline).
  • Ensure the bot has been invited to your server with the correct permissions. Re-invite the bot from your dashboard if needed.
  • Make sure the bot has View Channel and Send Messages permissions in the channel you are using.
  • Check if the command is restricted to specific roles or channels in your Discord server settings (Server Settings > Integrations).
  • Try reloading the bot's configuration from the Bot Status Panel.

Slash commands are not showing up​

Slash commands are not visible in the command picker
  • Make sure the module that provides the command is enabled in your dashboard.
  • After enabling a module, reload your bot's configuration or restart the bot.
  • Discord can take up to an hour to sync slash commands globally. Try restarting your Discord client.
  • Check that the bot has the applications.commands scope. You can verify this by re-inviting the bot from your dashboard.
  • Make sure the command is not restricted via Discord's integration permissions (Server Settings > Integrations > your bot).

Permission issues​

Missing Access / Missing Permissions​

Many issues with the Custom-Bot are caused by missing permissions. If the bot is not working as expected, the error log in your dashboard will often show errors like "Missing Access" or "Missing Permissions".

Here are the most common permission-related issues and how to resolve them:

Missing Access

The bot cannot see the channel it needs to operate in. To fix this:

  1. Go to the channel settings in Discord.
  2. Open the "Permissions" tab.
  3. Add the bot's role (or the bot itself) and grant View Channel permission.
  4. If the channel is in a category, make sure the bot also has access to the category.
Missing Permissions to send messages

The bot can see the channel but cannot send messages. Grant the bot the following permissions in the channel:

  • Send Messages
  • Embed Links (required for embeds)
  • Attach Files (if the bot needs to send images or files)
Missing Permissions to manage roles

The bot cannot assign or remove roles. To fix this:

  1. Make sure the bot has the Manage Roles permission on your server.
  2. In the server's role hierarchy (Server Settings > Roles), the bot's role must be above any role it needs to assign or remove.
  3. The bot can never manage roles that are higher than or equal to its own highest role.
Missing Permissions to manage channels

The bot cannot modify channel settings (e.g., for channel stats, temp channels, or locking). Grant the bot the Manage Channels permission on the server or on the specific channels.

Missing Permissions to moderate members

The bot cannot mute (timeout) members. Make sure:

  • The bot has the Moderate Members permission.
  • The bot's role is above the target user's highest role in the role hierarchy.
Missing Permissions to kick or ban members

Make sure:

  • The bot has the Kick Members and/or Ban Members permissions.
  • The bot's role is above the target user's highest role in the role hierarchy.
  • The target user is not the server owner (the server owner can never be kicked or banned).

Cannot change server owner's nickname​

The bot cannot change the nickname of the server owner. This is a Discord limitation that applies to all bots, regardless of their permissions or role position. There is no workaround for this.

Configuration issues​

Changes to configuration are not being applied
  • After changing configuration options in the dashboard, you need to reload your bot's configuration from the Bot Status Panel.
  • Some changes (like enabling new modules) may require a full bot restart.
  • Check the error log for any configuration-related errors.
Invalid configuration values
  • Make sure all required fields are filled in.
  • Check that channel and role IDs are valid and that the referenced channels/roles still exist on your server.
  • For embed configurations, make sure you are using a valid color value.
  • Check the error log in your dashboard for specific error messages about invalid configuration.

Common log errors​

Here are common errors you might find in your bot's error log and what they mean:

ErrorMeaningSolution
Missing AccessThe bot cannot see a channel.Grant the bot View Channel permission in the affected channel.
Missing PermissionsThe bot lacks a required permission for an action.Check which permission is needed and grant it to the bot.
Unknown ChannelA configured channel no longer exists.Update your configuration to use a valid channel.
Unknown RoleA configured role no longer exists.Update your configuration to use a valid role.
Unknown MessageA referenced message was deleted.Reconfigure the module or let the bot recreate the message.
Invalid Form BodyA message or embed exceeds Discord's character limits.Shorten your configured messages or embed content.
DiscordAPIError[50013]The bot lacks permissions for the action.Review and fix the bot's permissions (see Permission issues).
DiscordAPIError[50001]The bot cannot access the resource.Grant the bot access to the channel or resource.
DiscordAPIError[30005]Too many roles on the server.Discord limits the number of roles. Remove unused roles.

Using the error log​

The error log is your most important tool for diagnosing issues. You can find it in your Bot Status Panel.

  1. Open your dashboard and click on "Error log".
  2. Look for recent error messages that match the timeframe of your issue.
  3. The error message usually contains the name of the module and a description of what went wrong.
  4. If you cannot resolve the issue yourself, share the error log with the SCNX support team.

Module-specific troubleshooting​

If your issue is related to a specific module, check its troubleshooting section for targeted help:

Administration modules​

Bot modules​

Community modules​

Games & Fun modules​

Integration modules​

Moderation modules​

Support modules​

Tool modules​

Still need help?​

If none of the above solutions resolve your issue:

  1. Check the error log in your dashboard for specific error messages.
  2. Try reloading your bot's configuration or restarting your bot.
  3. Contact the SCNX support team and share your error log for further assistance.