MusicBot

插件

· 作者 dlkhwshabwlfdl

一个强大的 Minecraft 音乐机器人,可通过 Simple Voice Chat 播放音频,无需资源包。?

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

最新 2.0.0 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

? MusicBot - Minecraft 语音聊天音乐播放器

? 演示

Demo

一个通过 Simple Voice Chat 群组播放音乐的 Spigot 插件。 功能类似 Discord 音乐机器人,但在 Minecraft 中运行!

✨ 特性

  • ? 在语音聊天群组中播放 MP4/MP3/OGG/WAV 音乐文件
  • ? 仅限群组内播放(只有群组成员能听到音乐)
  • ? 队列系统,支持跳过、暂停、恢复
  • ? 玩家独立音量控制
  • ? BossBar 当前播放显示,包含进度条
  • ? 安全 - 不向玩家暴露系统路径
  • ? 智能歌曲搜索,支持模糊匹配
  • ⌨️ 歌曲名称 Tab 补全
  • ? 使用 /music reload 自动检测新歌曲
  • ? 自定义语音聊天音量类别及图标

? 依赖要求

依赖项 版本
Minecraft 服务器 Spigot/Paper 1.20.2+
Java 21+
Simple Voice Chat 2.5.x
FFmpeg 任意较新版本

? 安装

第 1 步:安装依赖

  1. 在服务器上安装 Simple Voice Chat
  2. 在服务器上安装 FFmpeg:
  3. FFmpeg 文件为 zip 格式。将其复制到 FFmpeg/bin/FFmpeg.exe 路径,并粘贴到 Plugins/MusicBot 服务器路径下。!!!
    • Windows: 从 ffmpeg.org 下载,解压后添加到 PATH
    • Linux: sudo apt install ffmpeg
    • Mac: brew install ffmpeg

第 2 步:安装插件

  1. 从 Releases 下载 MusicBot.jar
  2. 将其放入你的 plugins/ 文件夹
  3. 重启服务器

第 3 步:添加音乐

  1. 将你的音乐文件(MP4/MP3/OGG/WAV)放入 plugins/MusicBot/music/
  2. 使用 /music reload 刷新歌曲列表

? 命令

命令 描述
/music play <name> 播放歌曲(支持 Tab 补全!)
/music list 显示所有可用歌曲
/music stop 停止播放并清空队列
/music pause 暂停当前歌曲
/music resume 恢复暂停的歌曲
/music skip 跳过队列中的下一首歌曲
/music volume <0-100> 设置播放音量
/music queue 显示当前队列
/music reload 重载配置和歌曲列表(管理员)

? 权限

权限 描述 默认值
musicbot.use 使用音乐机器人命令 所有人
musicbot.admin 重载配置和歌曲 OP

⚠️ 注意事项

  • 玩家必须处于语音聊天群组中才能使用音乐机器人
  • 只有群组成员能听到音乐
  • 如果 DJ(开始播放的人)离开群组,音乐会停止
  • 新加入群组的成员会自动听到音乐

? 支持的格式

  • .mp4(推荐 - 文件大小较小)
  • .mp3
  • .ogg
  • .wav
  • .m4a
  • .flac
  • .webm

? 更新日志

v1.1.0 — 群组会话更新

? 错误修复

  • 已修复: 队列原本是按玩家区分的,现在改为按群组共享。所有群组成员共用一个队列。
  • 已修复: 同一群组内的多个玩家可以启动独立的音乐会话,导致音频重叠。
  • 已修复: 任何玩家都可以停止/暂停/跳过音乐。现在只有 DJ(会话启动者)可以控制播放。
  • 已修复: 系统文件路径在错误消息和 /music list 中向玩家暴露。
  • 已修复: 当用相同文件名替换音乐文件时,音频缓存未失效。
  • 已修复: 未连接到语音聊天的玩家会触发错误。

✨ 新功能

  • 基于群组的会话: 每个语音聊天群组现在拥有唯一一个共享的音乐会话。
  • DJ 系统: 开始播放音乐的玩家成为 DJ。只有 DJ 可以停止、暂停、恢复、跳过和更改音量。
  • 所有成员均可排队: 任何群组成员都可以通过 /music play 将歌曲添加到队列。
  • 多语言支持: 玩家可以使用 /music lang 选择自己的语言。
  • 波斯语(Farsi)支持: 包含完整的波斯语翻译。
  • 自动 DJ 转移: 当 DJ 离开群组时,音乐会自动停止。
  • BossBar 当前播放: 显示当前歌曲、进度条、已播放时间以及请求者信息——仅对群组成员可见。
  • 智能歌曲搜索: 支持模糊匹配、部分名称搜索和单词匹配。
  • Tab 补全: 输入 /music play 时,歌曲名称自动补全。

? 安全性

  • 路径遍历保护(阻止 ../../ 攻击)
  • 所有命令的输入清理
  • 速率限制(命令之间 1 秒冷却时间)
  • 不向玩家暴露系统路径
  • 文件访问仅限于 plugins/MusicBot/ 文件夹
  • 显示给玩家前清理错误消息

? 支持的语言

代码 语言 命令
en English ?? /music lang en
fa فارسی ?? /music lang fa

?️ 技术变更

  • 会话架构从按玩家改为按群组
  • 队列现在在所有群组成员间共享
  • 音频缓存哈希包含文件修改时间和大小
  • 每 3 秒监控一次群组成员资格
  • 添加 playerdata.yml 用于持久化语言偏好
  • 添加 lang/ 文件夹及翻译文件

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源