Music System
1. Feature Brief
Section titled “1. Feature Brief”Utilara Music is a message-based music player - no slash commands to play songs. You designate one text channel as the music console, and anything typed there is treated as a search query or URL. The bot deletes your message, finds the track, and starts playing. A persistent player embed with full controls lives in that channel and updates in real time.
- Message-based playback - type a song name, YouTube link, Spotify URL, or playlist into the music channel to queue it instantly
- Persistent player console - a sticky embed with playback buttons stays in the channel and updates as tracks change
- Full queue management - skip, shuffle, clear, loop, and view the upcoming queue without leaving Discord
- Access control - restrict or allow the music system per user, voice channel, or channel category using blacklist or whitelist mode
- Web player - full player interface available at utilara.net/player for managing playback from a browser
- 24/7 mode (Premium) - bot stays in the voice channel even when everyone leaves, so music keeps going around the clock
2. Sub-Systems
Section titled “2. Sub-Systems”The sticky player embed has three rows of buttons. You must be in a voice channel - and in the same voice channel as the bot - to use any of them.
Row 1 - Playback
| Button | Action |
|---|---|
 Previous | If more than 5 seconds into the track: restarts it. If within the first 5 seconds: goes to the previous track. If no history: restarts current. |
 /  Play / Pause | Toggles playback |
 Skip | Skips to the next track in queue |
 Stop | Clears the queue and disconnects the bot |
 Shuffle | Randomly shuffles the upcoming queue (requires at least 2 tracks) |
Row 2 - Queue & Audio
| Button | Action |
|---|---|
 Loop | Cycles through loop modes: Off → Track → Queue → Off |
| 🔉 Volume Down | Decreases volume by 10% |
| 🔊 Volume Up | Increases volume by 10% |
 Queue | Shows the current track and next 10 upcoming tracks (private) |
 Clear | Removes all upcoming tracks from the queue |
Row 3 - Links
| Button | Action |
|---|---|
 Lyrics | Opens a Google search for the current track’s lyrics |
| 🌐 Web Dashboard | Opens the full player at utilara.net/player |
Access control lets you define exactly who can use the music system and from where. It operates in one of two modes, switchable at any time from the setup panel.
Blacklist mode (default) - everyone can use music except the users, voice channels, or categories you explicitly block.
Whitelist mode - only the users, voice channels, or categories you explicitly allow can use music. Everyone else is blocked.
What can be restricted:
| Scope | Description |
|---|---|
| Users | Block or allow up to 25 specific members |
| Voice Channels | Block or allow specific voice channels (music won’t play from there) |
| Categories | Block or allow entire channel categories at once |
If the bot is ever dragged into a restricted voice channel, it will automatically stop playback and disconnect.
Adding tracks - type anything into the music channel. The bot accepts:
- Song names (e.g.
Bohemian Rhapsody) - Links to supported music and audio platforms
- Playlist URLs - all tracks are added to the queue at once
Your message is deleted immediately. The bot sends a temporary confirmation that disappears after 5 seconds.
Queue behaviour:
- Tracks play in order; new additions go to the end of the queue
- Previous track history is tracked (up to 50 tracks back)
- When the queue ends, the bot waits 2 minutes before disconnecting - giving you time to add more
Auto-disconnect (non-premium) - if everyone leaves the voice channel, the bot waits 5 seconds and then destroys the player. Upgrade to Premium to keep the bot in the channel 24/7.
Local caching - tracks are downloaded in the background after first play. Future plays of the same track load instantly from the local cache.
3. Setup
Section titled “3. Setup”-
Run /music setup- requires Manage Channels permission. This opens the configuration panel. -
Set the Music Console - click Music Console and select any text channel. The bot will post its sticky player embed there and listen to every message in that channel as a music query. -
Configure access control Optional - click Access Mode to choose between blacklist and whitelist, then use the User, Voice Channels, and Categories pages to configure who and where music is allowed. -
Start playing - join a voice channel, type a song name or URL into the music channel, and the bot joins and starts playing.