Skip to main content

Bots on SCNX

This documents contains guides applicable for both the Custom Bot and the Modmail Bot - if you want to set up these bots, follow the Get started with Custom Bot or the Get started with Modmail-Bot guides.

Troubleshooting​

The steps to troubleshoot are different between the two bots. Please continue in the two different troubleshooting guides:

The Basics​

Each bot on SCNX is its own process running on a real, physical server. You can manage the process in your Bot-Status-Panel of your Modmail- or CustomBot- Dashboard.

Here's an example of a Custom-Bot-Status-Panel:

As you can see, there are quite a few things you can do here. Here are the main ones you are going to need to know about:

  • The tag and profile picture of your bot (only visible if your bot is online). To change the profile of your bot, simply click on this or follow this guide.
  • "Reload configuration": When you reload your configuration, your bot will automatically apply all changes you have made to your configuration files (including Module-Changes) without any downtime. Generally speaking, you should use this rather than restarting your bot.
  • "Restart bot": This restarts the process of your bot. This might take multiple minutes and involve a high downtime, in which your bot is unreachable. You should only restart your bot if you get asked to do this, are experiencing weird issues or want to apply an update.
  • "Stop bot": This shuts down the process of your bot. It won't be reachable on Discord. It might take up to five minutes for your bot to be displayed as offline in Discord.
  • "Log" / "Error log": In these Logs-Files your bot documents what it's doing and writes down the reason for failures or issues. Our staff (and technical experts) need these logs to diagnose problems and offer your solutions - or if they are bugs in the bot themselves - to fix them. You might get asked to share them.
  • Language: This is the (human) language your bot will use for any default-configuration-values and messages that can't be configured. Modmail might, in some cases, use the language of the user that is executing a command instead of this value. You can always change the language of your bot.
  • Server: This is the physical server - also called Bot-Host - your bot is being hosted on. You can change the Bot-Host if you want.
  • Branch (only available for Custom-Bots): The branch is a completely different code base for your bot. You should leave this on "v3" (Stable version), but can change it to the "beta"-Branch (Public beta; might be unstable).
  • Version (only visible for Custom-Bots): This is a unique number identifying a published code-version. Depending on your version, your bot might not be able to use certain new features or take advanced of newly published releases. If your version is not up-to-date, you'll find a warning indicating this. Your Modmail is always up-to-date. Learn more about Updates & Versions.
  • RAM / CPU Values: These are right below the "Online"-Status. You can safely ignore them, they are only there as a gimmick and show the RAM / CPU Usage of your Bot. These are irrelevant as SCNX is automatically optimizing your bot if it is eating more RAM than it should.

