StruxaEggs Explorer

JMusicBot

Application

A Discord music bot that's easy to set up and run yourself!

Author: parker@parkervcp.comSource: pterodactyl/application-eggsUpdated: 5/24/2026

Startup Command

java -Dnogui=true -jar JMusicBot.jar

Docker Images

LabelImage
ghcr.io/pterodactyl/yolks:java_17ghcr.io/pterodactyl/yolks:java_17

Environment Variables

NameVariableDefaultRules
[REQUIRED] Discord Bot Token
The token for your Discord bot. Learn how to obtain a token and configure your bot application properly here: https://jmusicbot.com/getting-a-bot-token/
BOT_TOKENnonerequired|string
[REQUIRED] Bot Owner ID
This is the Discord User ID of the bot owner. Learn how to obtain this ID here: https://jmusicbot.com/finding-your-user-id/
BOT_OWNERChange This To Your Discord User IDrequired|digits_between:17,18
Bot Prefix
This sets the prefix for the bot. The prefix is used to control the commands. If you use !, the play command will be !play. If you do not set this, the prefix will be a mention of the bot (@Botname play).
BOT_PREFIX@mentionnullable|string|max:20
Bot Alternate Prefix
If you set this, the bot will also use this prefix in addition to "Bot Prefix". Set to NONE to not have an alternate prefix.
BOT_ALT_PREFIXNONErequired|string|max:20
Bot Default Game
If you change this, it modifies the default game of the bot. Set this to NONE to have no game. Set this to DEFAULT to use the default game. You can make the game "Playing X", "Listening to X", or "Watching X" where X is the title. If you don't include an action, it will use the default of "Playing".
BOT_GAMEDEFAULTnullable|string|max:20
Bot Default Status
[ Accepted Values: ONLINE IDLE DND INVISIBLE ] Will modify the default status of bot.
BOT_STATUSONLINErequired|string|in:ONLINE,IDLE,DND,INVISIBLE
Bot Show Song in Status
If you set this to true, the bot will list the title of the song it is currently playing in its "Playing" status. NOTE: This will ONLY work if the bot is playing music on ONE Discord server; if the bot is playing in multiple servers, this will not work!
BOT_SONG_STATUSfalserequired|string|in:true,false
Bot Show Images for "Now Playing"
If set to true, the "nowplaying" command will show YouTube thumbnails. NOTE: If you set this to true, the nowplaying boxes will NOT refresh. This is because refreshing the boxes causes the image to be reloaded every time it refreshes.
BOT_NPIMAGESfalserequired|string|in:true,false
Bot Stay In Channel
If set to true, the bot will not leave a voice channel after it finishes a queue. Keep in mind that being connected to a voice channel uses additional bandwidth, so this option is not recommended if bandwidth is a concern.
BOT_STAY_IN_CHANNELfalserequired|string|in:true,false
Bot Alone Time Until Disconnect
This sets the amount of seconds the bot will stay alone on a voice channel until it automatically leaves the voice channel and clears the queue. If not set or set to any number less than or equal to zero, the bot won't leave when alone.
BOT_ALONE_TIME0required|integer
Bot Max Song Length
This sets the maximum amount of seconds any track loaded can be. If not set or set to any number less than or equal to zero, there is no maximum time length. This time restriction applies to songs loaded from any source.
BOT_MAXTIME0required|integer