BS CustomJukebox

插件

· 作者 boondocksulfur

功能齐全的 Paper 1.21.x、26.x 唱片机插件,支持自定义音乐唱片、唱片碎片、GUI 界面以及 WorldGuard/GriefPrevention 集成。

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

最新 3.7.1 · 26.3 · Folia / Paper

一键开服(送7天)

CustomJukebox

在你的 Minecraft 服务器上播放真正的音乐。 CustomJukebox 将唱片机转变为完整的音乐系统:支持使用你自己的 .ogg 音轨制作自定义唱片、播放列表,以及当玩家进入特定区域时自动播放背景音乐的动态区域——这一切都无需替换任何原版唱片。

专为 Paper 和 Folia 构建,通过 JSON 进行配置,并已翻译为四种语言。


? 使用 Bedrock 版玩家?

CustomJukebox 从 Java 版的资源包中流式传输音频,而 Bedrock 客户端对其处理方式不同。如果你运行 Geyser/Floodgate,请安装配套插件:

➡️ BS-CustomJukebox Bedrock Extension

它会挂钩到此插件触发的公共 API 事件,因此 CustomJukebox 端无需额外配置——只需同时安装两者即可协同工作。


?️ 还没有资源包?

正确设置资源包是最繁琐的部分。有四个名称必须一致——.ogg 路径、sounds.json 中的事件键、其中的 name 字段以及 disc.json 中的 sound 字段——只要有一个不匹配就会导致无声,且两侧都不会报错。

➡️ CustomJukebox Pack Generator

将你的音频放入其中,即可获得一个可直接托管的 pack.zip、匹配的 disc.json 以及两条已计算好 SHA-1 值的 server.properties 行。它会在你的浏览器中将 mp3、wav 和 flac 转换为 Ogg Vorbis 格式——无需上传,你的音乐永远不会离开你的设备——还会绘制唱片和碎片的纹理,并支持加载现有资源包,以便你在不破坏现有功能的情况下添加新音轨。


✨ 功能特性

? 自定义音乐唱片

  • 添加你自己的音乐唱片,而无需覆盖原版唱片
  • 通过资源包(.ogg)实现真实音频——全音质,而非音符盒
  • 可自定义标题、作者、描述文本(Lore)和 CustomModelData
  • 在配置的曲目长度到达时自动停止
  • 可在 disc.json 中管理,或通过管理员 GUI 在游戏中完全管理

? 动态区域与服务器广播

让背景音乐在玩家进入区域时自动开始播放——无需唱片、指令或红石。

  • 四种区域类型: 半径、长方体、WorldGuard 区域,或全局(一种覆盖所有世界每位玩家的服务器级广播电台)
  • 优先级决定当多个区域重叠时哪个生效——例如大厅区域的优先级可以高于广播电台
  • 两种播放模式: synced(所有人同时听到同一首曲目——适合活动场合)或 individual(每位玩家从进入时刻起听到完整的曲目——适合大厅场景)
  • 高度范围: 覆盖整个垂直柱体(默认),或在 Y 轴上限制区域,形成真正的 3D 球体/立方体
  • 循环与随机播放,每次循环结束后重新洗牌
  • 每个区域可独立设置音量和播放列表

? 播放列表与分类

  • 将唱片分组到播放列表中并按顺序播放
  • 随机播放和重复模式(loop、repeat-one)
  • 每个播放列表的播放范围:正常、整个世界、服务器全局,或自定义半径(以方块为单位)
  • 分类功能,用于整理大型唱片收藏

? 玩家控制

默认情况下每位玩家都拥有这些权限——无需进行权限设置。

  • /cjb music on|off —— 完全退出插件音乐,设置跨会话保存
  • /cjb music volume —— 个人音量,独立于服务器设置
  • /cjb skip —— 跳过当前正在播放的曲目
  • /cjb favorite —— 创建个人收藏列表并将其作为播放列表播放;也可在唱片菜单中按住 Shift 右键点击唱片来收藏
  • 进度条 —— 可选的 Boss 栏,显示当前曲目及其播放进度

? 碎片系统

  • 收集唱片碎片并合成为完整唱片(无形状合成,数量可配置)
  • 爬行者掉落: 骷髅击杀爬行者时必定掉落,玩家击杀时掉落概率可配置
  • 战利品集成: 碎片会出现在地牢、堡垒遗迹、末地城、遗迹废墟等地方

?️ 游戏内管理

  • 唱片机 GUI —— 右键点击空的唱片机以选择唱片
  • 管理面板 (/cjb gui) —— 创建、编辑和删除唱片、播放列表和分类,无需触碰文件
  • 带有输入验证的分步创建向导
  • 区域编辑器 GUI,明确指出某个区域尚未播放的原因
  • 所有列表均支持分页,确保大型收藏仍可完全访问
  • 对破坏性操作提供删除确认

