PurpleMusic
一个基于 Simple Voice Chat API 构建的 Paper/Folia 插件,允许管理员向玩家流式传输真实音频(wav / mp3 / flac),构建队列和播放列表,并在任意位置周围创建持久化的音乐区域。
功能
- 直接播放 - 将音轨播放给单个玩家、部分玩家或所有在线玩家。
- 队列 - 支持按玩家和全局队列,每首音轨播放完毕后自动推进下一首。
- 播放列表 - 具有四个播放模式的命名持久化播放列表:
SEQUENTIAL - 按顺序播放一次
LOOP - 无限循环播放整个播放列表
LOOP_ONE - 无限重复同一首音轨
SHUFFLE - 无限随机抽取播放
- 音乐区域 - 在指定位置创建的持久化球形区域,可配置半径。每个区域播放单首音轨或播放列表,支持连续播放或固定间隔播放(两次播放之间间隔 X 秒)。
- 下载 - 管理员可以直接从 URL 拉取
.wav / .mp3 / .flac 文件到 plugins/PurpleMusic/musicdata/ 目录中。
要求
- Paper 1.21+
- Simple Voice Chat(服务端 + 客户端)2.6.0 或更高版本
命令
所有命令也支持别名 /pmusic 和 /pm。
| 命令 |
描述 |
/pm download <url> <filename> |
将音频文件下载到 musicdata/ |
/pm list |
列出 musicdata/ 中的所有音轨 |
/pm play <player> <track> |
向一名玩家播放音轨 |
/pm playall <track> |
向所有在线玩家播放音轨 |
/pm stop <player|all> |
停止某名玩家或所有玩家的播放 |
/pm queue add <player|all> <track> |
将音轨添加到队列 |
/pm queue clear <player|all> |
清空队列 |
/pm queue list <player|all> |
显示队列内容 |
/pm queue skip <player|all> |
跳过当前音轨 |
/pm playlist create <name> |
创建一个空播放列表 |
/pm playlist delete <name> |
删除一个播放列表 |
/pm playlist add <name> <track> |
将音轨添加到播放列表 |
/pm playlist remove <name> <track> |
从播放列表中移除音轨 |
/pm playlist mode <name> <mode> |
设置播放列表模式 |
/pm playlist list |
列出所有播放列表 |
/pm playlist show <name> |
显示某个播放列表中的音轨 |
/pm playlist play <player> <name> |
向一名玩家播放播放列表 |
/pm playlist playall <name> |
向所有在线玩家播放播放列表 |
/pm zone create <name> <track|playlist> <source> <radius> <continuous|interval> [seconds] |
在你当前位置创建一个音乐区域 |
/pm zone delete <name> |
删除一个区域 |
/pm zone list |
列出所有区域 |
/pm zone mode <name> <mode> |
设置基于播放列表的区域播放模式 |
/pm reload |
重新加载配置、播放列表和区域 |
权限
每个命令都检查细粒度的权限(purplemusic.download、purplemusic.play、purplemusic.stop、purplemusic.queue、purplemusic.playlist、purplemusic.zone、purplemusic.list、purplemusic.reload)。父级权限 purplemusic.* 授予所有这些权限。
默认情况下,这些权限均对 OP(管理员)开放。
数据结构
plugins/PurpleMusic/
config.yml # 全局设置
playlists.yml # 命名播放列表(自动管理)
zones.yml # 音乐区域(自动管理)
musicdata/ # 所有音频文件(wav / mp3 / flac)
subdirectory-depth 配置选项控制你可以在 musicdata/ 内部嵌套文件的深度(none、single 或 unrestricted)。
源代码:
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:
评论 0
登录后参与评分
还没有评论,来抢沙发吧