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 获取支持:
依赖项
下载文件
使用命令 /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 |
Custom Discs v6.0.4
For Paper, Folia and Forks (Purpur, Leaf, ...)
1.21.7 to 26.3
⚠️ Dependency notice — PacketEvents required
Since version 5.2.0, PacketEvents (v2.12.1+) is required.
ProtocolLib is no longer used — it can be safely removed if no other plugin needs it.
⚠️ Java 25 required
Starting with version 6.0.0, this plugin requires Java 25 or newer to run on your server.
A Paper fork of henkelmax's Audio Player. Special thanks to Athar42 for maintaining this plugin.
Any Paper forks should be supported. In case of issues, reach us on our Discord server.
Play custom music discs, goat horns and player heads using the Simple Voice Chat API.
The Simple Voice Chat mod is required on both the client and the server.
- Music files go into
plugins/CustomDiscs/musicdata/
- Subdirectories can be enabled in
config.yml via the subdirectory-depth setting:
none (default): all files must be in the root of musicdata/
single: one level of subdirectory (e.g. musicdata/rock/song.mp3)
unrestricted: unlimited depth (e.g. musicdata/rock/metal/song.mp3)
- Supported formats:
.wav, .flac, .mp3
- Use
/customdisc or /cd to see available commands
Join our Discord for support:
Dependencies
Downloading Files
Use the command /cd download <url> <filename.extension> to download an audio file directly to the server.
Always write the URL between double quotes.
Without this, you'll get a command error.
Direct URL
Any URL that starts an immediate file download when opened in a browser.
/cd download "https://example.com/mysong.mp3" mysong.mp3
- The file extension in
<filename.extension> must match the actual format of the file. Providing a wrong extension (e.g. naming a .wav file as .mp3) will cause an UnsupportedAudioFileException in the server console.
- Google Drive — Convert your sharing link to a direct download link:
Filebin
Filebin is a free, no-registration file hosting service. Two URL formats are supported (final / is optional, www. prefix is accepted in both cases):
Bin URL — https://filebin.net/<bin>
The plugin queries the Filebin API and automatically downloads the first (and only the first) supported audio file found in the bin.
/cd download "https://filebin.net/mybinname" mysong.mp3
Direct Bin file URL — https://filebin.net/<bin>/<filename>
Downloads a specific file from the bin.
/cd download "https://filebin.net/mybinname/mysong.mp3" mysong.mp3
In all cases, if a file with the requested name already exists on the server, a unique name is automatically assigned (e.g. mysong_1.mp3) and you are notified in chat.
Permissions
| Permission |
Description |
customdiscs.* |
Grants all CustomDiscs permissions |
customdiscs.create |
Create a custom disc, goat horn or player head |
customdiscs.download |
Download a file from a URL |
customdiscs.range |
Set the audio range of a custom disc, goat horn or player head |
customdiscs.horncooldown |
Set the cooldown for custom goat horns |
customdiscs.revert |
Revert a custom item back to its original vanilla state |
customdiscs.setmodel |
Apply a Custom Model Data to a custom item |
customdiscs.revertmodel |
Remove a Custom Model Data from a custom item |
customdiscs.reload |
Reload the plugin configuration and language files |
customdiscs.update |
Receive an update notification on join if a new version is available |
Playing discs does not require any permission.
Setting the range
Use /cd range <value> while holding a custom disc, goat horn, or player head to set its hearing range.
The range must be between 1 and the maximum value set in config.yml for the respective item type (default: 256).
/cd range 100
Setting the goat horn cooldown
Use /cd goatcooldown <value> while holding a custom goat horn to set its cooldown, in ticks (1 second is 20 ticks).
The value must be between 1 and the maximum value set in config.yml for the setting horn-max-cooldown (default: 6000).
/cd goatcooldown 200
Reverting a custom item
Use /cd revert while holding a custom disc, goat horn, or player head to revert it back to its original vanilla state.
All custom data (sound file, lore, range, cooldown) is then removed.
/cd revert
Custom Model Data
Custom Model Data lets you apply a custom visual to custom discs, goat horns, and player heads by setting an integer value that your Resource Pack maps to a different model or texture of your choice.
This feature requires a Resource Pack installed on the client. The plugin only applies the numeric value of the custom model defined in your Resource Pack for the specific item CustomDiscs handles.
No support of any kind will be provided for creating or configuring a Resource Pack.
Enabling the feature
The feature is disabled by default.
You can change this by setting the enabled key to true (under custom-model-data), located inside config.yml.
Commands
| Command |
Description |
/cd setmodel |
Open the Custom Model Data browser GUI for the custom item in hand |
/cd setmodel <name> |
Apply a model by its name as defined inside models.yml |
/cd setmodel <value> |
Apply the ResourcePack ID directly for that item |
/cd revertmodel |
Remove the Custom Model Data value from the custom item in hand |
Note: /cd revert command also removes Custom Model Data.
Configuring models.yml
models.yml is located in plugins/CustomDiscs/ (and is generated on startup if not found).
The material key (used in each item type) is the lowercase material name (for instance: 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 is the integer threshold in your Resource Pack item definition.
name is the displayed label used in the GUI and for command (with autocomplete) /cd setmodel <name>.
- Only the entries declared for the held item's material appear in the GUI.
Hint: Use /cd reload to apply changes to models.yml without restarting your server.
Languages
Language files are located in plugins/CustomDiscs/langs/.
Each player receives the messages in their own client language automatically — no configuration needed per player!
Available languages
The following languages are included by default:
| Code |
Language |
Code |
Language |
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 covers both pt_BR and pt_PT.
zh covers both zh_CN and zh_TW.
Found a translation error or just want your language added?
Reach us on our Discord or submit a Pull Request on GitHub — your contributions are always welcome!
Server default language
Set the fallback language used for console output and when a player's language has no matching file:
# config.yml
default-lang: en
Adding a custom language
Create a new file in plugins/CustomDiscs/langs/ named after the ISO 639-1 two-letter language code "Set 1" (e.g. ja.yml for Japanese).
Copy the contents of en.yml and translate the values.
Use /cd reload to load it without restarting the whole server.
Notice on updates behaviour
When the plugin is updated with new messages:
- Bundled language files (
en, fr, de, ...): new messages are automatically added to your existing files using the plugin original translation.
Keys that you have already customised are never overwritten.
- Custom language files (made by you): new messages are added using the default English language.
So keep an eye in your own lang if you don't want to have a mix with the default values.
Reloading the configuration
Use /cd reload to reload config.yml, all language files in langs/ and models.yml (if the Custom Model Data feature is enabled) without restarting the server.
/cd reload
Configuration
config.yml
# [General CustomDiscs Config]
# The maximum download size in megabytes.
max-download-size: 50
# The maximum length the file name (including the file extension) should be when downloaded. Using a too high value could crash the server.
filename-maximum-length: 100
# The master volume of music discs from 0-1. (You can set values like 0.5 for 50% volume).
music-disc-volume: 1
# Subdirectory depth allowed in musicdata folder. Possible values are :
# none: all files must be in the root of musicdata (default)
# single: one level of subdirectory allowed (e.g., musicdata/rock/song.mp3)
# unrestricted: unlimited subdirectory depth (e.g., musicdata/rock/metal/song.mp3)
subdirectory-depth: none
# Default language for player messages.
# Must match a file name in the langs/ folder (e.g. "en", "fr", "de", "ru").
# Players whose client language has no matching file will fall back to this selected language.
default-lang: en
# Debug Mode - To display some more logging information and Stack Trace informations
debugMode: false
# [Music Discs Config]
# Enable custom music discs.
music-disc-enable: true
# Enable "Now playing" message for custom music discs.
music-disc-playing-enable: true
# The distance from which music discs can be heard in blocks.
music-disc-distance: 16
# The max distance from which music discs can be heard in blocks.
music-disc-max-distance: 256
# [Goat Horns Config]
# Enable custom goat horns.
custom-horn-enable: true
# Enable "Now playing" message for custom horns.
custom-horn-playing-enable: true
# The distance from which custom horns can be heard in blocks.
custom-horn-distance: 16
# The max distance from which custom horns can be heard in blocks.
custom-horn-max-distance: 256
# The default instrument to restore when reverting a custom goat horn.
# Used only if the original instrument could not be saved at creation time.
# Valid values: 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
# The default cooldown time for horns in ticks from 1 to the max value of horn-max-cooldown (1 second is 20 ticks).
horn-cooldown: 140
# The default max cooldown time for horns in ticks (1 second is 20 ticks).
horn-max-cooldown: 6000
# [Player Heads Config]
# Enable custom player heads.
custom-head-enable: true
# Enable "Now playing" message for player heads.
custom-head-playing-enable: true
# The distance from which player heads can be heard in blocks.
custom-head-distance: 16
# The max distance from which player heads can be heard in blocks.
custom-head-max-distance: 256
# [Custom Model Data Config]
# Enable the Custom Model Data feature.
# Configure available models in models.yml (need a resourcepack active on the server to work).
custom-model-data:
enabled: false
# [Update Checker Config]
# Enable automatic update checks against Modrinth.
# Operators or players with permission "customdiscs.update" are notified on join when an update is available.
# An initial check is performed on startup, then every 24 hours as long as the server is running.
update-checker:
enabled: true
# Release channel to check against: release, beta
channel: release
# Do not modify this value — it is used for automatic config migration.
config-version: 3
Version Support Matrix
| Minecraft version |
Paper & Forks (Purpur, Leaf, ...) |
Folia & Forks |
| 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 |
(only since 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
登录后参与评分
还没有评论,来抢沙发吧