Commands¶
Most commands work two ways:
- Slash: type
/in Discord and pick the command from the list, for example/play. - Prefix: mention the bot, then the command, for example
@JMusicBot play never gonna give you up. You can change the prefix withcommands.prefixin config.txt, or per server withprefix.
Most commands have both forms. A "—" means that form doesn't exist. Aliases are extra names for the prefix form;
you can change them under commands.aliases in config.txt.
The groups below are about who can run a command:
- General and Music: anyone in the server.
- DJ: people with the server's DJ role (set it with
setdj) or the Manage Server permission. - Admin: people with Manage Server.
- Owner: only the bot owner (the
ownerID inconfig.txt).
Some music commands also need you to be in the bot's voice channel, or a song to be playing. The bot tells you when that's the case.
General¶
| Command | Slash | What it does | Aliases |
|---|---|---|---|
settings |
— | Shows the bot's settings for this server. Admins get an interactive panel. /settings is in Admin. |
status |
help |
— | Lists the commands you can use. The word is set by commands.help. |
— |
about |
— | Shows information about the bot. | — |
ping |
— | Checks that the bot is responding, and shows its latency. | — |
Music¶
| Command | Slash | What it does | Aliases |
|---|---|---|---|
play |
/play |
Plays a song: a title to search for, a link, or an audio file attached to your message. With nothing after it, a DJ can resume a paused song. play playlist <name> plays one of the server's playlists. |
— |
search |
/search |
Searches YouTube and lets you pick a result. | ytsearch |
scsearch |
— | Searches SoundCloud and lets you pick a result. | — |
nowplaying |
/nowplaying |
Shows the song that's playing, with the now-playing panel. /np does the same. |
np, current |
| — | /np |
Short form of /nowplaying. |
— |
queue |
/queue |
Shows the queue, a page at a time. | list |
history |
/history |
Shows recently played songs, with buttons to play one again. DJs and the bot owner can also save them as a playlist. | — |
playlists |
/playlists |
Lists the server's playlists. | pls |
remove |
/remove |
Removes a song from the queue by its position. remove all removes everything you added. |
delete |
shuffle |
/shuffle |
Shuffles the songs you added. | — |
skip |
/skip |
Votes to skip the current song. The person who queued it skips right away. | voteskip |
seek |
/seek |
Jumps to a time in the song, such as 1:30, +30 or 1m30s. Only a DJ or the person who added the song can seek. |
— |
DJ¶
| Command | Slash | What it does | Aliases |
|---|---|---|---|
forceskip |
/forceskip |
Skips the current song without a vote. | modskip |
forceremove |
/forceremove |
Removes every song a person added. | forcedelete, modremove, moddelete, modelete |
movetrack |
/movetrack |
Moves a song to another position in the queue. | move |
pause |
/pause |
Pauses the current song. Use play with nothing after it, or the Resume button, to carry on. |
— |
playnext |
/playnext |
Plays a single song next, ahead of the queue. | — |
repeat |
/repeat |
Repeats the queue (all), one song (single), or turns repeat off. |
— |
skipto |
/skipto |
Skips straight to a position in the queue. | jumpto |
stop |
/stop |
Stops playback, clears the queue and leaves the voice channel. | leave |
volume |
/volume |
Shows the volume, or sets it from 0 to 150. | vol |
library |
/library |
Commands for the yt-dlp library. Needs yt-dlp set up. | — |
| — | /library panel |
Opens the library panel to browse, play and manage downloaded songs. | — |
| — | /library unlink |
Unlinks the current song from the library song it was matched to. The prefix form is library unlink. |
— |
Admin¶
| Command | Slash | What it does | Aliases |
|---|---|---|---|
| — | /settings |
Opens the interactive settings panel for this server. | — |
setdj |
/setdj |
Sets the DJ role. To clear it, use setdj NONE, or /setdj with no role. |
— |
settc |
/settc |
Limits music commands to one text channel. To clear it, use settc NONE, or /settc with no channel. |
— |
setvc |
/setvc |
Limits the bot to one voice channel. To clear it, use setvc NONE, or /setvc with no channel. |
— |
setskip |
/setskip |
Sets the percentage of listeners needed to vote-skip, from 0 to 100. | setskippercent, skippercent, setskipratio |
prefix |
/prefix |
Sets a prefix for this server. prefix NONE, or /prefix with no prefix, goes back to the default. |
setprefix |
queuetype |
/queuetype |
Sets how the queue orders songs: linear (in the order added) or fair (takes turns between the people who added them). |
— |
nplayout |
/nplayout |
Sets the now-playing layout for this server: full, minimal, or inherit from config.txt. |
— |
npbuttons |
/npbuttons |
Turns now-playing buttons on or off for this server, or inherit from config.txt. |
— |
Owner¶
| Command | Slash | What it does | Aliases |
|---|---|---|---|
clearchannel |
/clearchannel |
Deletes messages in the music text channel set with settc. Limits come from commands.clearChannel. |
— |
playlist |
— | Manages playlists: make, append, delete, setdefault, and all to list them. |
— |
autoplaylist |
— | Sets the playlist the bot plays when the queue is empty, or NONE. |
— |
setname |
— | Changes the bot's name. | — |
setavatar |
— | Changes the bot's avatar from an image link. | — |
setgame |
— | Sets the bot's status text. Use setgame stream, listen or watch for other activity types. |
— |
setstatus |
— | Sets online, idle, do not disturb or invisible. | — |
debug |
— | Shows debug information to paste into a bug report. | — |
shutdown |
— | Shuts the bot down safely. | — |
eval |
— | Runs code as the bot. Off unless dangerous.eval = true; see the warning below. |
— |
Leave eval off
eval runs any code you give it with full access to the bot and the computer it runs on. It's off by default
(dangerous.eval = false). If someone asks you to turn it on, they're very likely trying to take over your bot.