Queue Management Features

​

Queue Command

​

Queue Display

• Now-playing track with progress
• Title, artist, and duration
• Current position in track (for non-livestreams)

• Position number (1-indexed)
• Track title and artist (clickable link)
• Duration or “Live” indicator
• Requester mention
• Time added to queue
• 4 tracks per page with pagination

​

Per-Track Controls

• Jump to that track immediately
• Removes track from queue and starts playing
• Under Fairplay: only works for your own tracks (or any if you’re a mod)

• Move track up one position
• Under Fairplay: mod-only
• Disabled for first track in queue

• Move track down one position
• Under Fairplay: mod-only
• Disabled for last track in queue

• Remove track from queue entirely
• Under Fairplay: only works for your own tracks (or any if you’re a mod)

​

Global Queue Actions

• Previous page
• Go to Page (modal with text input)
• Next page
• All disabled appropriately when at boundaries

• Reverse - Reverse entire queue order (blocked in Fairplay)
• Shuffle - Randomize queue order (blocked in Fairplay, requires 4+ tracks)
• Clear - Remove all tracks (Fairplay mod only when active)

​

Fairplay Mode

​

How Fairplay Works

• Queue automatically rotates between different requesters
• Ensures everyone gets fair playback time
• No single user can monopolize the queue
• Rotation visible in queue display

• Skip/Seek/Remove: Track owner or mod only
• Pause/Resume/Stop/Clear: Mod only
• Shuffle/Reverse/Loop: Fully disabled
• Playtop/Reordering: Mod only
• Previous: Fully disabled

​

Fairplay Mod Definition

1. Mute Members permission in the server
2. Custom Fairplay mod role (set via /fairplayrole <role>)

​

Fairplay Commands

/fairplay on

• Requires vote or premium
• Requires Fairplay mod permissions
• 15-second cooldown (8.25s for voters/premium)

/fairplay off

• Same requirements as enabling
• Instantly removes all restrictions

/fairplayrole <role>

• Server administrator only
• Designates which role can bypass Fairplay restrictions
• Persists across player sessions

​

Fairplay Indicators

• “Fairplay enabled” text in status line
• Changes button behavior descriptions
• Modal shows Fairplay toggle for mods

• Footer message explaining Fairplay restrictions
• Disabled buttons for non-permitted actions
• Note about track ownership for skip/remove

​

Queue Commands

​

Viewing Commands

• Display interactive queue viewer
• 20-second cooldown (11s for voters/premium)
• No special permissions required
• Stays active for 5 minutes

​

Modification Commands

• Remove tracks by position, range, or multiple
• Syntax: “1”, “1-5”, “2,4,7”, “1-3,5,8-10”
• Under Fairplay: only your own tracks (or any if mod)
• 10-second cooldown (5.5s for voters/premium)
• Validates all positions before removing

• Randomize queue order
• Fully blocked when Fairplay is active
• Requires minimum 4 tracks in queue
• 10-second cooldown (5.5s for voters/premium)

• Remove all tracks from queue
• Under Fairplay: mod-only
• Does not stop current track
• 15-second cooldown (8.25s for voters/premium)

​

Skip Behavior

/skip

• Skip current track only
• Moves to next in queue
• Under Fairplay: track owner or mod only

/skip count:5

• Skip forward by specified number
• Under Fairplay: limited by ownership
• Non-mods can only skip their own consecutive tracks

/skip name:Bohemian Rhapsody

• Fuzzy matching against track titles
• Finds closest match using Levenshtein distance
• Skips all tracks up to and including match
• Under Fairplay: same ownership rules apply

​

Loop Modes

• Standard queue progression
• Queue ends when last track finishes
• Autoplay may activate if enabled

• Repeats current track indefinitely
• Skip command blocked while active
• Must disable loop to progress queue

• Repeats entire queue when finished
• Tracks play in order repeatedly
• Can be combined with shuffle for variety

​

Autoplay

• Enabled via /autoplay on or settings modal
• Triggers when queue drops below 2 tracks
• Also triggers on queue finish