CustomDiscs Plugin

插件

· 作者 Navoei

一个 Paper 插件,使用 Simple Voice Chat API 添加自定义音乐唱片、山羊角和玩家头颅。

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

最新 6.0.4 · 26.3 · Folia / Paper

一键开服(送7天)

Custom Discs v6.0.4

适用于 Paper、Folia 及其分支(Purpur、Leaf 等)

1.21.7 至 26.3


⚠️ 依赖说明 — 需要 PacketEvents

自版本 5.2.0 起,需要 PacketEvents (v2.12.1+)。
不再使用 ProtocolLib — 如果没有其他插件需要它,可以安全地移除。

⚠️ 需要 Java 25

从版本 6.0.0 开始,此插件在服务器上运行需要 Java 25 或更高版本。


这是 henkelmax 的 Audio Player 的一个 Paper 分支。特别感谢 Athar42 对此插件的维护。

任何 Paper 分支都应得到支持。如果遇到问题,请在我们的 Discord 服务器 联系我们。

使用 Simple Voice Chat API 播放自定义音乐唱片、山羊角和玩家头颅。

Simple Voice Chat 模组需要在客户端和服务端都安装。

  • 音乐文件放入 plugins/CustomDiscs/musicdata/
  • 子目录可以通过 config.yml 中的 subdirectory-depth 设置启用:
    • none(默认):所有文件必须位于 musicdata/ 根目录下
    • single:一层子目录(例如 musicdata/rock/song.mp3)
    • unrestricted:无限制深度(例如 musicdata/rock/metal/song.mp3)
  • 支持的格式:.wav、.flac、.mp3
  • 使用 /customdisc 或 /cd 查看可用命令

加入我们的 Discord 获取支持:


依赖项

插件 是否必需 备注
Simple Voice Chat ✅ 必需 最低 v2.6.1
PacketEvents ✅ 必需 自 v5.2.0 起 — 已测试与 v2.12.1
ProtocolLib ⛔ 仅限 v5.1.4 及之前 自 v5.2.0 起不再必需

下载文件

使用命令 /cd download <url> <filename.extension> 直接将音频文件下载到服务器。

始终用双引号将 URL 括起来。
如果不这样做,你会收到命令错误。

直接 URL

任何在浏览器中打开时能立即触发文件下载的 URL。

/cd download "https://example.com/mysong.mp3" mysong.mp3
  • <filename.extension> 中的文件扩展名必须与实际文件格式匹配。提供错误的扩展名(例如将 .wav 文件命名为 .mp3)将在服务器控制台引发 UnsupportedAudioFileException。
  • Google Drive — 将你的分享链接转换为直接下载链接:

Filebin

Filebin 是一个免费的、无需注册的文件托管服务。支持两种 URL 格式(末尾的 / 是可选的,两种情况下均接受 www. 前缀):

Bin URL — https://filebin.net/<bin>
插件会查询 Filebin API 并自动下载 bin 中找到的第一个(且仅第一个)受支持的音频文件。

/cd download "https://filebin.net/mybinname" mysong.mp3

Direct Bin file URL — https://filebin.net/<bin>/<filename>
从 bin 中下载特定文件。

/cd download "https://filebin.net/mybinname/mysong.mp3" mysong.mp3

在所有情况下,如果服务器上已存在请求名称的文件,系统将自动分配一个唯一名称(例如 mysong_1.mp3),并在聊天中通知你。


权限

权限 描述
customdiscs.* 授予所有 CustomDiscs 权限
customdiscs.create 创建自定义唱片、山羊角或玩家头颅
customdiscs.download 从 URL 下载文件
customdiscs.range 设置自定义唱片、山羊角或玩家头颅的音频范围
customdiscs.horncooldown 设置自定义山羊角的冷却时间
customdiscs.revert 将自定义物品恢复为其原始原版状态
customdiscs.setmodel 为自定义物品应用自定义模型数据
customdiscs.revertmodel 从自定义物品中移除自定义模型数据
customdiscs.reload 重新加载插件配置和语言文件
customdiscs.update 如果有新版本可用,在加入时接收更新通知

播放唱片不需要任何权限。


设置范围

手持自定义唱片、山羊角或玩家头颅时使用 /cd range <value> 来设置其可听范围。
范围必须在 1 到 config.yml 中为该物品类型设置的值之间(默认:256)。

/cd range 100

设置山羊角冷却时间

