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 orderLOOP- replay the playlist foreverLOOP_ONE- repeat the same track foreverSHUFFLE- 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/.flacfiles straight from a URL intoplugins/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
