JMusicBot is a music-only bot you run without writing code. It needs two things from you: your bot token and your own Discord user ID. Paste the token on the Bot tab under Discord, put your user ID in Bot, Code, Settings, [REQUIRED] Bot Owner ID, then start it.
Read this first: JMusicBot cannot play music in Discord voice channels at the moment. Since 2 March 2026 Discord only accepts voice connections that support its DAVE end-to-end encryption and refuses the others with close code 4017. JMusicBot 0.4.3 (5 August 2024) is the newest official release and the one the install downloads. It is built on JDA 4.4.1, and JDA added DAVE only in version 6.3.0 (January 2026). Users report the result in JMusicBot's issue tracker (issues #1854 and #1865): the bot joins a voice channel and leaves again with Reason: E2EE/DAVE protocol required. On our servers JMusicBot still installs and starts: in our test on 6 November 2026 it reached Discord about 3 seconds after start, using at most 84 MiB, before Discord refused our test token. Logging in is not the problem; joining voice is. Its settings also have no YouTube sign-in option. For a ready-made music bot with DAVE support, use Red: How to host Red.
- In the Discord Developer Portal, create the bot, copy its token, and switch on Message Content Intent.
- In the panel, make the server run JMusicBot (Change what runs).
- Paste the token in the Set up your bot card on Overview, and invite the bot.
- Put your Discord user ID in Bot, Code, Settings, [REQUIRED] Bot Owner ID.
- Press Start bot. The bot logs in and answers commands, but it cannot play in a voice channel until JMusicBot gets a release with DAVE support (see the note above).
Each step in detail below.
Before you start
- Create the bot in the Discord Developer Portal and copy its token: How to create a Discord bot and get its token.
- In the Portal, on the application's Bot page, switch on Message Content Intent. JMusicBot reads commands from messages, and a custom prefix only works with it on.
- Copy your own Discord user ID: in Discord, open Settings, Advanced and switch on Developer Mode, then right-click your name and choose Copy User ID. It is a long number of 17 to 20 digits.
1. Make the server run JMusicBot
- Open your server in the panel. On Overview, the Set up your bot card opens at the first step that is still missing. Click What runs: it says "This bot runs JMusicBot." when the type is already right.
- If it runs something else, click Change what runs, choose JMusicBot, press Next step, tick the confirmation and press Change server type. The server reinstalls, which takes a minute or two.

If the server already has files you want, download them first: How to create, download and restore backups.
2. Connect it to Discord
- In the setup card, step Connect to Discord, paste the token in Paste your bot token and press Connect. (Later you find the same field on the Bot tab, under Discord.)
- The card shows your bot's name and picture. If it is your bot, press Yes, continue.
- Step Permissions shows Privileged intents. Message Content is marked Needed by JMusicBot. If it shows Off, switch it on in the Portal and press Check again.
- Under Invite link, press Add to a Discord server. The link already asks for the voice permissions a music bot needs: Connect, Speak and Use Voice Activity, plus View Channels, Send Messages, Embed Links and a few more.

3. Set your owner ID and options
JMusicBot cannot start without an owner. Press Continue after the invite: the setup card's last step, Start, says "Fill in [REQUIRED] Bot Owner ID on the Bot page, Code, Settings first. The bot cannot start without it." and keeps Start bot off until you do.

- Press Open Settings in the setup card, or open the Bot tab, click Code, and scroll to the Settings card.
- Paste your user ID in [REQUIRED] Bot Owner ID and press Save.
- Change any other option the same way, one field at a time.

| Setting | Default | What it does |
|---|---|---|
| Bot Prefix | @mention | The command prefix. The default means you mention the bot: @YourBot play. Set ! to type !play. |
| Bot Alternate Prefix | NONE | A second prefix that also works. NONE means none. |
| Bot Default Game | DEFAULT | The activity under the bot's name, such as Listening to requests. NONE shows nothing. |
| Bot Default Status | ONLINE | ONLINE, IDLE, DND or INVISIBLE. |
| Bot Show Song in Status | false | true shows the current song as the bot's activity. It only works while the bot plays in one Discord server. |
| Bot Show Images for "Now Playing" | false | true adds thumbnails to the now playing message, which then stops refreshing. |
| Bot Stay In Channel | false | true keeps the bot in the voice channel after the queue ends. |
| Bot Alone Time Until Disconnect | 0 | Seconds the bot waits alone in a channel before it leaves and clears the queue. 0 means it never leaves. |
| Bot Max Song Length | 0 | The longest track allowed, in seconds. 0 means no limit. |
The panel writes these values into config.txt every time the bot starts, so edit them here, not in the file. Options that are not on the Settings card can still be changed in config.txt under Files.
4. Start it
- Go back to Overview and press Start bot in the setup card, or open Console and press Start.
- In Discord, type your prefix and
helpto check that the bot answers, for example@YourBot helpor!help. It lists every command, includingplay,skip,queueandvolume. Playing in a voice channel does not work in 0.4.3: the bot joins and leaves again.
Console lines you may see
If the bot is started from Console with [REQUIRED] Bot Owner ID still empty, the console says JMusicBot is not set up yet because it needs your Discord user ID as the bot owner, and the bot stays stopped. Set the field under Bot, Code, Settings, then press Start.
This bot is not on any guilds! Use the following link to add the bot to your guilds!
The bot is running but is in no Discord server yet. Use Add to a Discord server on the Bot tab, under Discord.
You currently have a custom prefix set. If your prefix is not working, make sure that the 'MESSAGE CONTENT INTENT' is Enabled
A reminder printed whenever the prefix is not @mention. If the bot ignores your commands, switch on Message Content Intent in the Portal and restart the bot.
Good to know
- The Runtime on the Code section is Java 17 (recommended) or Java 21. Keep Java 17 unless you have a reason to change it.
- Java's heap for JMusicBot is capped at three quarters of the server's memory limit; the bot as a whole uses a little more. Watch the Usage card on Overview after a day of use: How much RAM does a Discord bot need?
- Saved playlists go in the
Playlistsfolder under Files. The install puts anexample_playlist.txtthere. - The install downloads the newest JMusicBot release from the project's GitHub. To update later, open the Bot tab, Code, press Reinstall on the Reinstall card and confirm, then start the bot again. Your Settings values stay. The install downloads a fresh
config.txtand keeps the previous files asJMusicBot.jar-oldandconfig.txt-old, so copy back any lines you edited by hand inconfig.txt. - JMusicBot 0.4.3 cannot play in Discord voice channels at the moment (see the note at the top), so no site plays through it. For music today, see How to host Red and Discord music bot not playing: fixes.
Every option of every ready-made bot: How to change a ready-made bot's settings.



