Skip to main content

Documentation Index

Fetch the complete documentation index at: https://celestia.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

The Music system provides a complete audio playback experience. It supports playback from YouTube, Spotify, and SoundCloud, with a fully interactive now-playing panel, queue management, audio filters, personal playlists, lyrics fetching, and vote-skip for shared listening sessions.

​
Access Control

All music commands are available to everyone in the server by default. The only exception is the 24/7 mode toggle which requires the Manage Server permission.

​
Commands

Play a song or playlist from YouTube, Spotify, or SoundCloud. If something is already playing, the track is added to the queue.
,play <name or url>
Aliases: p Permissions: Everyone
Display the currently playing song with full controls — pause, skip, loop, volume, queue, and lyrics buttons all in one interactive panel.
,nowplaying
Aliases: np, current Permissions: Everyone
Search for a song and pick from the top 5 results using a dropdown selector instead of auto-playing the first result.
,find <query>
Aliases: — Permissions: Everyone
Pause the currently playing song.
,pause
Aliases: — Permissions: Everyone
Resume a paused song.
,resume
Aliases: unpause Permissions: Everyone
Restart the current song from the beginning.
,replay
Aliases: restart Permissions: Everyone
Stop playback, clear the queue, and disconnect the bot from the voice channel.
,stop
Aliases: disconnect, dc Permissions: Everyone
Jump to a specific position in the current song.
,seek <position>
Aliases: — Permissions: Everyone
Set the playback volume between 1 and 100.
,volume <1-100>
Aliases: vol Permissions: Everyone
Toggle loop mode between off, track, and queue.
,loop [off|track|queue]
Aliases: repeat Permissions: Everyone
Randomly shuffle the current queue.
,shuffle
Aliases: — Permissions: Everyone
Toggle autoplay mode. When the queue ends, the bot will automatically queue related songs to keep the music going.
,autoplay
Aliases: ap Permissions: Everyone
Toggle 24/7 mode to keep the bot connected to your voice channel even when it’s empty, so it’s always ready to play.
,247
Aliases: stay Permissions: Manage Server
Display the lyrics for the currently playing song with paginated navigation.
,lyrics
Aliases: ly Permissions: Everyone
Show the last 20 recently played songs in the current session with pagination.
,history
Aliases: recent Permissions: Everyone
DM yourself the currently playing song’s link, title, artist, and artwork so you don’t lose it.
,save
Aliases: dm Permissions: Everyone
Your DMs must be open for this command to work.

​
Queue Management

Display the current queue with pagination showing track titles, durations, and requesters.
,queue
Aliases: q Permissions: Everyone
Remove a specific track from the queue by its position number.
,remove <position>
Aliases: rm Permissions: Everyone
Move a track from one queue position to another.
,move <from> <to>
Aliases: mv Permissions: Everyone
Remove all tracks from the queue while keeping the current song playing.
,clearqueue
Aliases: cq, clear Permissions: Everyone
Scan the queue and remove any duplicate tracks, keeping only the first occurrence of each song.
,distinct
Aliases: dedupe, unique Permissions: Everyone

​
Audio Filters

Toggle a bass boost EQ preset that boosts the low frequency bands for a heavier sound.
,bassboost
Aliases: bb Permissions: Everyone
Toggle the nightcore filter which increases speed and raises pitch for a classic nightcore effect.
,nightcore
Aliases: nc Permissions: Everyone
Toggle the 8D audio rotation effect which pans audio in a circular motion. Best experienced with headphones.
,8d
Aliases: 8daudio Permissions: Everyone
Nightcore and 8D are mutually exclusive — enabling one will automatically disable the other.
Open an interactive filter panel showing the current state of all audio filters with toggle buttons. Also includes a Reset All option to clear every active filter at once.
,filters
Aliases: fx Permissions: Everyone

​
Playlists

View all of your saved playlists.
,playlist list
Aliases: pl list Permissions: Everyone
Create a new named playlist.
,playlist create <name>
Aliases: pl create Permissions: Everyone
Browse the tracks inside a playlist. Defaults to your Liked Songs if no name is provided.
,playlist view [name]
Aliases: pl view Permissions: Everyone
Queue an entire playlist into the voice channel.
,playlist play [name]
Aliases: pl play Permissions: Everyone
Add the currently playing song to one of your playlists.
,playlist add <name>
Aliases: pl add Permissions: Everyone
Remove a track from a playlist by its number.
,playlist remove <name> <number>
Aliases: pl remove Permissions: Everyone
Remove all tracks from a playlist without deleting the playlist itself.
,playlist clear <name>
Aliases: pl clear Permissions: Everyone
Permanently delete a playlist and all its tracks.
,playlist delete <name>
Aliases: pl delete Permissions: Everyone

​
Now Playing Panel

The nowplaying command sends a fully interactive panel built with Discord Components V2. The panel includes:
  • Album artwork fetched from iTunes
  • Song title with a direct link to the source
  • Artist name and album name
  • Current position and total duration
  • Volume level and active loop mode
  • Requester mention

​
Control Buttons

Previous

Go back to the previous track

Pause / Resume

Toggle playback — button switches between pause and play icons automatically

Stop

Stop playback and disconnect

Skip

Skip to the next track (triggers vote-skip if 3+ people are in VC)

Loop

Cycle loop mode — button turns green when loop is active

Queue

Open the queue viewer

Volume Down

Decrease volume by 10%

Volume Up

Increase volume by 10%

Like

Save the current song to your Liked Songs playlist

Lyrics

Fetch and display lyrics for the current song

​
Vote Skip System

When there are 3 or more people in a voice channel, skipping requires a majority vote.
People in VCVotes Required
1–2Instant skip
32 votes
42 votes
53 votes
63 votes
  • The vote expires after 30 seconds if not enough votes are collected
  • Each person can only vote once per session
  • Running ,skip counts as casting your vote
The vote skip panel shows the voice channel mention, current vote count, and required votes in real time.

​
Supported Sources

  • YouTube — search by name or direct URL
  • Spotify — track, album, and playlist URLs
  • SoundCloud — track and playlist URLs
The default search platform is YouTube. Paste a Spotify or SoundCloud URL directly to play from those platforms.

​
Best Practices

  • Use ,find instead of ,play when you’re not sure of the exact song name to avoid playing the wrong track.
  • Use ,save to DM yourself a song you want to remember before it ends.
  • Use ,distinct after queueing large playlists to remove any accidental duplicates.
  • Use ,filters as a central panel to manage all audio effects rather than toggling them individually.
  • Assign the 24/7 role only in servers where the bot has a dedicated music channel to avoid unnecessary resource usage.