Setting up Muse on ServerPrism

Muse is a self-hosted Discord music bot that streams audio from YouTube and Spotify. This guide walks you through creating your bot in Discord, inviting it to your server, and configuring it on your ServerPrism instance.

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., Muse Bot) and click Create.
4. In the left sidebar, navigate to Bot.
5. Click Add Bot and confirm by clicking Yes, Do It!.
6. Under TOKEN, click Reset Token and then Yes, do it! to reveal your bot token. Copy this token immediately and keep it safe. You will need it later.
7. Scroll down to Privileged Gateway Intents.
8. Enable the Message Content Intent toggle. Muse needs this to read commands and song requests from messages.

Invite the bot to your server

1. In the left sidebar, go to OAuth2 > URL Generator.
2. Under SCOPES, select bot.
3. Under BOT PERMISSIONS, select the following:
   • Read Messages/View Channels
   • Send Messages
   • Embed Links
   • Attach Files
   • Manage Messages
   • Read Message History
   • Connect
   • Speak
   • Use Voice Activity
   • Priority Speaker
   • Mute Members
   • Deafen Members
   • Move Members
4. Copy the generated URL at the bottom of the page.
5. Paste the URL into your browser, select your Discord server from the dropdown, and click Authorize.

Order on ServerPrism

If you haven't already, order your Discord Bots server on ServerPrism. For Muse, 1 GB of RAM is usually sufficient for a moderate number of users and concurrent streams. Choose a region closest to your primary user base for the best audio experience. Once your server is deployed, you'll receive access to your panel.

Configure startup variables

Your ServerPrism panel's Startup tab allows you to set environment variables required by Muse. Set the following variables:

• BOT_TOKEN: Paste the bot token you copied from the Discord Developer Portal.
• PREFIX: The command prefix your bot will use (e.g., !). Users will type !play to use the bot.
• OWNER: Your Discord user ID. This grants you special administrative commands. To get your user ID, enable Developer Mode in Discord (User Settings > Advanced), then right-click your username and select Copy ID.
• SPOTIFY_CLIENT_ID: (Optional) Your Spotify application client ID. Create a Spotify application at Spotify for Developers.
• SPOTIFY_CLIENT_SECRET: (Optional) Your Spotify application client secret. Found next to your client ID on the Spotify dashboard.
• YOUTUBE_API_KEY: (Optional) A YouTube Data API v3 key. Obtain one from the Google Cloud Console.

First start

After setting your startup variables, go to the Console tab in your ServerPrism panel and click Start. Watch the console output for messages indicating successful connection to Discord. You should see messages like [INFO] Logged in as Muse Bot#1234.

Once the bot is online, go to your Discord server and try a command like !ping (using your chosen prefix). The bot should respond with Pong!.

Common issues

• Bot token rejected/Invalid Token: Double-check that BOT_TOKEN in your Startup tab is exactly the token copied from the Discord Developer Portal, with no extra spaces or characters.
• Bot online but not responding to commands: Ensure you enabled the Message Content Intent in the Discord Developer Portal under the Bot section. Also, verify the bot has Send Messages and Read Messages/View Channels permissions in your Discord server.
• Bot not joining voice channels or playing audio: Check that the bot has Connect and Speak permissions in the voice channel it's trying to join.

Next steps

Explore Muse's commands by typing !help in your Discord server. You can find more detailed usage instructions and advanced configuration options on the Muse GitHub page.