{"id":126519,"date":"2026-06-07T13:26:23","date_gmt":"2026-06-07T10:26:23","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/"},"modified":"2026-06-07T13:26:23","modified_gmt":"2026-06-07T10:26:23","slug":"purplemusic","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/","title":{"rendered":"PurpleMusic"},"content":{"rendered":"

# PurpleMusic<\/p>\n

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

## Features<\/p>\n

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

## Requirements<\/p>\n

– Paper 1.21+
\n– Simple Voice Chat (server + client) 2.6.0 or newer<\/p>\n

## Commands<\/p>\n

All commands are also available under the aliases `\/pmusic` and `\/pm`.<\/p>\n

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

## Permissions<\/p>\n

Each command checks a granular permission (`purplemusic.download`, `purplemusic.play`,
\n`purplemusic.stop`, `purplemusic.queue`, `purplemusic.playlist`, `purplemusic.zone`,
\n`purplemusic.list`, `purplemusic.reload`). The `purplemusic.*` parent grants them all.
\nAll default to `op`.<\/p>\n

## Data layout<\/p>\n

“`
\nplugins\/PurpleMusic\/
\n config.yml # global settings
\n playlists.yml # named playlists (auto-managed)
\n zones.yml # music zones (auto-managed)
\n musicdata\/ # all audio files (wav \/ mp3 \/ flac)
\n“`<\/p>\n

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

SOURCE CODE: https:\/\/github.com\/batminecraft\/PurpleMusic<\/p>\n","protected":false},"excerpt":{"rendered":"

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.<\/p>\n","protected":false},"featured_media":126520,"template":"","meta":{"_minecraft_slug":"purplemusic","_minecraft_project_id":"aLEBxwNq","_minecraft_author":"Rural","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":5,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"purplemusic.zip","_minecraft_size_bytes":1151076,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:19:31.032526Z","_minecraft_date_created":"2026-05-07T20:28:48.520281Z","_minecraft_date_modified":"2026-04-08T07:51:59.285444Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/purplemusic","_minecraft_icon_attachment_id":126520,"_minecraft_imported_at":"2026-06-07T10:26:24+00:00","_minecraft_import_hash":"03729e59fd8170788a1b4cfaa8942871","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,156,125,127,128,867,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-126519","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-decoration","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nPurpleMusic - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PurpleMusic - Minecraft\" \/>\n<meta property=\"og:description\" content=\"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.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/\",\"name\":\"PurpleMusic - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/purplemusic-icon-8a5a2d43de23c7a6112c01cb4f09cf2d37efbd8d_96.webp\",\"datePublished\":\"2026-06-07T10:26:23+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/purplemusic-icon-8a5a2d43de23c7a6112c01cb4f09cf2d37efbd8d_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/purplemusic-icon-8a5a2d43de23c7a6112c01cb4f09cf2d37efbd8d_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/purplemusic\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PurpleMusic\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PurpleMusic - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/","og_locale":"en_US","og_type":"article","og_title":"PurpleMusic - Minecraft","og_description":"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.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/","name":"PurpleMusic - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/purplemusic-icon-8a5a2d43de23c7a6112c01cb4f09cf2d37efbd8d_96.webp","datePublished":"2026-06-07T10:26:23+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/purplemusic-icon-8a5a2d43de23c7a6112c01cb4f09cf2d37efbd8d_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/purplemusic-icon-8a5a2d43de23c7a6112c01cb4f09cf2d37efbd8d_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/purplemusic\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PurpleMusic"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/126519","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/126520"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=126519"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=126519"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=126519"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=126519"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}