DsmpMusic

插件

· 作者 dydaozhu

基于语音聊天的音乐播放系统,支持播放本地 MP3 和 WAV 文件以及 URL 流,并可将音乐消息发送到聊天框。

0 本站下载 0 关注 更新于 1 个月前

最新 2.0.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

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      # 歌词文件模板

? 歌词说明

该插件无法自动生成歌词。所有歌词文件必须手动编写。

  1. 复制 word/template.yml
  2. 将复制的文件重命名为与你的音频文件名匹配:例如 music/song.mp3 → word/song.yml
  3. 为每一行歌词设置 start(秒)、end(秒)和 text。
  4. 没有歌词条目的时间范围将自动变为纯音乐部分(前奏、间奏、尾奏)。

⚙️ 重要配置选项 (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: 连接超时、读取超时、最大下载大小限制

? 注意事项

  1. 支持的音频格式:MP3, OGG。
  2. 对于 URL 播放,你必须使用直接的原始音频资源链接。
  3. 内置加载顺序处理,你无需修改插件加载优先级。
  4. 如果缺少语音消息插件或在配置中关闭,/dmc vmsg 命令将被禁用。

源代码

DsmpMusic 的源代码已发布在 GitHub 上,仅供参考。 ?

许可证

保留所有权利(ARR)。 您可以查看源代码,但未经我的书面许可,您不得修改、编译、重新分发或创建衍生作品。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源