PurpleMusic

A Paper/Folia plugin built on the Simple Voice Chat API that lets staff stream real audio (wav / mp3 / flac) to players, build queues and playlists, and create persistent music zones around any location.

Features

• Direct playback - play a track to one player, several, or every online player.
• Queues - per-player and global queues that auto-advance when each track ends.
• Playlists - named, persistent playlists with four play modes:
  • SEQUENTIAL - play once in order
  • LOOP - replay the playlist forever
  • LOOP_ONE - repeat the same track forever
  • SHUFFLE - random pick forever
• Music zones - persistent spheres at a location with a configurable radius. Each zone plays a single track or a playlist, either continuously or on a fixed interval (X seconds between plays).
• Downloads - admins can pull .wav / .mp3 / .flac files straight from a URL into plugins/PurpleMusic/musicdata/.

Requirements

• Paper 1.21+
• Simple Voice Chat (server + client) 2.6.0 or newer

Commands

All commands are also available under the aliases /pmusic and /pm.

Command	Description
/pm download <url> <filename>	Download an audio file into musicdata/
/pm list	List every track in musicdata/
/pm play <player> <track>	Play a track to one player
/pm playall <track>	Play a track to every online player
/pm stop <player|all>	Stop playback for a player or everyone
/pm queue add <player|all> <track>	Add a track to a queue
/pm queue clear <player|all>	Clear a queue
/pm queue list <player|all>	Show queue contents
/pm queue skip <player|all>	Skip the current track
/pm playlist create <name>	Create an empty playlist
/pm playlist delete <name>	Delete a playlist
/pm playlist add <name> <track>	Add a track to a playlist
/pm playlist remove <name> <track>	Remove a track from a playlist
/pm playlist mode <name> <mode>	Set the playlist mode
/pm playlist list	List every playlist
/pm playlist show <name>	Show one playlist's tracks
/pm playlist play <player> <name>	Play a playlist to one player
/pm playlist playall <name>	Play a playlist to every online player
/pm zone create <name> <track|playlist> <source> <radius> <continuous|interval> [seconds]	Create a music zone at your current location
/pm zone delete <name>	Delete a zone
/pm zone list	List every zone
/pm zone mode <name> <mode>	Set the play mode for a playlist-backed zone
/pm reload	Reload config, playlists and zones

Permissions

Each command checks a granular permission (purplemusic.download, purplemusic.play, purplemusic.stop, purplemusic.queue, purplemusic.playlist, purplemusic.zone, purplemusic.list, purplemusic.reload). The purplemusic.* parent grants them all. All default to op.

Data layout

plugins/PurpleMusic/
  config.yml       # global settings
  playlists.yml    # named playlists (auto-managed)
  zones.yml        # music zones (auto-managed)
  musicdata/       # all audio files (wav / mp3 / flac)

The subdirectory-depth config option controls how deeply you can nest files inside musicdata/ (none, single, or unrestricted).

SOURCE CODE: https://github.com/batminecraft/PurpleMusic