Commands

English | 繁體中文

Full reference of every command NextVoiceCord provides, grouped by who is allowed to run it.

Running commands

Text commands are typed with the bot's prefix. By default the prefix is a mention of the bot itself (@BotName play never gonna give you up); a fixed prefix (and an optional second, alternate prefix) can be set in the bot's config file, and each server can override its own prefix with the prefix command (see Permissions-and-Server-Settings).

Slash commands (/play, /queue, and so on) are registered directly with Discord, so they show up in Discord's own command picker with argument prompts — you do not need to remember their exact syntax. Typing /help (or the text command help) opens an interactive list of commands inside Discord itself, scoped to what you personally are allowed to run; it covers the same ground as this page.

Most commands below exist in both forms — a slash command and a text command with the same name. Where a command exists in only one form, the table says so. The Arguments column shows the syntax for the text-command form; the slash-command form asks for the same information through Discord's own parameter fields.

A handful of commands are text-only, with no slash equivalent: lyrics, scsearch, nowplaying, and every Owner command except clearchannel (autoplaylist, debug, eval, playlist, setavatar, setgame, setname, setstatus, shutdown). Conversely, help and controller exist only as slash commands.

Access levels are explained in full in Permissions-and-Server-Settings; the short version is below each heading here.

Anyone

Any member of the server can run these — no role or permission is required.

Command	Forms	Arguments	What it does
help	slash only	—	Shows an interactive list of commands, scoped to what you can run.
history	both	[pagenum]	Shows recently played tracks (the history queue).
lyrics	text only	[song name]	Listed in the help output but does nothing — the JLyrics dependency it needs was removed from the project. Do not rely on it.
nowplaying	text only	—	Shows the song currently playing.
play	both	<title|URL|subcommand>	Plays the given song, or resumes/continues playback depending on the subcommand.
playlists	both	—	Shows the playlists available on this server.
queue	both	[pagenum]	Shows the current queue.
remove	both	<position|ALL>	Removes a song from the queue by position, or clears everything you added with ALL.
scsearch	text only	—	Searches SoundCloud for a query and lets you pick a result.
search	both	<query>	Searches YouTube for a query and lets you pick a result.
seek	both	[+ | -] <HH:MM:SS | MM:SS | SS> or <0h0m0s | 0m0s | 0s>	Seeks within the current song, absolutely or relative to the current position.
settings	both	—	Opens the settings panel. See Permissions-and-Server-Settings for how the panel differs by who opens it.
shuffle	both	—	Shuffles the songs you personally added to the queue.
skip	both	—	Casts a vote to skip the current song. Whether your vote alone is enough depends on the server's skip ratio (see Permissions-and-Server-Settings).

DJ

Requires the DJ role (or Manage Server, or being the bot owner — see Permissions-and-Server-Settings).

Command	Forms	Arguments	What it does
forceremove	both	<user>	Removes every entry a given user added to the queue.
forceskip	both	—	Skips the current song immediately, without a vote.
movetrack	both	<from> <to>	Moves a track in the queue from one position to another.
pause	both	—	Pauses the current song.
playnext	both	<title|URL>	Queues a single song to play immediately after the current one.
repeat	both	[off|all|single]	Sets the repeat mode: off, loop the whole queue, or loop the current track.
skipto	both	<position>	Skips forward to the song at the given queue position.
stop	both	—	Stops playback and clears the queue.
volume	both	[0-150]	Sets the player volume (0–150), or shows the current volume if no value is given.

Admin

Requires Manage Server permission, or being the bot owner — see Permissions-and-Server-Settings.

Command	Forms	Arguments	What it does
controller	slash only	—	Customises the now-playing control panel for this server. Full syntax in Controller-Panel.
npbuttons	both	<on|off|inherit>	Sets whether now-playing messages show interactive buttons for this server.
nplayout	both	<full|minimal|inherit>	Sets the now-playing message layout mode for this server.
prefix	both	<prefix|NONE>	Sets a server-specific text-command prefix; NONE reverts to the bot's default.
queuetype	both	[linear|fair]	Changes how the queue orders tracks between users.
setdj	both	<rolename|NONE>	Sets the DJ role for this server; NONE clears it. See Permissions-and-Server-Settings for what setting it to @everyone does.
setskip	both	<0-100>	Sets the percentage of listeners that must vote to skip a song on this server.
settc	both	<channel|NONE>	Restricts music commands to a single text channel; NONE removes the restriction.
setvc	both	<channel|NONE>	Restricts the bot to playing in a single voice channel; NONE removes the restriction.

All of the above except controller can also be set from the /settings panel — see Permissions-and-Server-Settings.

Owner

Restricted to the single Discord user ID configured as discord.owner in the bot's config.

Command	Forms	Arguments	What it does
autoplaylist	text only	<name|NONE>	Sets the default playlist for the server.
clearchannel	both	—	Clears all messages in the text channel set with settc.
debug	text only	—	Shows debug information.
eval	text only	—	Evaluates Nashorn (JavaScript) code against the running bot.
playlist	text only	<append|delete|make|setdefault>	Manages playlists.
setavatar	text only	<url>	Sets the bot's avatar.
setgame	text only	[action] [game]	Sets the bot's Discord activity status (playing/streaming/listening/watching).
setname	text only	<name>	Sets the bot's Discord username.
setstatus	text only	<status>	Sets the bot's online status.
shutdown	text only	—	Safely shuts the bot down.

These are for the person running the bot, not for server moderators — even a server owner without the configured Discord user ID cannot use them.

See also

Getting-Started for installing and starting the bot, Permissions-and-Server-Settings for who can run what and how to configure the server, Controller-Panel for customising the now-playing panel that controller edits, and Troubleshooting if a command is not behaving as documented here.