Setting up Sinusbot on ServerPrism

Sinusbot is a powerful music bot for Discord and TeamSpeak. This guide focuses on getting your Sinusbot instance running for Discord on your ServerPrism server.

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., "My Sinusbot") 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! to reveal your bot's token. Copy this token immediately; you will need it for your ServerPrism configuration. Keep this token private!
7. Scroll down to Privileged Gateway Intents.
8. Enable the Message Content Intent toggle. Sinusbot needs this to read commands and links from messages.

Invite the bot to your server

1. In the Discord Developer Portal, go to the OAuth2 tab, then URL Generator.
2. Under SCOPES, select bot.
3. Under BOT PERMISSIONS, select the following:
   • Read Messages/View Channels
   • Send Messages
   • Connect
   • Speak
   • Use Voice Activity
4. Copy the generated URL at the bottom of the page.
5. Paste this URL into your browser and press Enter. Select the Discord server you want to add the bot to and authorize it.

Order on ServerPrism

You've already ordered your Discord Bots product and selected Sinusbot as your runtime. For a music bot, 1 GB of RAM is usually sufficient for a single instance. Your server is now deployed in your chosen region.

Configure startup variables

Your Sinusbot instance on ServerPrism uses environment variables for configuration. You set these in the Startup tab of your server panel.

1. BOT_TOKEN: Paste the bot token you copied from the Discord Developer Portal here.
2. PREFIX: Set the command prefix for your bot (e.g., !). Users will use this before commands like !play.
3. TS3_ENABLED: Set to false if you are only using Discord. (Sinusbot is also a TeamSpeak bot).
4. TS3_API_KEY: Leave blank if TS3_ENABLED is false.
5. YOUTUBE_API_KEY: (Optional, but highly recommended for YouTube playback). Obtain a YouTube Data API v3 key from the Google Cloud Console. Without this, YouTube playback may be unreliable or fail.

Refer to the Startup tab in your panel for all available configuration options.

First start

1. After setting your environment variables in the Startup tab, navigate to the Console tab.
2. Click the Start button.
3. Monitor the console output. A successful start will show messages indicating the bot is connecting to Discord and initializing its services. Look for messages like "Discord bot connected!" or similar.
4. Check your Discord server. Your bot should appear online in your member list.
5. Join a voice channel and try a command, e.g., !play [YouTube URL] (using your configured prefix).

Common issues

• Bot not coming online/Token rejected: Double-check your BOT_TOKEN in the Startup tab. Ensure there are no extra spaces and it's the exact token from the Discord Developer Portal.
• Bot online but not responding to commands: Verify the Message Content Intent is enabled in the Discord Developer Portal under your bot's settings. Also, ensure the bot has the necessary permissions (especially Send Messages) in your Discord server's channel settings.
• YouTube playback issues: Ensure you have a valid YOUTUBE_API_KEY configured. Without it, YouTube functionality is severely limited or broken.
• Bot doesn't join voice channel: Ensure the bot has Connect and Speak permissions in the voice channel you are in.

Next steps

Explore Sinusbot's advanced features, such as adding more music sources or configuring custom commands. Refer to the official Sinusbot documentation for in-depth information on its capabilities.