JMusicBot Setup

JMusicBot is a self-hosted Discord music bot that’s easy to run, requires almost no configuration, and supports YouTube, SoundCloud, Bandcamp, Twitch, and local files. If you want a music bot without writing code, this is the fastest path.

What you’ll need

1. A Discord account
2. A Discord application with a bot user (we’ll create this below)
3. Your bot’s Token and your Discord User ID

Step 1: Create a Discord application

1. Go to the Discord Developer Portal.
2. Click New Application, give it a name, and create it.
3. In the sidebar, open the Bot page.
4. Under Privileged Gateway Intents, enable Message Content Intent and Server Members Intent.
5. Click Reset Token to reveal your bot token. Copy and save it somewhere safe — you’ll paste it into the Witchly dashboard next.

Step 2: Get your Discord User ID

1. In Discord, open User Settings → Advanced and turn on Developer Mode.
2. Right-click your own username anywhere and click Copy User ID.

Step 3: Deploy on Witchly

1. dash.witchly.host → Deploy → Applications → JMusicBot.
2. Pick The Helper tier — JMusicBot only needs 512 MB–1 GB RAM.
3. Click Deploy.

Step 4: Configure

Open your new server and go to the Startup tab. Fill in:

Variable	What to put
BOT_TOKEN	Your bot token from Step 1
BOT_OWNER	Your Discord user ID from Step 2
BOT_PREFIX	Command prefix (e.g., !, .) or @mention
BOT_GAME	Playing text (or leave as DEFAULT)
BOT_STATUS	ONLINE, IDLE, DND, or INVISIBLE

Other variables (BOT_ALONE_TIME, BOT_MAXTIME, etc.) are optional tweaks — the defaults are sensible.

These save automatically. Press Start on the Console tab.

Step 5: Invite the bot to your server

1. Go back to the Discord Developer Portal.
2. Open OAuth2 → URL Generator.
3. Select scopes: bot and applications.commands.
4. Select bot permissions: Send Messages, Connect, Speak, Use Voice Activity, View Channels.
5. Copy the generated URL, paste it into your browser, and invite the bot to your Discord server.

Using the bot

• !help — list commands (use your prefix)
• !play <url or search> — play audio
• !queue — view the queue
• !skip — skip current track
• !stop — stop and clear the queue

Owner-only admin commands include !setvc, !settc, !setdj, and !shutdown.

Troubleshooting

• Bot doesn’t respond — check intents are enabled in the Developer Portal; verify the token has no extra spaces.
• “Permission denied” — invite the bot with Connect, Speak, and Send Messages in the target channel.
• No audio plays — common YouTube issue; make sure you’re on a recent JMusicBot release. Set the Version in Startup to latest and reinstall.

Next steps

• Scheduled restarts to keep the bot fresh
• Lavalink setup if you later build a custom bot