CDisc Music

插件

· 作者 valkdzx

将任何音轨(YouTube、Spotify、SoundCloud、VK、Yandex…)变成真正的音乐唱片——通过近距离语音聊天从唱片机中播放,并配有游戏内播放器 GUI 和唱片队列。支持 Simple Voice Chat 或 Plasmo Voice。

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

最新 2.2.4 · 26.3 · Bukkit / Folia

一键开服(送7天)

? CDisc Music

将互联网上的任何音轨变成真正的音乐唱片。
将其放入唱片机后,附近的所有玩家都能通过距离语音聊天听到它:站得越近,声音越大。

支持 YouTube、Spotify、SoundCloud、Yandex Music、VK、TikTok、Twitch、Discord 附件、你自己的音乐文件夹等。

无需 API 密钥、令牌或账号。 安装后即可播放。如果你已有密钥,它们仍然有效,但并非必需。


? 要求

  • Simple Voice Chat 或 Plasmo Voice。只需其中之一;如果同时安装了这两个模组,CDisc 会通过两者播放,因此使用任一模组的玩家都能听到同一个唱片机的声音,而同时安装了两个模组的玩家则只听到一次。
  • Spigot、Paper 或 Folia,1.20 或更高版本。一个 JAR 文件即可兼容这三个服务端实现。

可选:使用 WorldGuard 保护区域内的唱片机,使用 PlaceholderAPI 提供占位符。

将 CDisc 和语音插件放入 plugins/ 目录并重启服务器。玩家需要安装对应的语音聊天 客户端模组 才能听到音乐。


? 快速入门

手持任意音乐唱片并运行:

/cdisc create never gonna give you up

从聊天栏列出的曲目中选择一首。你手中的唱片现在会附带该曲目,并在物品提示中显示名称和作者。将其放入唱片机后,音乐将从唱片机本身播放,范围内所有玩家同步收听。

更多创建唱片的方法:

  • /cdisc create 直接写入一段链接到唱片
  • /cdisc create sc:lofi hip hop 搜索 SoundCloud(yt:、sp:、ym:、vk: 同理)
  • /cdisc create local:rain.mp3 播放位于 plugins/CDisc/local 目录下的文件,支持 Tab 补全
  • /cdisc disc playlist <链接> 写入整个播放列表:将空白唱片放入窗口中,每张唱片对应一首曲目

从那时起,唱片成为了普通物品:你可以携带它、交易它,或者把它存放在箱子里。


✨ 特性

? 唱片机与玩家界面

  • 蹲下查看正在播放的留声机,即可看到显示曲目与时间的进度条,然后右键点击以打开播放器。不蹲下时,右键点击会像原版一样取出唱片。/cdisc sneak 命令允许每位玩家自定义蹲下的行为。
  • 播放器界面:支持播放/暂停、快进/快退 ±5 秒或输入精确的时间码、上一曲/下一曲、重复(关闭、整列循环、单曲循环)和随机播放。在 1.21.6+ 版本中,它会以带有滑块和按钮的真实窗口形式打开;旧版本和 Spigot 服务器则使用箱子界面。
  • 每个留声机拥有 42 张唱片的队列,按顺序依次播放。你可以选择已播放完的唱片如何处理:保留、弹出或移至队尾。
  • 交叉淡入淡出:一张唱片的结尾平滑过渡到下一张,曲目之间无缝衔接。
  • 数据永不丢失:队列会在重启和崩溃后保留,正在播放的留声机会从停止处继续播放,破坏或烧毁留声机会掉落仍保存所有唱片的留声机。重新放置后,队列将恢复。
  • 直播流:Twitch 和 YouTube 的直播内容将在广播持续期间一直播放。
  • 鹦鹉随音乐起舞:CDisc 唱片中的音乐同样会让鹦鹉跳舞,如同原版唱片一般。

