?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
PurpleMusic

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.

5
0
5
0

Compatibility

Minecraft: Java Edition

1.21.x

Platforms

Links

Report issues View source Visit wiki

Tags

Creators

Details

Licensed ARR
Published 2 days ago

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