? 集成与兼容性

  • Paper 1.21.4 – 26.x 和 Folia(区域线程调度,自动检测)
  • WorldGuard —— 尊重 USE 标志,并可将动态区域绑定到指定区域
  • GriefPrevention —— 尊重容器信任机制
  • PlaceholderAPI —— 16 个占位符(手中持有的唱片、音量、静音状态、总数等)
  • 多语言支持: 英语、德语、西班牙语、意大利语——完全翻译,可编辑
  • 开发者 API,包含四个 Bukkit 事件(DiscPlaybackStart/Stop、DiscRegistered/Removed)
  • bStats 指标数据(可选择退出)

? 鹦鹉跳舞

鹦鹉会对一定半径内的自定义音乐做出反应。


? 命令

对所有玩家可用

命令 描述
/cjb music <on|off|toggle|volume <0-4|reset>|status> 你的个人音乐设置
/cjb skip 跳过当前正在听到的曲目
/cjb favorite <add|remove|toggle|list|play|clear> 管理和播放你的收藏
/cjb gui 打开唱片菜单
/cjb list [page] · /cjb info <disc> 浏览唱片

对管理员可用

命令 描述
/cjb zone <...> 创建和管理动态区域及广播电台
/cjb playlist <...> 创建和播放播放列表
/cjb play <disc> [loop] [global|world|<radius>] 在你所在位置播放一张唱片
/cjb give · /cjb fragment 发放唱片和碎片
/cjb volume · /cjb mute · /cjb unmute 服务器全局音量
/cjb stop · /cjb reload 停止播放 / 重载配置

别名:/customjukebox, /jukebox, /jb


? 权限

权限 默认值 说明
customjukebox.use everyone 使用唱片机
customjukebox.gui · .list · .info everyone 浏览唱片
customjukebox.music · .favorite · .skip everyone 个人设置、收藏、跳过
customjukebox.admin op 所有管理命令(父级)
customjukebox.zone · .playlist · .play · .stop · .volume op 独立的管理权限
customjukebox.give · .fragment · .reload op 物品发放与重载
customjukebox.bypass.protection op 忽略 WorldGuard/GriefPrevention 检查

? 依赖项

  • 服务端: Paper 1.21.4+ 或 Folia(也可在 26.x 上运行)
  • Java: 21 或更高版本
  • 一个资源包,其中包含你的 .ogg 文件 —— 用于使自定义音效可被听到
  • 可选: WorldGuard、GriefPrevention、PlaceholderAPI、Geyser/Floodgate(需配合 Bedrock Extension)

? 快速开始

  1. 将 JAR 放入 plugins/ 目录并启动服务器。它将创建 config.json、disc.json、zones.json 以及 languages/ 文件夹。
  2. 将你的 .ogg 文件放入资源包并在 sounds.json 中注册它们 —— 或者让 Pack Generator 为你构建资源包、纹理以及匹配的 disc.json。
  3. 托管该资源包,并在 server.properties 中设置 resource-pack 和 resource-pack-sha1。
  4. 创建一张唱片 —— 最简单的方法是通过 /cjb gui → Admin Panel → Disc Management,或编辑 disc.json。
  5. /cjb reload

大厅音乐仅需四条命令

/cjb playlist create lobby-mix
/cjb playlist add lobby-mix my_track
/cjb zone create lobby            # 以你站立的位置为中心
/cjb zone radius lobby 60
/cjb zone playlist lobby lobby-mix

区域默认启用且循环播放。若要覆盖整个服务器的电台,请使用 /cjb zone global <id> 代替半径设置。


⚙️ 配置

config.json —— 显示的每个值均为默认值:

{
  "settings": {
    "enabled": true,
    "language": "en",
    "enable-gui": true,
    "debug": false,
    "max-backups": 5,
    "backup-min-interval-minutes": 5
  },
  "discs": {
    "creeper-drops": true,
    "creeper-drop-chance": 0.05,
    "dungeon-loot": true,
    "trail-ruins-loot": true,
    "max-loot-discs": 2,
    "loot-chance": 0.15,
    "enable-crafting": true,
    "fragments-per-disc": 9
  },
  "playback": {
    "volume": 4.0,
    "default-loop": false,
    "jukebox-hearing-radius": 64,
    "show-title": true,
    "show-actionbar": true,
    "show-progress-bar": true,
    "progress-update-ticks": 20
  },
  "parrots": {
    "enable-dancing": true,
    "dance-radius": 3
  },
  "ambient-zones": {
    "enabled": true,
    "sound-category": "RECORDS"
  },
  "integrations": {
    "worldguard": true,
    "griefprevention": true
  }
}

环境区域位于 zones.json,唱片和播放列表位于 disc.json,每位玩家的设置位于 players.json。所有文件均以异步方式写入并原子替换,因此保存操作永远不会阻塞服务器主线程,且中断的写入不会导致配置文件损坏。


? 链接

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源