Discord Music Bot - Complete Doc

A comprehensive guide for using the music functionality, including examples, edge cases, and common mistakes to avoid.

1. Joining Voice Channel

Command: !join_music

✅ Correct Usage:

!join_music

❌ Common Mistakes:

!join_music     (while not in voice channel)
!join_music     (when bot is already in another channel)

Important:

• Must be in a voice channel before using command

• Bot announces channel name upon joining

• Command required before any music playback

• Error message guides you to join voice channel

2. Playing Music

Command: !play_music <song name or URL>

✅ Correct Usage:

!play_music https://youtube.com/watch?v=dQw4w9WgXcQ
!play_music Never Gonna Give You Up
!play_music The Beatles - Hey Jude

❌ Common Mistakes:

!play_music     (Missing search term or URL)
!play_music     (without joining voice channel first)

Important:

• Works with both YouTube URLs and search terms

• Automatically finds the highest-quality audio

• Stops current song before playing new one

• Shows "Now playing: title" when successful

• Requires bot to be in voice channel first

3. Queue Management

Command: !add_queue <song name or URL>

✅ Correct Usage:

!add_queue https://youtube.com/watch?v=dQw4w9WgXcQ
!add_queue Sweet Dreams
!add_queue "Queen - Bohemian Rhapsody"

❌ Common Mistakes:

!add_queue      (Missing song information)
!add_queue      (invalid URL)

Output Format:

Added to queue: **Song Title**

Important:

• Works with both YouTube URLs and search terms

• Adds song to end of current queue

• Shows confirmation with song title

• No limit to queue size

4. Viewing Queue

Command: !view_queue

Usage:

• Simply type !view_queue

• No additional parameters needed

Output Format:

Current queue:
1. Song Title 1
2. Song Title 2
3. Song Title 3

Important:

• Empty queue shows "The queue is currently empty"

• Songs listed in play order

• Shows full titles for all queued songs

5. Managing Queue

Command: !remove_queue <index>

✅ Correct Usage:

!remove_queue 1
!remove_queue 3

❌ Common Mistakes:

!remove_queue   (Missing index)
!remove_queue 0
!remove_queue   (index larger than queue)

Important:

• Index starts at 1

• Shows removed song title

• Cannot be undone

• Error message if invalid index

6. Playlist Features

Command: !play_playlist <playlist_URL>

✅ Correct Usage:

!play_playlist https://youtube.com/playlist?list=PLxxx...

❌ Common Mistakes:

!play_playlist  (Missing URL)
!play_playlist  (Non-YouTube playlist)
!play_playlist  (Without joining voice first)

Important:

• Adds all songs to existing queue

• Shows total songs added

• Must be in voice channel

• Only supports YouTube playlists

7. Random Playback

Command: !play_random

Usage:

!play_random

Important:

• Requires non-empty queue

• Announces selected song

• Can be used multiple times

• Keeps selected song in queue

8. Leaving Channel

Command: !leave_music

Usage:

!leave_music

Important:

• Disconnects from voice channel

• Stops any playing music

• Confirms disconnection

• Can rejoin with !join_music

Advanced Tips & Features

Best Practices for Music Sessions:

• Add multiple songs to queue before starting

• Use playlists for longer sessions

• Check queue regularly with !view_queue

• Remove unwanted songs promptly

• Clear queue when changing music themes

Audio Quality Settings:

• Automatic 192kbps MP3 conversion

• Best audio quality selection

• Optimized for Discord voice channels

• FFmpeg audio processing

Quick Reference Table

Getting Help

• Use commands in any text channel with bot access

• Error messages explain what went wrong

• Bot provides feedback for all actions

• Developer commands restricted by Discord ID