Music player

Dispatch.IO has two separate players:

• One player at a time per server: if a radio is playing, /play is refused, and the other way around. Use /stop to switch from one to the other.
• Free: the player is available on every server, without any Premium plan.
• The bot joins your voice channel on the first /play, with the volume at 100%. It deafens itself: it doesn't listen to what is said in the channel.
• During bot maintenance (recovery mode), music is unavailable: commands reply with an error message.

The queue holds the tracks that will play after the current one.

• /play plays the track if nothing is playing, otherwise adds it to the end of the queue. A playlist link adds all its tracks.
• The Play now mode of /play puts the track at the front of the queue and skips straight to it.
• /next (or the Next button) skips to the next track; /previous (or Previous) restarts the current track.
• /loop repeats the current track or the whole queue.
• /queue shows the queue (10 tracks per page, with the total duration), shuffles or clears it, and lets you jump straight to a track.

When the last track ends, the queue is empty: the bot waits for a new /play without leaving the voice channel (see below).

The player message is posted in the channel where the first /play was typed, and stays there for the whole listening session. It is written in the server's language.

1. First track: the bot posts the player message: title (linking to its source) and thumbnail, author, progress, volume, requester, number of tracks waiting and state ("Playing" or "Paused"), then four buttons: Previous, Pause/Play, Next, Stop.
2. While playing: the same message is edited on every new track, every pause or resume and whenever the queue changes. Progress is the one at the time of the update: it doesn't move live.
3. Voice channel status: when the queue changes (track added, shuffle, clear), the bot shows the current track as the voice channel's status. It clears it when the queue ends or the player stops.
4. Queue finished: the message stays, with the title "Unknown" and greyed-out buttons. The bot stays in the voice channel.
5. Stop (/stop, Stop button, empty voice channel, bot disconnected): the player message is deleted.

• The buttons work for 1 hour from the start of the current track; after that, use the commands.
• Button confirmations ("The music has been paused by…") are public; error messages are only visible to you.
• If the player's channel is a temporary channel that deletes messages, the player message is protected and not deleted. The other replies of music commands are deleted like any other message.
• The /play confirmation ("Song added to queue") disappears on its own after 5 seconds.

Music commands are open to all members, with no Discord permission needed. To prevent a member from cutting off someone else's music, the bot applies three rules:

1. Be in voice: /play and /play-radio require being in a voice channel.
2. Be in the bot's channel: to control playback (pause, volume, queue…), you must be in the same voice channel as the bot.
3. The requester rule: as long as the person who requested the current track is in the bot's voice channel, only they can pause it, resume it, skip it, go back, loop it or use the player's buttons. If they left the channel, any member of the channel can do it.

A member with the Discord Administrator permission isn't bound by the requester rule, and can use Next, Stop, /next, /loop and /stop without being in the voice channel.

The full table and the error messages are on the Music and radio page.

1. A member types /play-radio and picks a station from the suggestions.
2. The bot joins their voice channel, starts the stream and shows the station's name as the voice channel's status.
3. It replies "Playing now: station" with a Stop the radio button, usable only by the person who started the radio. Any member in the bot's voice channel can also stop it with /stop.
4. When the radio stops (button, /stop, empty voice channel, bot disconnected, stream cut), the message says "The radio playback has been stopped." and its button is greyed out.

/title shows the station's name and /volume sets its volume.

Whenever playback stops, the player message is deleted and the voice channel status is cleared.

The bot also needs its basic permissions, listed on the Permissions and roles page.

Other error messages are explained on the Music and radio page.

• Music and radio: every music command in detail.
• Temporary channels: channels where messages delete themselves.
• Permissions and roles: the bot's permissions.
• Discord events: what happens when a member leaves a voice channel.