Playing Your First Song
Once the bot is running and Lavalink is connected, you can play your first track.
Step 1 - Join a Voice Channel
Join any voice channel in your Discord server. The bot needs to see you in a voice channel to know where to play.
Step 2 - Use the Play Command
Type the following slash command in any text channel:
/play query:your song name or URLExamples:
/play query:never gonna give you up
/play query:https://open.spotify.com/track/4cOdK2wGLETKBW3PvgPWqT
/play query:https://www.youtube.com/watch?v=dQw4w9WgXcQ
/play query:https://soundcloud.com/artist/trackWhat Happens
- The bot joins your voice channel.
- It searches for the track using the configured search engine (default: YouTube Search).
- If a direct URL is provided, it resolves the track directly.
- The track starts playing immediately if the queue is empty.
- If music is already playing, the track is added to the queue.
- A now-playing embed appears in the text channel.
Supported Sources
| Source | URL Format | Search |
|---|---|---|
| YouTube | youtube.com/watch?v=... | ytsearch:query |
| YouTube Music | music.youtube.com/watch?v=... | ytmsearch:query |
| Spotify | open.spotify.com/track/... | spsearch:query |
| SoundCloud | soundcloud.com/... | scsearch:query |
| Deezer | deezer.com/track/... | Via LavaSrc |
| Apple Music | music.apple.com/... | Via LavaSrc |
| Tidal | tidal.com/browse/track/... | Via LavaSrc |
| HTTP Stream | Any direct audio URL | - |
Basic Playback Controls
After playing a song, use these commands to control playback:
| Command | Description |
|---|---|
/pause | Pause the current track |
/resume | Resume playback |
/skip | Skip to the next track |
/stop | Stop playback and clear the queue |
/queue | View the current queue |
/volume | Adjust volume (1–100) |
/nowplaying | Show the current track with progress bar |
Player Buttons
The now-playing embed includes interactive buttons for quick controls:
- ⏮️ Previous
- ⏸️ Pause / ▶️ Resume
- ⏭️ Skip
- ⏹️ Stop
- 🔁 Loop
These buttons can be customized via the /playercontrol command.