BOOMBOX

插件

· 作者 Ruptyl

Boombox 允许你将自定义音乐文件放入文件夹,并在 Minecraft 中播放。

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

最新 1.0.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

? 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)。

? 安装指南

  1. 前置条件:
    • Paper / Purpur 服务器 (Paper 26.2 及以下)。
    • 已安装并配置好 Simple Voice Chat 插件。
  2. 下载 BoomBox-1.0.0.jar 并将其放入服务器的 plugins/ 目录中。
  3. 将本地音乐文件 (.mp3, .wav, .ogg) 放入 plugins/BoomBox/music/。
  4. 启动服务器以生成 plugins/BoomBox/config.yml。
  5. 打开 plugins/BoomBox/config.yml 并插入你的 Melo Development 许可证密钥:
    license:
      key: "YOUR-LICENSE-KEY"
    
  6. 运行 /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+。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源