Setting up fragbot on ServerPrism

fragbot is the official Discord bot for Fragforce, providing various utilities. This guide covers creating your bot application, inviting it to your server, configuring it on ServerPrism, and getting it online.

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., fragbot) and click Create.
4. Navigate to the Bot tab in the left sidebar.
5. Click Add Bot, then Yes, do it!.
6. Under TOKEN, click Reset Token, then Yes, do it!.
7. Copy this token immediately. You will need it for your ServerPrism configuration. Keep it secure; do not share it.
8. Under Privileged Gateway Intents, enable MESSAGE CONTENT INTENT. fragbot needs this to read messages and respond to commands.

Invite the bot to your server

1. Go to the OAuth2 tab, then URL Generator.
2. Under SCOPES, select bot and applications.commands.
3. Under BOT PERMISSIONS, select the permissions your bot needs. For fragbot, a good starting point includes:
   • Read Messages/View Channels
   • Send Messages
   • Embed Links
   • Attach Files
   • Manage Messages (if you want it to delete messages, e.g., for moderation)
4. Copy the generated URL at the bottom.
5. Paste the URL into your browser and select the Discord server you want to invite the bot to.
6. Click Authorize.

Order on ServerPrism

When ordering your Discord bot server on ServerPrism, 1 GB of RAM is usually sufficient for fragbot. Choose the region closest to your primary user base for optimal performance. Once ordered, your server will deploy, and the fragbot package will be pre-installed.

Configure startup variables

Your ServerPrism panel's Startup tab is where you configure fragbot using environment variables. These variables tell the bot how to connect to Discord and what prefix to use for commands.

Set the following variables:

• BOT_TOKEN: Paste the bot token you copied from the Discord Developer Portal.
• PREFIX: The command prefix your bot will respond to. A common choice is !. For example, if you set PREFIX to !, you'd use !help.
• OWNER_ID: The Discord User ID of the bot's owner. You can get your User ID by enabling Developer Mode in Discord (User Settings > Advanced) and then right-clicking your username and selecting Copy ID.

fragbot may require additional configuration depending on its features. Refer to the fragbot GitHub repository for any specific, advanced environment variables it might use for features like database connections or API keys.

First start

1. After setting the environment variables, navigate to the Console tab in your ServerPrism panel.
2. Click the Start button.
3. Watch the console output. A successful start typically shows messages indicating the bot is connecting to Discord and logging in, followed by a message like Bot is ready! or Logged in as fragbot#1234.
4. Your bot should now appear online in your Discord server.

Common issues

• Bot token rejected/invalid token: Double-check that BOT_TOKEN in your Startup tab is exactly the token you copied from the Developer Portal. Ensure there are no leading/trailing spaces.
• Bot online but not responding to commands: Verify that you enabled the MESSAGE CONTENT INTENT in the Discord Developer Portal under your bot's settings. Without this, the bot cannot read message content to process commands.
• Bot doesn't come online: Check the console for errors. Common issues include incorrect BOT_TOKEN or missing required environment variables. Ensure all necessary variables are set in the Startup tab.

Next steps

Now that fragbot is running, you can start exploring its commands. Use the !help command (or whatever prefix you configured) in your Discord server to see a list of available commands. For more advanced configuration or to understand specific features, consult the fragbot GitHub repository.