手持自定义山羊角时使用 /cd goatcooldown <value> 来设置其冷却时间,单位为刻(1 秒 = 20 刻)。
该值必须在 1 到 config.yml 中 horn-max-cooldown 设置的最大值之间(默认:6000)。

/cd goatcooldown 200

还原自定义物品

手持自定义唱片、山羊角或玩家头颅时使用 /cd revert 将其恢复为原始原版状态。
所有自定义数据(声音文件、lore、范围、冷却时间)随后将被移除。

/cd revert

自定义模型数据

自定义模型数据允许您通过设置一个整数数值,为您的资源包映射到您选择的任意其他模型或纹理,从而为自定义唱片、山羊角和玩家头颅应用自定义外观。

此功能需要客户端安装资源包。插件仅为 CustomDiscs 处理的具体物品应用您在资源包中定义的自定义模型的数值。

我们不提供任何关于创建或配置资源包的支持。

启用功能

该功能默认处于禁用状态。

您可以通过在 config.yml 内的 custom-model-data 下将 enabled 键设置为 true 来更改此设置。

命令

命令 描述
/cd setmodel 打开手持自定义物品的自定义模型数据浏览器 GUI
/cd setmodel <name> 根据 models.yml 中定义的名称应用模型
/cd setmodel <value> 直接为该物品应用 ResourcePack ID
/cd revertmodel 移除手持自定义物品上的自定义模型数据值

注意:/cd revert 命令也会移除自定义模型数据。

配置 models.yml

models.yml 位于 plugins/CustomDiscs/ 中(如果未找到则会在启动时生成)。

材质键(用于每种物品类型)是小写的材质名称(例如:music_disc_cat、music_disc_11、goat_horn、player_head、zombie_head 等)。

disc:
  music_disc_cat:
    - value: 1
      name: "Meow Record"
    - value: 2
      name: "Magic Music"
  music_disc_11:
    - value: 1
      name: "Mystery song"

horn:
  goat_horn:
    - value: 1
      name: "Beware of the Horn"

head:
  player_head:
    - value: 1
      name: "Head me"
  zombie_head:
    - value: 1
      name: "Zombie me"
  • value 是您在资源包物品定义中的整型阈值。
  • name 是在 GUI 中显示的标签,也用于命令(带自动补全)/cd setmodel <name>。
  • 只有为手持物品材质声明的条目才会出现在 GUI 中。

提示:使用 /cd reload 即可应用对 models.yml 的更改,无需重启服务器。


语言

语言文件位于 plugins/CustomDiscs/langs/。
每位玩家都会自动以他们自己的客户端语言接收消息——无需为每位玩家进行单独配置!

可用语言

以下语言默认包含在内:

代码 语言 代码 语言
en English nl Dutch
fr French it Italian
de German tr Turkish
ru Russian cs Czech
es Spanish hu Hungarian
pt Portuguese (BR/PT) ko Korean
zh Chinese (Simplified/Traditional) tt Tatar
pl Polish

pt 同时涵盖 pt_BR 和 pt_PT。
zh 同时涵盖 zh_CN 和 zh_TW。

发现翻译错误或希望添加您的语言?
请通过我们的 Discord 联系我们,或在 GitHub 上提交 [Pull Request] —— 我们欢迎您的贡献!

服务器默认语言

设置用于控制台输出以及当玩家的语言没有匹配文件时的后备语言:

# config.yml
default-lang: en

添加自定义语言

在 plugins/CustomDiscs/langs/ 中创建一个新文件,文件名采用 ISO 639-1 两位字母语言代码“Set 1”(例如日语为 ja.yml)。
复制 en.yml 的内容并翻译其中的值。
使用 /cd reload 加载它,无需重启整个服务器。

更新行为说明

当插件更新并包含新消息时:

  • 捆绑语言文件 (en, fr, de, ...): 新消息会使用插件原始翻译自动添加到您现有的文件中。
    您已经自定义过的键永远不会被覆盖。
  • 自定义语言文件(由您制作):新消息会使用默认英语语言添加。
    因此,如果您不想与默认值混合,请留意您自己的语言文件。

重载配置

使用 /cd reload 可以重载 config.yml、langs/ 中的所有语言文件以及 models.yml(如果启用了自定义模型数据功能),而无需重启服务器。

/cd reload

配置

config.yml

# [General CustomDiscs Config]

# 最大下载大小(以兆字节为单位)。
max-download-size: 50

# 下载时文件名(包括扩展名)的最大长度。设置过高的值可能会导致服务器崩溃。
filename-maximum-length: 100

