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

一个通过 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 步:安装依赖
- 在服务器上安装 Simple Voice Chat
- 在服务器上安装 FFmpeg:
- FFmpeg 文件为 zip 格式。将其复制到
FFmpeg/bin/FFmpeg.exe 路径,并粘贴到 Plugins/MusicBot 服务器路径下。!!!
- Windows: 从 ffmpeg.org 下载,解压后添加到 PATH
- Linux:
sudo apt install ffmpeg
- Mac:
brew install ffmpeg
第 2 步:安装插件
- 从 Releases 下载
MusicBot.jar
- 将其放入你的
plugins/ 文件夹
- 重启服务器
第 3 步:添加音乐
- 将你的音乐文件(MP4/MP3/OGG/WAV)放入
plugins/MusicBot/music/
- 使用
/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/ 文件夹及翻译文件
? MusicBot - Minecraft Voice Chat Music Player
? Demo

A Spigot plugin that plays music through Simple Voice Chat groups.
Works like a Discord music bot, but inside Minecraft!
✨ Features
- ? Play MP4/MP3/OGG/WAV music files in Voice Chat groups
- ? Group-only playback (only group members hear the music)
- ? Queue system with skip, pause, resume
- ? Per-player volume control
- ? BossBar now-playing display with progress
- ? Secure - no system paths exposed to players
- ? Smart song search with fuzzy matching
- ⌨️ Tab completion for song names
- ? Auto-detect new songs with /music reload
- ? Custom Voice Chat volume category with icon
? Requirements
| Requirement |
Version |
| Minecraft Server |
Spigot/Paper 1.20.2+ |
| Java |
21+ |
| Simple Voice Chat |
2.5.x |
| FFmpeg |
Any recent version |
? Installation
Step 1: Install Dependencies
- Install Simple Voice Chat on your server
- Install FFmpeg on your server:
- The FFmpeg file will be in zip format. Copy it to the FFmpeg/bin/FFmpeg.exe path and paste it into the Plugins/
MusicBot server path.!!!
- Windows: Download from ffmpeg.org, extract, add to PATH
- Linux:
sudo apt install ffmpeg
- Mac:
brew install ffmpeg
Step 2: Install Plugin
- Download
MusicBot.jar from Releases
- Put it in your
plugins/ folder
- Restart the server
Step 3: Add Music
- Put your music files (MP4/MP3/OGG/WAV) in
plugins/MusicBot/music/
- Use
/music reload to refresh the song list
? Commands
| Command |
Description |
/music play <name> |
Play a song (with tab complete!) |
/music list |
Show all available songs |
/music stop |
Stop playback and clear queue |
/music pause |
Pause current song |
/music resume |
Resume paused song |
/music skip |
Skip to next song in queue |
/music volume <0-100> |
Set playback volume |
/music queue |
Show current queue |
/music reload |
Reload config and song list (admin) |
? Permissions
| Permission |
Description |
Default |
musicbot.use |
Use music bot commands |
Everyone |
musicbot.admin |
Reload config and songs |
OP |
⚠️ Important Notes
- Players must be in a Voice Chat group to use the music bot
- Only group members can hear the music
- If the DJ (person who started playing) leaves the group, music stops
- New members joining the group will automatically hear the music
? Supported Formats
.mp4 (recommended - small file size)
.mp3
.ogg
.wav
.m4a
.flac
.webm
? Changelog
v1.1.0 — Group Session Update
? Bug Fixes
- Fixed: Queue was per-player instead of per-group. Now all group members share one queue.
- Fixed: Multiple players in the same group could start separate music sessions causing audio overlap.
- Fixed: Any player could stop/pause/skip music. Now only the DJ (session starter) can control playback.
- Fixed: System file paths were exposed to players in error messages and
/music list.
- Fixed: Audio cache didn't invalidate when music files were replaced with the same filename.
- Fixed: Players not connected to Voice Chat could trigger errors.
✨ New Features
- Group-Based Sessions: Each Voice Chat group now has exactly one shared music session.
- DJ System: The player who starts the music becomes the DJ. Only the DJ can stop, pause, resume, skip, and change volume.
- All Members Can Queue: Any group member can add songs to the queue with
/music play.
- Multi-Language Support: Players can choose their own language with
/music lang.
- Persian (Farsi) Language: Full Persian translation included.
- Auto DJ Transfer: When the DJ leaves the group, music stops automatically.
- BossBar Now Playing: Shows current song, progress bar, elapsed time, and who requested it — only visible to group members.
- Smart Song Search: Fuzzy matching, partial name search, and word matching.
- Tab Completion: Song names auto-complete when typing
/music play.
? Security
- Path traversal protection (blocks
../../ attacks)
- Input sanitization on all commands
- Rate limiting (1 second cooldown between commands)
- No system paths exposed to players
- File access restricted to
plugins/MusicBot/ folder only
- Error messages sanitized before showing to players
? Supported Languages
| Code |
Language |
Command |
en |
English ?? |
/music lang en |
fa |
فارسی ?? |
/music lang fa |
?️ Technical Changes
- Session architecture changed from per-player to per-group
- Queue is now shared across all group members
- Audio cache hash includes file modification time and size
- Group membership monitored every 3 seconds
- Added
playerdata.yml for persistent language preferences
- Added
lang/ folder with translation files
评论 0
登录后参与评分
还没有评论,来抢沙发吧