DSMPMusic
通过 Simple Voice Chat 在游戏中播放 MP3 / OGG 音频,支持语音消息集成、本地音乐与远程 URL 播放。
? 简介
DSMPMusic 是一款 Paper 服务器插件,可通过 Simple Voice Chat 流式传输音频文件。
你可以播放本地 MP3/OGG 音乐,从远程 URL 流式传输音频,将音乐下载到服务器存储中,暂停/恢复/停止播放,通过 Voice Messages 发送游戏内语音消息形式的音乐,并添加基于自定义时间戳的歌词。
⚠️ 强制依赖:Simple Voice Chat 必须安装在你的服务器上。
Voice Messages 是一个可选的软依赖,仅在使用 /dmc vmsg 时需要。
✨ 功能
- 为自己、特定玩家或所有在线玩家播放本地音乐
- 直接从 HTTP/HTTPS 远程 URL 流式传输音频
- 将远程音频文件下载到服务器音乐文件夹
- 暂停、恢复和停止音频播放
- 与 Voice Messages 集成:将音乐作为可播放的语音消息发送
- 手动自定义定时歌词系统(插件不自动生成歌词)
- 内置多语言支持:英语 (
en_US)、中文 (zh_CN)
- 可配置音量、音频时长限制、网络超时,支持绕过语音聊天群组隔离
- 加载顺序安全:即使 Simple Voice Chat 在 DSMPMusic 之后加载也能正常工作
? 要求
- 服务器:Paper 1.21.11
- Java 版本:21
- 必需插件:Simple Voice Chat
- 可选插件:Voice Messages(用于
/dmc vmsg 子命令)
? 命令
别名:dsmpmusic, dmusic, dmc
| 命令 |
描述 |
/dmc play <me|player|all> <filename> |
播放本地音乐文件 |
/dmc url <url> <me|player|all> |
从远程 URL 播放音频 |
/dmc stop [me|player|all] |
停止当前正在播放的音乐 |
/dmc download <url> <name> |
将音频下载到本地音乐文件夹 |
/dmc pause [me|player|all] |
暂停或恢复播放 |
/dmc vmsg <file> |
将音乐作为 Voice Messages 语音消息发送 |
/dmc list |
列出所有本地音乐文件 |
/dmc reload [config|lang] |
重新加载配置文件或语言文件 |
/dmc help |
显示命令帮助 |
? 权限
dsmpmusic.play.me: 为自己播放音乐(默认:true)
dsmpmusic.play.other: 为其他玩家或所有人播放音乐(默认:op)
dsmpmusic.url: 从远程 URL 播放音频(默认:op)
dsmpmusic.stop.me: 停止自己的音乐播放(默认:true)
dsmpmusic.stop.other: 停止其他玩家或全局音乐(默认:op)
dsmpmusic.download: 下载远程音频文件(默认:op)
dsmpmusic.reload: 重载插件配置和语言文件(默认:op)
dsmpmusic.vmsg: 使用语音消息音乐功能(默认:true)
dsmpmusic.pause: 暂停/恢复自己正在播放的音乐(默认:true)
dsmpmusic.pause.other: 暂停/恢复其他玩家或所有玩家的音乐(默认:op)
dsmpmusic.list: 列出本地音乐文件(默认:op)
? 插件文件夹结构 (plugins/dsmpmusic/)
dsmpmusic/
├─ config.yml # 主插件配置文件
├─ lang/ # 语言资源文件 (zh_CN.yml / en_US.yml)
├─ music/ # 在此放置 MP3 / OGG 音频文件
├─ cache/ # 网络下载的临时目录
└─ word/ # 歌词存储文件夹
└─ template.yml # 歌词文件模板
? 歌词说明
该插件无法自动生成歌词。所有歌词文件必须手动编写。
- 复制
word/template.yml
- 将复制的文件重命名为与你的音频文件名匹配:例如
music/song.mp3 → word/song.yml
- 为每一行歌词设置
start(秒)、end(秒)和 text。
- 没有歌词条目的时间范围将自动变为纯音乐部分(前奏、间奏、尾奏)。
⚙️ 重要配置选项 (config.yml)
language: 切换语言,可选 zh_CN 或 en_US
playback.volume: 全局播放音量乘数
playback.bypass-group-isolation: 绕过 Simple Voice Chat 的群组隔离
playback.max-audio-seconds: 正常音乐播放允许的最大时长
vmsg.enabled: 启用/禁用语音消息集成
vmsg.max-seconds: 语音消息发送的最大音频长度限制
network: 连接超时、读取超时、最大下载大小限制
? 注意事项
- 支持的音频格式:MP3, OGG。
- 对于 URL 播放,你必须使用直接的原始音频资源链接。
- 内置加载顺序处理,你无需修改插件加载优先级。
- 如果缺少语音消息插件或在配置中关闭,
/dmc vmsg 命令将被禁用。
源代码
DsmpMusic 的源代码已发布在 GitHub 上,仅供参考。
?
许可证
保留所有权利(ARR)。
您可以查看源代码,但未经我的书面许可,您不得修改、编译、重新分发或创建衍生作品。
DSMPMusic
Play MP3 / OGG audio in‑game via Simple Voice Chat, with Voice Messages integration, local music & remote URL playback.
? About
DSMPMusic is a Paper server plugin that streams audio files through Simple Voice Chat.
You can play local MP3/OGG music, stream audio from remote URLs, download music to server storage, pause/resume/stop playback, send music as in‑game voice messages via Voice Messages, and add custom timestamp‑based lyrics.
⚠️ Mandatory Dependency: Simple Voice Chat must be installed on your server.
Voice Messages is an optional soft‑dependency only required for /dmc vmsg.
✨ Features
- Play local music for yourself, a specific player, or all online players
- Stream audio directly from HTTP/HTTPS remote URLs
- Download remote audio files into the server music folder
- Pause, resume and stop audio playback
- Integrate with Voice Messages: send music as playable voice messages
- Manual custom timed‑lyric system (plugin does NOT auto‑generate lyrics)
- Built‑in multi‑language support: English (
en_US), Chinese (zh_CN)
- Configurable volume, audio duration limits, network timeouts, bypass voice‑chat group isolation
- Load‑order safety: works even if Simple Voice Chat loads after DSMPMusic
? Requirements
- Server: Paper 1.21.11
- Java Version: 21
- Required Plugin: Simple Voice Chat
- Optional Plugin: Voice Messages (for
/dmc vmsg subcommand)
? Commands
Aliases: dsmpmusic, dmusic, dmc
| Command |
Description |
/dmc play <me|player|all> <filename> |
Play local music file |
/dmc url <url> <me|player|all> |
Play audio from remote URL |
/dmc stop [me|player|all] |
Stop currently playing music |
/dmc download <url> <name> |
Download audio to local music folder |
/dmc pause [me|player|all] |
Pause or resume playback |
/dmc vmsg <file> |
Send music as Voice Messages voice message |
/dmc list |
List all local music files |
/dmc reload [config|lang] |
Reload configuration or language files |
/dmc help |
Show command help |
? Permissions
dsmpmusic.play.me: Play music for yourself (default: true)
dsmpmusic.play.other: Play music for other players or everyone (default: op)
dsmpmusic.url: Play audio from remote URL (default: op)
dsmpmusic.stop.me: Stop your own music playback (default: true)
dsmpmusic.stop.other: Stop other players' or global music (default: op)
dsmpmusic.download: Download remote audio files (default: op)
dsmpmusic.reload: Reload plugin config and language files (default: op)
dsmpmusic.vmsg: Use Voice Messages music message feature (default: true)
dsmpmusic.pause: Pause/resume your own playing music (default: true)
dsmpmusic.pause.other: Pause/resume music for others or all players (default: op)
dsmpmusic.list: List local music files (default: op)
? Plugin Folder Structure (plugins/dsmpmusic/)
dsmpmusic/
├─ config.yml # Main plugin configuration
├─ lang/ # Language resource files (zh_CN.yml / en_US.yml)
├─ music/ # Place your MP3 / OGG audio files here
├─ cache/ # Temporary directory for network downloads
└─ word/ # Lyric storage folder
└─ template.yml # Lyric file template
? Lyric Instructions
The plugin cannot generate lyrics automatically. All lyric files must be written manually.
- Copy
word/template.yml
- Rename the copied file to match your audio filename: e.g.
music/song.mp3 → word/song.yml
- Set
start(seconds), end(seconds), text for each lyric line.
- Time ranges without lyric entries will automatically become instrumental sections (intro, interlude, outro).
⚙️ Important Configuration Options (config.yml)
language: Switch language, zh_CN or en_US
playback.volume: Global playback volume multiplier
playback.bypass-group-isolation: Bypass Simple Voice Chat group separation
playback.max-audio-seconds: Maximum allowed duration for normal music playback
vmsg.enabled: Toggle Voice Messages integration
vmsg.max-seconds: Maximum audio length limit for voice‑message sending
network: Connection timeout, read timeout, maximum download size limit
? Notes
- Supported audio formats: MP3, OGG.
- For URL playback, you must use a direct raw audio resource link.
- Built‑in load‑order handling, you do not need to modify plugin load priority.
/dmc vmsg will be disabled if Voice Messages plugin is missing or turned off in config.
Source Code
The source code of DsmpMusic is published on GitHub for reference only.
?
License
All Rights Reserved (ARR).
You may view the source code, but you are not allowed to modify, compile, redistribute or create derivative works without my written permission.
评论 0
登录后参与评分
还没有评论,来抢沙发吧