The Music module
FlaviBot plays audio in a voice channel of your server. One server can have one music session per bot at a time: the bot sits in a single voice channel, holds a queue of tracks, and plays them in order.
Four ways to control it
You never have to pick one. They all act on the same player.
| Surface | Best for |
|---|---|
Slash commands (/play, /skip, /queue, ...) | everyday use, anywhere in the server |
| The buttons on the now playing message | pause, skip, stop without typing |
| The controller channel | a dedicated channel where typing a song name plays it |
| The web player | a full interface with search, drag-and-drop queue and filters |
Server-wide settings live on the dashboard, under Music in the sidebar: Music settings for everything about announcements, playback defaults and the controller, and DJ Mode for who is allowed to do what.
Slash commands and their short forms
Every music command in these pages is a real slash command, under the exact name
written here. /nowplaying, /clearqueue and /disconnect are typed in full in
Discord's / list.
The short forms are prefix aliases. They work only with your server's text
prefix (f!np, f!cq, f!dc), never as a slash command, and Discord will not
autocomplete them. See commands and
help for how prefix commands work.
| Slash command | Also answers to, with the prefix |
|---|---|
/play | p |
/play-file | pf, but the prefix form cannot read an attached file |
/join | j, connect |
/disconnect | dc, destroy, leave |
/resume | unpause |
/previous | prev |
/nowplaying | np |
/queue | q |
/clearqueue | cq |
/remove | rm |
/volume | vol |
/loop | repeat |
/jump | skipto |
/autoplay | autop |
/24-7 | 247, 24/7 |
/controller | setup |
/music-panel | musicpanel |
Every other music command is typed the same way in both places.
Getting started
- Join a voice channel.
- Run
/playwith a song name or a link.
That is the whole setup. FlaviBot joins your channel, queues the track and announces it. Everything else on these pages is optional.
What you need permission-wise
FlaviBot needs View Channel, Connect and Speak in the voice channel
you are in. If any of the three is missing, /play says so and names the
missing permissions instead of silently failing.
Configuration commands (/controller, /setvc, /announcechannel, /24-7,
/defaultplaylist) require the Manage Server permission. Playback commands
do not, unless you turn on DJ mode.
Free, vote-gated and Premium
Three different levels show up throughout this module, so it is worth learning them once.
- Free: works everywhere, always.
- Vote or Premium: the command asks you to vote for FlaviBot on top.gg. A vote is free and counts for 12 hours. Holding a Premium subscription, or being on a server that has Premium, skips the ask entirely.
- Server Premium: the whole server needs a FlaviBot Premium subscription applied to it. Voting does not help here.
Where a feature sits is stated on its own page. A few limits also change with the server's plan:
| Limit | Free | Premium |
|---|---|---|
| Tracks in the queue | 200 | 100,000 |
| Tracks taken from an imported playlist | 500 | 10,000 |
| DJ permission entries | 2 | unlimited |
| Saved playlists (per account) | 3 | unlimited |
Where to go next
- Playing music, what you can put in
/playand what happens next - Playback controls, pause, skip, volume, loop
- The queue, reorder, remove, clean up
- DJ mode, if you need to lock the music down