? 音效

  • 真正的距离音效:音乐源自留声机,并随距离增加而衰减。
  • 信标范围增强:在留声机下方建造信标金字塔,并通过播放器界面提升其覆盖范围。金字塔等级越高,覆盖范围越大。
金字塔等级 额外范围
1 +16 格
2 +32 格
3 +64 格

Sound Range demo

  • 扬声器组:最多可将 8 台留声机链接为一个组,同步播放同一首曲目。每台扬声器可独立设置为立体声、单声道、左声道或右声道,并调整各自的音量。适用于俱乐部、竞技场或城镇广场。
  • 携带留声机:拿起正在播放的留声机而不停止曲目,音乐会跟随你移动,即使穿过传送门也是如此。使用 /cdisc player scoreboard 命令,歌词会显示在你的侧边栏,而其他玩家则在你头顶上方看到歌词。
  • 双重音量控制:一个用于控制留声机周围玩家的音量,另一个用于控制携带者的音量。
  • 山羊角录音:手持山羊角并使用 /cdisc create 命令,可将短音频录制到山羊角中,默认最长 15 秒。吹响山羊角可通过语音聊天播放录音。

? 留声机上方的歌词

  • 定时歌词:当留声机播放时,来自免费歌词数据库的歌词会逐行浮现在留声机上方。
  • 每位玩家选择自己看到的内容:仅文字、带曲目和时间的文字、带时间的文字、仅曲目和时间、仅时间,或无内容。在玩家界面中点击或右键点击歌词按钮可切换视图,或使用 /cdisc lyrics 命令。
  • 自定义外观:使用 /cdisc preset 设置颜色、大小、不透明度、行数、阴影、淡入淡出和滑动效果,并实时预览。每位玩家都可以按照自己的方式查看全息投影,而 /cdisc preset share <player> 可将你的外观分享给朋友。
  • 服务器预设:管理员可通过 /cdisc admin presets 创建命名的外观,并将其分配给特定玩家、选择器菜单或作为所有人的默认外观。可选择强制应用,以防止任何人更改。
  • 实时聊天:在 Twitch 或 YouTube 直播中,直播间的聊天内容将替代歌词显示。

?️ 广播(实验性功能)

⚠️ 实验性功能。广播功能为新加入特性,可能仍存在漏洞。如果出现问题,请在 GitHub 上报告,最好附上 /cdisc admin logs 日志链接。在 config.yml 中将 broadcast.enabled: false 可关闭该功能。

执行 /cdisc create broadcast:Name 会创建一个不播放音乐的唱片:将其放入留声机后即可开启直播。主持人最多可以添加六个麦克风。手持式麦克风可以在玩家之间传递;方块麦克风则能收录附近所有玩家的语音。声音会从留声机及其关联的所有扬声器中传出,因此只需一张唱片即可搭建舞台或广播电台。

? 专属音乐文件夹

  • 将音频文件放入 plugins/CDisc/local,它们就会成为唱片:支持 local: 前缀的 Tab 补全,直接从磁盘播放,无需下载任何内容。

  • 在音轨旁放置一个 .jsonc 文件,即可为其设置独立的名称、音量、权限和歌词。使用 /cdisc admin local-files-config <file> 命令可在窗口中编辑所有这些配置。

  • /cdisc admin download <链接或搜索> 可从游戏内、YouTube、Spotify、直接链接或搜索结果中将音轨保存到文件夹,从而继续播放原始内容。

