Setting up CorpBot on ServerPrism

CorpBot is a Python-based Discord bot with various features. This guide walks you through setting up your CorpBot instance on ServerPrism, from Discord Developer Portal configuration to initial startup.

Create your bot in Discord Developer Portal

1. Go to the Discord Developer Portal.
2. Click New Application.
3. Give your application a name (e.g., CorpBot Instance) and click Create.
4. Navigate to the Bot tab on the left sidebar.
5. Click Add Bot, then Yes, Do It!.
6. Under TOKEN, click Reset Token, then Yes, Do It!.
7. Copy the displayed token. You will need this for your ServerPrism panel.
8. Scroll down to Privileged Gateway Intents.
9. Enable Message Content Intent. CorpBot relies on reading message content for many of its commands.

Invite the bot to your server

1. Go to the OAuth2 tab, then click URL Generator.
2. Under SCOPES, select bot.
3. Under BOT PERMISSIONS, select the permissions your bot needs. For a general-purpose bot like CorpBot, common choices include:
   • Read Messages/View Channels
   • Send Messages
   • Embed Links
   • Attach Files
   • Manage Messages (if the bot has moderation features)
   • Kick Members / Ban Members (if you plan to use moderation commands)
4. Copy the generated URL at the bottom of the page.
5. Paste this URL into your browser and press Enter.
6. Select the Discord server you want to add the bot to and click Authorize.

Order on ServerPrism

You've already ordered your ServerPrism Discord Bots product and selected CorpBot. The typical 1 GB RAM allocation is usually sufficient for CorpBot. Your server is deployed in your chosen region, ready for configuration.

Configure startup variables

1. Log in to your ServerPrism panel.
2. Navigate to your CorpBot server instance.
3. Click on the Startup tab.
4. You will see fields for environment variables. Configure the following:
   • BOT_TOKEN: Paste the bot token you copied from the Discord Developer Portal.
   • PREFIX: Set the command prefix for your bot (e.g., !, /, cb!). This is what users will type before commands.
   • OWNER_ID: Enter your Discord User ID. This grants you special owner-level permissions for the bot. To find your User ID, enable Developer Mode in Discord (User Settings > Advanced), then right-click your username and select Copy ID.
   • MONGODB_URI: CorpBot can use MongoDB for data storage. If you plan to use features requiring persistent data, provide a MongoDB connection string here. If you don't have one, you can leave this blank, but some features may not work. You can set this up later if needed.

First start

1. After configuring your startup variables, go to the Console tab in your ServerPrism panel.
2. Click the Start button.
3. Monitor the console output. A successful startup will show messages indicating the bot is connecting to Discord and logging in. You should see output similar to:

   [INFO] CorpBot.py started!
   [INFO] Logged in as CorpBot Instance#1234 (123456789012345678)
   

4. Check your Discord server. Your bot should appear online in the member list.

Common issues

• Bot token rejected/Invalid Token: Double-check the BOT_TOKEN in your Startup tab. Ensure there are no extra spaces and it's the correct token from the Discord Developer Portal.
• Bot online but not responding to commands: Verify that Message Content Intent is enabled in the Discord Developer Portal under your bot's settings. Also, ensure your PREFIX variable is correctly set and you are using it in Discord (e.g., !help). Check the console for any error messages related to command parsing.
• Bot goes offline immediately after starting: Review the console for Python traceback errors. This often indicates a misconfiguration or a missing dependency, though ServerPrism pre-installs common dependencies for CorpBot. If you see errors related to pymongo, ensure your MONGODB_URI is correct or remove it if you don't intend to use MongoDB.

Next steps

Now that your CorpBot is running, you can start using its commands in your Discord server. Refer to the CorpBot.py GitHub repository for a list of available commands and further configuration options. Explore the bot's features and customize it to your server's needs.