Music System

1. Feature Brief

Utilara Music is a message-based music player with zero slash command friction. You designate one text channel as your dedicated music console. Any song name, album link, or playlist sent to that channel is automatically enqueued, the user message is cleaned up, and a sticky player embed updates live with controls.

1. Message-based playback - type any song title, YouTube URL, Spotify link, or playlist into your music console channel to queue it instantly
2. Sticky player console - a persistent embed with playback buttons stays at the bottom of the channel and updates in real time
3. Multi-node Lavalink engine - redundant audio nodes provide zero-downtime automatic player migration and failover
4. Self-healing audio cache - validated local caching ensures fast track loading and uninterrupted playback
5. Full queue management - skip, shuffle, clear, loop, and view upcoming tracks directly in Discord
6. Access control - restrict playback to specific roles, users, or voice channels with blacklist or whitelist modes
7. Premium audio suite Premium - 24/7 mode, infinite smart autoplay, sleep timers, 150% volume, and audio FX
8. Custom player branding Premium - personalize your player embed with custom HEX colors, idle banner GIFs, and greetings

Premium Enhancements

Advanced playback features (24/7 VC permanence, Autoplay, Sleep Timers, 150% Volume, Audio FX, and Custom Player Branding) are part of Utilara Premium. Run /premium check or visit patreon.com/utilara.

---

2. Sub-Systems

Player Controls

The sticky player embed features three rows of interactive buttons. You must be in the same voice channel as the bot to interact with playback controls.

Row 1: Playback

Button	Action
Previous	Restarts the current track, or plays the previous track if clicked within the first 5 seconds
/ Play / Pause	Toggles active audio playback
Skip	Skips directly to the next track in the queue
Stop	Clears the queue, halts playback, and disconnects the player
Shuffle	Randomly shuffles all upcoming tracks in the queue

Row 2: Queue & Audio

Button	Action
Loop	Cycles through loop modes: Off, Track, Queue, and back to Off
🔉 Volume Down	Decreases playback volume by 10%
🔊 Volume Up	Increases playback volume by 10% (up to 100% on Standard, 150% on Premium)
Queue	Displays the currently playing song and next 10 queued tracks
Clear	Clears all upcoming tracks from the queue

Row 3: Links & Web

Button	Action
Lyrics	Searches for the lyrics of the current song
🌐 Web Dashboard	Opens the browser-based player at utilara.net/player

Premium & FX

Unlock extended audio features for community listening sessions.

• 24/7 Mode: Prevents the bot from disconnecting when voice channels empty, keeping your music channel active indefinitely
• Smart Autoplay: When your queue ends, Utilara automatically discovers and enqueues related tracks based on your listening history
• Sleep Timer: Schedule automatic playback fade-out after 15 minutes, 30 minutes, 1 hour, or 2 hours
• 150% Volume Boost: Boost quiet audio sources past the standard 100% ceiling
• Audio FX Suite: Toggle studio audio filters directly:
  • Bass Boost: Deep low-end frequency enhancement
  • Nightcore: Sped-up tempo with pitch shift
  • Vaporwave: Slowed-down tempo with ambient reverb
  • 8D Audio: Circular binaural panning effect
  • Tremolo: Rapid amplitude oscillation

Console Branding

Premium Personalize the appearance of the sticky player embed in your music channel:

• Custom Theme Accent Color: Choose from curated color presets or supply any custom HEX color code (e.g. #00F0FF or #FF4500)
• Custom Idle Banner: Display a custom server image or animated GIF URL when the player is idle
• Custom Greeting Tagline: Set a custom greeting headline shown on the player embed to match your community aesthetic

Access Control

Control which members and channels have permission to request songs.

• Blacklist Mode (default): Everyone can play music except members, channels, or categories you explicitly block
• Whitelist Mode: Only designated members, channels, or categories can play music

Scope	Limits
Users	Up to 25 specific member restrictions
Voice Channels	Up to 25 restricted voice channels
Categories	Up to 25 restricted channel categories

Administrator Bypass

Members with Administrator permissions automatically bypass access restrictions.

Queue & Reliability

• Adding Tracks: Send titles or URLs (YouTube, Spotify, Soundcloud, Apple Music) directly into your designated music channel
• History: Keeps track of up to 50 previous tracks for seamless rewind
• Multi-Node Failover: Audio playback is backed by multi-node Lavalink instances. If a node drops, players migrate to healthy nodes automatically with no loss of queue state

---

3. Setup Guide

1. Run /music setup - requires Manage Channels permission. This opens the interactive music configuration panel.

2. Select the Music Console - designate a text channel for music. The sticky player embed will be placed there, and all messages sent into that channel will be processed as track requests.

   Dedicated Channel Recommended

   Utilara automatically cleans up user messages sent in the music console channel to keep the player embed clear. Use a dedicated channel rather than a general chat.

3. Configure Access Control Optional - toggle between Blacklist and Whitelist modes and select allowed or blocked channels and roles.

4. Customize Player Branding Premium - if your server has Premium active, open the customization tab to apply your custom HEX color, banner image, and greeting tagline.

5. Start listening - join a voice channel, send a song title or link into your music channel, and playback will begin immediately.

Setup Reference

Panel Page	Description
Music Console	Designates the text channel used for requests and sticky player
Access Mode	Switch between Blacklist (block specific) or Whitelist (allow specific)
Restrictions	Set up to 25 user, channel, or category overrides
Customization	Configure custom accent color, banner GIF, and greeting [Premium]
Remove Setup	Wipes all music settings and disconnects the player