Bot-Updates​

  • We publish regular updates for Custom-Bots - we usually bundle a bunch of features into one release for the public version. For the beta version, there are a bunch of releases, sometimes even multiple ones a day.
  • Your Bot will send a message in your Bot-Log-Channel (if configured) when a new update is available.
  • We'll announce every update on our Discord-Server and post a link to the changelog there.
  • You can find all changelogs in your Bot-Dashboard and on our Changelog page.
  • To apply the newest version of the Custom-Bot ("upgrade"), simply restart the Bot in your Bot-Dashboard (updates will only apply when there's an update notice visible). Updates are always free of charge.
  • You won't be able to use certain features if your bot is not on the latest version until you upgrade to a newer version.

Participate in Public Beta​

Before joining the public beta please keep in mind:

  • Public Beta Releases might be unstable. This means that your bot might crash or certain features might stop working without any reason.
  • New features in Public Beta Releases might be untranslated. This means that your bot might speak English instead of a configured language in new features.
  • While you can leave the Public Beta anytime, it might break your bot when the Beta-Version is on a higher release number than the older version. Additionally, configuration files might be corrupted after switching back and need to be reset, leading to data-loss.

Here are the steps to join the Custom-Bot beta:

  1. Open the Bot-Dashboard.
  2. In the Status-Panel, click on "Change" next to the "Branch"-Setting.
  3. Select "Public Beta (might be unstable)".
  4. Confirm your change by clicking "Confirm".
  5. To receive update-notifications about Beta-Releases on our Discord, opt-in to the Beta-Channels in #beta.

Here are the steps to leave the Custom-Bot beta:

  1. Open the Bot-Dashboard.
  2. In the Status-Panel, click on "Change" next to the "Branch"-Setting.
  3. Select "Stable Version (recommended)".
  4. Confirm your change by clicking "Confirm".

Change Bot-Host​

The Bot-Host is the physical server your bot is running on. We offer several Bot-Hosts running in different regions of the world. Here's how to switch a Bot-Host:

  1. Open the Modmail- or CustomBot- Dashboard.
  2. Next, click "Change" next to "Server" in the "Status"-Section.
  3. Select the Bot-Host you want to switch to.
  4. Save the changes.
What is the difference between a Bot-Host labeled "Premium" and other Bot-Hosts?
  • Most of these Bot-Hosts are located in North America and have a faster connection to Discord's infrastructure.
  • Premium Hosting infrastructure (higher reliability, higher bandwidth, …).
  • Each Bot is allocated more resources.
  • Premium Bot-Hosts are configured to take twice as many backups and store them offsite than other Bot-Hosts.
Which Bot-Host is the best? / Which Bot-Host should I choose?

Ultimately, it doesn't matter (except for the Premium-Servers). Each Bot-Host is designed to host bots, just like yours. We have high-quality standards for each of the hosts and can guarantee the same experience on each of them. We might even move your bots around if you do not have a paid plan to distribute resources.

I was asked to give up certain European Data Protection Rights when moving my bot outside the EU

When you move your bot's data outside the European Union, the General Data Protection Regulation won't apply to your data anymore. This is only affecting your bot's data, like Leveling-Stats, configuration and the actual hosting of the bot. Please also keep in mind that Discord themselves are also storing most of their data outside the EU, and we only work with trusted hosting providers with high-security & privacy standards; the data protection laws of the country will apply. This sometimes means that we are unable to protect your data from being used / inspected by state agencies. As is legal requirement (at least for our EU customers ♥), you have to agree to such data transfer. You can always switch back the hosting location of your bot to Bot-Host inside the EU.

Change Bot-Language​

The (human) language your bot will be used for any default-configuration-values and messages that can't be configured. Modmail might, in some cases, use the language of the user that is executing a command instead of this value.

info

Changing your Bot-Language will not re-generate already generated or configured configuration files - you'll need to either reset these files or translate fields yourself.

To change the language of your bot, please

  1. Open the Modmail- or CustomBot- Dashboard.
  2. Next, click "Change" next to "Server" in the "Status"-Section.
  3. Select the new language you want to switch to.
  4. Save the changes. Your bot will automatically restart to apply the changes.

The language of my server is not supported

We're sorry to hear that your language is not supported by SCNX. However, we are quite a small team here at ScootKit with very limited resources and can currently not afford to add support for other languages except German and English. Feel free to reach out to our team if you want to help translate, but please understand that we might not be able to accept your request. We'd definitely love to support every language of the world, but first we need to focus on our current Target-Groups.

Remove mentions of SCNX​

Included in these plans

Not included in the Starter-Plan (free for ever)
Not included in the Active-Guild-Plan (€3.00 / month)
Included in the PRO-Plan (€6.00 / month)
Compare SCNX PlansUpgrade SCNX PlanLearn more about pricing on SCNX
Final prices depend on your currency and payment interval and will be displayed before purchase.

You can always edit the footer of every editable message on SCNX, but you can also overwrite the default value used by every message that is missing a configuration field or where you did not set a different footer manually.

To remove the "Powered by scnx.xyz ⚡" from every embed of your bot, please follow these instructions:

  1. Open the Messages & Appearance configuration file of your bot's built in configuration.
  2. Change the "Embed-Footer" and "Embed-Footer-Image-URL" value to your liking. You can obtain an image URL in your files panel - simply upload a file and click on "Copy public URL".
  3. Save the changes & restart your bot to apply these changes.

Change username, About Me or Profile-Picture of my bot​

Before you continue
  • For this to work, your bot needs to be online on SCNX. If your bot is not online in SCNX, please visit the troubleshooting guide.
  • If you are not the owner of the server, you'll need "Manage Bot" Trusted-Admin permissions on the product you want to edit.

You can change the Profile-Picture and username of your bot without ever leaving SCNX:

  1. Open the Modmail- or CustomBot- Dashboard.
  2. Next, click on the username of your bot in the Bot-Status-Panel (if you used the links above you can skip this steps, the modal will open automatically).
  3. Enter the details you want to change and upload a new Profile-Picture. You'll find a live-preview of your bot's profile.
  4. Save the changes.
  5. It might take a few minutes for the changes to propagate to Discord, so please be patient.

An issue occurred when I tried changing my bot's profile
  • Please make sure your bot is online and running without issues. Refer to the troubleshooting guides if this is not the case.
  • Some usernames are reserved or over-used and can not be used for your bot. Try another, less common username.
  • Uploading your image to SCNX uses your account's storage spaces. Please open your Files-Dashboard and check if there's enough space left for the new Profile-Picture.
  • You (or your bot) might be rate-limited. Please try again in 1-4 hours.
  • You'll find the exact reason for this issue in your Bot's log. Please share your logs and try finding the issue in them. If you are unsuccessful, please contact our staff.

Invite my Bot​

Before you continue
  • For this to work, your bot needs to be online on SCNX. If your bot is not online in SCNX, please open the "The Bot is not on my sever" section in the right troubleshooting guide.
caution

Your bot will not work on other servers than the server it was created for. If you want to switch to another server, please follow the transfer SCNX data guide in our FAQ. If you want a bot for another server, please first add your server to SCNX and then set up the Custom-Bot.

  1. Open the Modmail- or CustomBot- Dashboard.
  2. Next, click on "Advanced options" in the bot status card.
  3. Click on "View Invite-URL" and click on "Copy Invite-URL to clipboard".
  4. Click on "Cancel".

Sharing Logs​

Before we start, a quick explanation about Logs and why you might get asked to share them. Each bot is its own process on SCNX, hosted on a real, physical server. As such process, it generates log files. In these logs files your bot documents what it's doing and writes down the reason for failures or issues. Our staff needs these logs to diagnose problems and offer your solutions - or if they are bugs in the bot themselves - to fix them.

info

Sharing your logs is a "one-time-capture" of them - they won't get updated as your bot writes new lines. Shared logs expire 7 days after sharing. Logs don't usually contain any sensitive information, but please check them before publishing logs publicly.

caution

Please don't waste the time of our staff if you find something in your log. It's normal that your bot sometimes logs issue, and we get these reported automatically. Only share them if you are experiencing an actual issue using your bot.

Here's how you can share the logs of your bot:

  1. Open the Modmail- or CustomBot- Dashboard.
  2. Next, click on "More options" in the Bot-Status-Panel.
  3. Click on "Share your bot's logs" and then press the button "Share logs". Your Bot-Host will now upload the logs of your bot to paste.scootkit.net. This might take a few seconds.
  4. Copy both the log URL and error log and send them both to our staff to investigate. If you have technical experience, you might also be able to use the logs to diagnose the issue yourself.

Change Bot-Token​

danger

You can only change your token in the Dashboard. Never send a token to another user, trusted-admins or a member of our staff. Treat tokens like a password - users with access to your token are able to use your bot to perform harmful actions.

caution
  • You need to be the owner of the server to change the Bot-Token.
  • Changing your bot's token will not solve any issues you are experiencing. Please use the troubleshooting guide to diagnose and fix them like the Pro you are 😉
  • If you want to change the username or profile picture of your bot, follow this guide.
  • Changing your Bot's token might create new issues or complications. Please avoid changing your token if possible.

You can change the token of your Bot easily without needing to delete your Bot from SCNX. Please follow these steps:

  1. Open the Discord Developer Panel and obtain a new token: First select your application, go to the "Bot"-Site and then click on "Regenerate token", and copy the result.
  2. Open the Modmail- or CustomBot- Dashboard.
  3. Click on "More options" in the "Status"-Panel of your bot.
  4. Click on "Change Bot-Token".
  5. Enter your new Bot-Token and confirm it by pressing "Change token".
  6. Your token will be saved and your bot will restart to apply the changes.

If your bot is not working afterward, please follow the troubleshooting guide.

Delete Bot​

danger

Deleting your Bot is irreversible and does not only delete your configuration, it also removes data (like Leveling-Stats, or Ticket-Data).

caution
  • You need to be the owner of the server to delete a bot.
  • Deleting your bot will, most likely, not solve any issues you are experiencing. Please use the troubleshooting guide to diagnose and fix them like the Pro you are 😉
  • If you want to change the username or profile picture of your bot, follow this guide.

We're sorry that you want to leave SCNX - if you are only experiencing an issue with SCNX, we are happy to help on our Discord.

To permanently delete your bot, please follow these instructions:

  1. Open the Modmail- or CustomBot- Dashboard.
  2. Next, click on "More options" in the Bot-Status-Panel.
  3. Select "Delete a bot".
  4. You'll be asked to select a reason (you won't need to elaborate) for deletion. Next, start your request using the " Initiate Bot-Deletion request"-Button.
  5. You'll receive a DM to confirm your deletion request. Use the button below the message to execute the data deletion.
  6. After confirming, our system will delete your bot from SCNX. This might take 1-5 minutes.
  7. You'll receive confirmation once we've deleted your bot from SCNX.