?️ 面向服务器管理员

  • 每项操作都有对应的权限:暂停、跳过、快进、排队、手持留声机、歌词显示等,所有权限均在 permissions.yml 中配置。界面会隐藏玩家无权使用的按钮。对于非工作人员的玩家,可设置冷却时间、允许播放的最长曲目时长、直播源开关以及允许的/禁止的主机列表。

  • WorldGuard 支持:位于特定区域内的留声机仅对该区域的成员响应。通过 cdisc-jukebox 标志可将区域内的留声机向所有人开放,或同样限制为仅限成员使用。

  • 设置窗口:在 Minecraft 游戏内使用 /cdisc admin config 命令即可编辑所有配置文件(需 Paper 1.21.7+)。

  • 诊断工具:/cdisc admin doctor 可查看哪些音源正常运行、哪些缺少必要组件;/cdisc admin logs 可上传包含该诊断报告的日志文件用于提交 Bug 反馈,并自动隐藏密钥和令牌等敏感信息。

  • 自动更新:当服务器停机时,会自动从 Modrinth 或 GitHub 下载并安装新版本发布包。此功能可手动关闭。

  • 7 种语言:英语、俄语、乌克兰语、德语、西班牙语、希伯来语和阿拉伯语。每位玩家根据其客户端的语言进行阅读,或者你可以为整个服务器固定一种语言。你的翻译文件会放入 languages/ 目录中。

  • PlaceholderAPI:支持 %cdisc_track%、%cdisc_position%、%cdisc_progress% 等占位符,用于获取玩家可听到的最近唱片机播放的信息。

  • API:其他插件可以监听 TrackStartEvent、PlaybackStopEvent 以及可取消的 DiscCreateEvent,并通过 CDiscApi 查询某台唱片机当前正在播放的内容。

  • 升级保留您的设置:每次从新版 jar 包更新时,配置文件会自动升级到最新版本,您的自定义更改得以保留,旧版配置文件会被备份为 .old 后缀。


? 来源

来源 前缀 需要
YouTube yt:(或无前缀) 无
Spotify sp: 无;仅密钥会使搜索使用 Spotify 本身
SoundCloud sc: 无
Yandex Music ym: 无
VK Music vk: 无
TikTok 链接,或 tt: + 视频编号 无
Twitch、Mixcloud、Reddit 链接 无
Discord 附件 链接 无(Discord 的链接约一天后过期)
你的音乐文件夹 local: 无
任意直接音频链接 链接 sources.yml 中设置 http: true

搜索会显示一个可供选择的列表;在末尾添加 :10 可获取更多结果。专辑和播放列表也可打开。

为什么不需要密钥

YouTube 会优先直接读取。当 YouTube 拒绝服务器请求时(例如针对许多托管地址),CDisc 会向其公共 后端 发起请求,该后端从其自有地址获取音轨。同一后端无需任何令牌即可读取 Spotify、Yandex Music 和 VK 链接。默认启用;可通过 sources.yml 关闭。

如果你添加了它们,tokens.yml 中的密钥和令牌仍会被读取:Spotify 客户端密钥、Yandex Music 和 VK 令牌作为无法访问后端时的备用方案、YouTube po-token,以及出站代理。这些都不是必需的。


⌨️ 命令

指令 功能说明
/cdisc create <链接或搜索> 将音轨写入你手中持有的唱片或山羊角
/cdisc disc clear 将手持的唱片还原为普通唱片
/cdisc disc playlist <链接> 将播放列表写入空白唱片中
/cdisc disc convert 转换由 pv-addon-discs 生成的唱片

| /cdisc player <暂停 \| 播放 \| 下一曲 \| 上一曲 \| 跳转 \| 重复 \| 队列 \| 信息> | 控制你正在查看或手持的唱片机 | | /cdisc player scoreboard | 当你手持唱片机时,在侧边栏显示歌词 |

| /cdisc lyrics <view> | 选择在唱片机上方显示的内容 | | /cdisc preset | 自定义你的全息投影外观;使用 share <player> 可将其分享给其他玩家 | | /cdisc pair <create \| add \| remove \| dissolve \| channel \| volume \| list> | 音箱分组 | | /cdisc sneak <toggle \| release \| off> | 设置你在唱片机前蹲下时的交互方式 | | /cdisc messages | 开启或关闭“正在播放”提示消息 | | /cdisc admin <reload \| doctor \| download \| logs \| config \| presets \| local-files-config> | 服务器管理工具;也可从控制台执行 |


? 统计

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源