? BoomBox
BoomBox 是由 Melo Development 为 Paper 26.2 及以下版本打造的一款生产级、高性能的 Minecraft Paper 插件。它通过 Simple Voice Chat API 直接传输 3D 空间音频和自定义音乐,无需资源包或客户端声音修改。
.---------------------------------------------------.
| ___ ___ ___ __ __ ___ ___ _ _ |
| | _ ) / _ \ / _ \| \/ | _ )/ _ \| \/ | |
| | _ \| (_) | (_) | |\/| | _ \ (_) | /\ |
| |___/ \___/ \___/|_| |_|___/\___/_/ \ |
| M E L O D E V E L O P M E N T S |
| .---------------------------------------------. |
| | (o) | [===] :: B O O M B O X :: [===] | (o) |
| '---------------------------------------------' |
'---------------------------------------------------'
? 主要功能
- ?️ 原生 Simple Voice Chat 集成: 通过 Simple Voice Chat 的 UDP 套接字直接发送 48kHz 单声道 Opus 音频数据包。
- ? 自定义 3D 唱片机玩家头颅与全息图: 自动生成带有浮动标题全息图的自定义唱片机玩家头颅,显示当前播放曲目及归属者。
- ? 扬声器所有权保护: 服务器管理员可以通过
/speaker setowner <speaker> <player>为扬声器分配所有者。只有指定的所有者或服务器管理员才能对该扬声器进行播放、停止或音量调节操作。 - ? 本地音乐库播放: 将
.mp3、.wav或.ogg文件直接放入plugins/BoomBox/music/即可流式播放。 - ? 曲目循环: 使用
/music loop <speaker> [true|false]为每个扬声器切换曲目循环模式。 - ?️ 全息图显示开关: 通过
/speaker hologram <speaker> [true|false]为每个扬声器盒切换浮动文本全息图的显示状态。 - ? 纯 Java MP3 音频解码器 (
JLayer): 零外部系统依赖(无需FFmpeg二进制文件)。在 Windows、Linux 和 Pterodactyl Docker 容器中无缝运行。 - ? 便携式玩家收音机: 手持式音箱物品,无论玩家走到哪里都能播放音频。
- ? WorldGuard 与区域音频: 将位置背景音或声景绑定到特定的 WorldGuard 区域。
- ? Melo Development 许可证验证: 安全的授权系统,连接至 Melo Development 的中心验证 API (
http://in-01.upzare.com:3000/verify)。
? 安装指南
- 前置条件:
- Paper / Purpur 服务器 (Paper 26.2 及以下)。
- 已安装并配置好 Simple Voice Chat 插件。
- 下载
BoomBox-1.0.0.jar并将其放入服务器的plugins/目录中。 - 将本地音乐文件 (
.mp3,.wav,.ogg) 放入plugins/BoomBox/music/。 - 启动服务器以生成
plugins/BoomBox/config.yml。 - 打开
plugins/BoomBox/config.yml并插入你的 Melo Development 许可证密钥:license: key: "YOUR-LICENSE-KEY" - 运行
/boombox reload或重启服务器。
? 命令与权限
? 玩家音乐命令
| 命令 | 权限 | 描述 |
|---|---|---|
/music play <speaker> <track> |
boombox.music.use |
在扬声器上播放本地曲目 |
/music playhere <track> |
boombox.music.use |
在你脚下创建扬声器并播放音频 |
/music stop <speaker> |
boombox.music.use |
停止扬声器上的音乐播放 |
/music volume <speaker> <0.0-2.0> |
boombox.music.use |
调整扬声器音频音量 |
/music loop <speaker> [true/false] |
boombox.music.use |
切换或设置曲目循环 |
/music list |
boombox.music.use |
列出音乐库中所有可用曲目 |
? 管理员扬声器命令
| 命令 | 权限 | 描述 |
|---|---|---|
/speaker create <name> [radius] |
boombox.admin |
在你所在位置创建新的扬声器 |
/speaker setowner <name> <player> |
boombox.admin |
指定一名玩家为扬声器的唯一所有者 |
/speaker hologram <name> [true/false] |
boombox.admin |
切换浮动文本全息图的显示 |
/speaker move <name> |
boombox.admin |
将扬声器移动到你脚下 |
/speaker delete <name> |
boombox.admin |
删除扬声器 |
/speaker head [name] |
boombox.admin |
获得一个自定义 3D 唱片机玩家头颅物品 |
/speaker list |
boombox.admin |
列出所有已注册的扬声器、位置和所有者 |
⚙️ 主管理员命令
| 命令 | 权限 | 描述 |
|---|---|---|
/boombox reload |
boombox.admin |
重载配置、许可证和音频库 |
/radio give <player> |
boombox.radio.use |
给予玩家便携式手持收音机物品 |
/regionmusic set <region> <track> |
boombox.region.use |
将音乐播放绑定到 WorldGuard 区域 |
⚙️ 配置 (config.yml)
# ====================================================== #
# BoomBox Configuration #
# ====================================================== #
# Melo Development 许可证密钥 (通过 Discord /genlicense 生成)
license:
key: "YOUR-LICENSE-KEY"
voicechat:
# 空间音频的最大可听距离(以方块为单位)
distance: 32
# 全局主音量乘数 (0.0 到 2.0)
volume: 1.0
# 启用立体声音频编码
stereo: true
# Opus 编码比特率,单位为每秒比特数
opus-bitrate: 64000
music:
# 在插件启动时自动扫描 /music 文件夹
scan-on-start: true
# 服务器允许的最大同时活动音频流数量
max-active-streams: 32
performance:
# 在主 Minecraft 线程之外异步解码音频文件
async-decode: true
# 流式更新频率(Hz)
update-rate: 20
? 音乐文件夹
将 .mp3、.wav 或 .ogg 音频文件放入 plugins/BoomBox/music/。它们将在启动或使用 /boombox reload 时自动被扫描。
? 致谢
由 Melo Development 用 ❤️ 开发。
- 支持版本: Paper 26.2 及以下。
- 音频引擎: JLayer & Simple Voice Chat API 2.5+。
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
28
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