# 音乐唱片的总体积,范围从 0 到 1。(您可以设置如 0.5 表示 50% 音量)。
music-disc-volume: 1

# 允许在 musicdata 文件夹中的子目录深度。可能的值为:
# none: 所有文件必须位于 musicdata 的根目录下(默认)
# single: 允许一级子目录(例如,musicdata/rock/song.mp3)
# unrestricted: 无限制的子目录深度(例如,musicdata/rock/metal/song.mp3)
subdirectory-depth: none

# 玩家消息的默认语言。
# 必须与 langs/ 文件夹中的文件名匹配(例如 "en", "fr", "de", "ru")。
# 其客户端语言没有匹配文件的玩家将回退到此选定的语言。
default-lang: en

# 调试模式 - 显示更多日志信息和堆栈跟踪信息
debugMode: false

# [Music Discs Config]

# 启用自定义音乐唱片。
music-disc-enable: true

# 启用自定义音乐唱片的“正在播放”消息。
music-disc-playing-enable: true

# 音乐唱片可以被听到的距离(以方块为单位)。
music-disc-distance: 16

# 音乐唱片可以被听到的最大距离(以方块为单位)。
music-disc-max-distance: 256

# [Goat Horns Config]

# 启用自定义山羊角。
custom-horn-enable: true

# 启用自定义号角时的“正在播放”提示。
custom-horn-playing-enable: true

# 自定义号角的听觉距离(方块单位)。
custom-horn-distance: 16

# 自定义号角的最大听觉距离(方块单位)。
custom-horn-max-distance: 256

# 还原自定义山羊角时恢复的默认乐器。
# 仅在创建时无法保存原始乐器时使用。
# 有效值:ponder_goat_horn, sing_goat_horn, seek_goat_horn, feel_goat_horn,
#               admire_goat_horn, call_goat_horn, yearn_goat_horn, dream_goat_horn
default-horn-instrument: ponder_goat_horn

# 号角的默认冷却时间,单位为刻(1秒等于20刻),范围从1到 horn-max-cooldown 的最大值。
horn-cooldown: 140

# 号角的最大冷却时间,单位为刻(1秒等于20刻)。
horn-max-cooldown: 6000

# [玩家头像配置]

# 启用自定义玩家头像。
custom-head-enable: true

# 启用自定义玩家头像时的“正在播放”提示。
custom-head-playing-enable: true

# 自定义玩家头像的听觉距离(方块单位)。
custom-head-distance: 16

# 自定义玩家头像的最大听觉距离(方块单位)。
custom-head-max-distance: 256

# [自定义模型数据配置]

# 启用自定义模型数据功能。
# 在 models.yml 中配置可用模型(服务器需激活资源包才能生效)。
custom-model-data:
  enabled: false

# [更新检查器配置]

# 启用针对 Modrinth 的自动更新检查。
# 当有可用更新时,管理员或拥有 "customdiscs.update" 权限的玩家在加入服务器时会收到通知。
# 启动时会执行一次初始检查,之后只要服务器运行,每24小时检查一次。
update-checker:
  enabled: true
  # 要检查的发布渠道:release(正式)、beta(测试)
  channel: release

# 请勿修改此值 — 它用于自动配置迁移。
config-version: 3

版本支持矩阵

Minecraft 版本 Paper 及其衍生版(Purpur、Leaf 等) Folia 及其衍生版
1.19 1.1.0 - 2.1 —
1.19.1, 1.19.2, 1.19.3 2.2 - 2.2.3 —
1.19.4 2.3 - 2.3.2 —
1.20, 1.20.1 2.4 - 2.4.1 —
1.20.2 2.5 - 2.5.1 —
1.20.3, 1.20.4, 1.20.5, 1.20.6 2.6 - 2.6.1 —
1.21, 1.21.1 3.0 —
1.21.2, 1.21.3 4.1 —
1.21.4 4.2 - 4.4 —
1.21.5 4.4 —
1.21.6, 1.21.7-8 4.5 —
1.21.7-9, 1.21.8 5.0 - 6.0.4 (仅从 1.21.8 起)5.1.1 - 6.0.4
1.21.9, 1.21.10 5.1.2 - 6.0.4 5.1.2 - 6.0.4
1.21.11 5.1.3 - 6.0.4 5.1.3 - 6.0.4
26.1, 26.1.1, 26.1.2 6.0.0 - 6.0.4 6.0.0 - 6.0.4
26.2 6.0.0 - 6.0.4 6.0.0 - 6.0.4
26.3 6.0.4 6.0.4

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源