AudioPlayer To CustomDiscs v1.2.4
适用于 Paper、Folia 及其分支(Purpur、Leaf 等)
1.21.7 至 26.3
⚠️ 依赖项说明 — 需要 PacketEvents
自版本 1.1.5 起,需要 PacketEvents (v2.12.1+)。
不再使用 ProtocolLib — 如果其他插件不需要它,可以安全地移除。
⚠️ 需要 Java 25
从版本 1.2.0 开始,此插件要求服务器至少运行 Java 25 才能启动。
一个基于 Paper 的插件,用于将 AudioPlayer 乐器转换为与 CustomDiscs 兼容的格式。
任何 Paper 分支都应受支持。如果遇到问题,请通过我们的 Discord 服务器 联系我们。
如果您需要将最初使用 AudioPlayer 创建的自定义音乐唱片、山羊角或玩家头颅播放,然后移植到符合 CustomDiscs 标准的服务器上,这将非常有用。
目前尚未实施权限系统(除非特别请求)。
加入我们的 Discord 获取支持:
依赖项
| 插件 | 必需 | 备注 |
|---|---|---|
| PacketEvents | ✅ 必需 | 自 v1.1.5 起 — 需要 v2.12.1+ |
| ProtocolLib | ⛔ 仅限 v1.1.4 及以下 | 自 v1.1.5 起不再需要 |
使用方法
此插件有两种工作模式:自动和手动。
前置条件 — 音频文件
此插件在转换之前会检查是否存在相应的音频文件(通过其 ID)。请确保以下内容:
audio_player_data/中的原始 AudioPlayer 音乐文件必须放置在plugins/CustomDiscs/musicdata/中- 如果未提供这些文件,转换将会失败,且不会修改原始物品
自动模式
通过在 config.yml 中设置 automaticConvert: true 来启用它:
- 山羊角 — 在首次尝试使用时进行转换。第二次尝试时将播放。
- 自定义唱片 — 当由玩家或任何自动化机制插入时进行转换。
- 玩家头颅 — 放置时立即转换。如果已经放置在音符盒上,可能需要一次或两次触发才能播放。
手动模式
无论是否启用了自动模式,均可工作。
仅将物品握在主手中,然后运行:
/ap2cd convert
音频文件类型覆盖
如果同一音频 ID 存在多个文件扩展名,可能会选择错误的文件。
将物品握在主手中时,使用以下命令之一:
| 命令 | 效果 |
|---|---|
/ap2cd setwav |
强制设置为 WAV 格式 |
/ap2cd setmp3 |
强制设置为 MP3 格式 |
/ap2cd setflac |
强制设置为 FLAC 格式 |
配置
config.yml
# [AP2CD Config]
# 禁用或启用在使用物品时的自动转换过程。
automaticConvert: false
# 调试模式 - 显示更多日志和堆栈跟踪信息。
# 除非您希望被大量消息轰炸(控制台和玩家端),否则不应开启此选项。
debugMode: false
# [Update Checker Config]
# 启用针对 Modrinth 的自动更新检查。
# 当有可用更新时,操作员将在加入时收到通知。
# 在启动时执行初始检查,然后在服务器运行时每 24 小时执行一次。
update-checker:
enabled: true
# 要检查的发布渠道:release, beta
channel: release
# 请勿修改此值 — 它用于自动配置迁移。
config-version: 1
版本支持矩阵
| Minecraft 版本 | Paper 及其分支(Purpur、Leaf 等) | Folia 及其分支 |
|---|---|---|
| 1.21.7-9, 1.21.8 | 1.0.0 - 1.2.4 | 1.0.0 - 1.2.4 |
| 1.21.9, 1.21.10 | 1.0.0 - 1.2.4 | 1.0.0 - 1.2.4 |
| 1.21.11 | 1.1.1 - 1.2.4 | 1.1.1 - 1.2.4 |
| 26.1, 26.1.1, 26.1.2 | 1.2.0 - 1.2.4 | 1.2.0 - 1.2.4 |
| 26.2 | 1.2.1 - 1.2.4 | 1.2.1 - 1.2.4 |
| 26.3 | 1.2.4 | 1.2.4 |
备注
- 此插件可能(也可能不)兼容早期版本的 PaperMC/Folia。
- 尽管本插件标记为与 Paper 的分支兼容,但尚未对其进行广泛测试。如有任何问题,请在我们的 Discord 上报告!
- 版本 1.1.0 至 1.1.4 需要 ProtocolLib。从 1.1.5 开始,不再需要它,已替换为 PacketEvents。
- 此插件可在 Modrinth 和 Hangar 上获取。
AudioPlayer To CustomDiscs v1.2.4
For Paper, Folia and Forks (Purpur, Leaf, ...)
1.21.7 to 26.3
⚠️ Dependency notice — PacketEvents required
Since version 1.1.5, 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 1.2.0, this plugin requires at least Java 25 to run on your server.
A Paper based plugin to convert AudioPlayer instruments into a CustomDiscs compatible format.
Any Paper forks should be supported. In case of issues, reach us on our Discord server.
Useful if you need to play a custom music disc, goat horn or player head initially created with AudioPlayer, then ported to a CustomDiscs-compliant server.
No permission system is in place for now (unless requested).
Join our Discord for support:
Dependencies
| Plugin | Required | Notes |
|---|---|---|
| PacketEvents | ✅ Required | Since v1.1.5 — v2.12.1+ required |
| ProtocolLib | ⛔ Up to v1.1.4 only | No longer required as of v1.1.5 |
How to Use
This plugin works in two modes: automatic and manual.
Prerequisite — Audio Files
This plugin checks whether a corresponding audio file exists (by its ID) before converting. Ensure the following:
- Original AudioPlayer music files from
audio_player_data/must be placed inplugins/CustomDiscs/musicdata/ - Failure to provide those files will cause the conversion to fail, without modifying the original item
Automatic Mode
Enable it by setting automaticConvert: true in config.yml:
- Goat horns — converted on first use attempt. A second attempt will play it.
- Custom discs — converted when inserted by a player or any automated mechanism.
- Player heads — converted instantly on placement. When already placed on a note block, one or two triggers may be needed before playback.
Manual Mode
Works regardless of whether automatic mode is enabled.
Hold the item in your main hand only, then run:
/ap2cd convert
Audio File Type Override
If multiple file extensions exist for the same audio ID, the wrong one may be selected.
While holding the item in your main hand, use one of the following:
| Command | Effect |
|---|---|
/ap2cd setwav |
Force set to WAV format |
/ap2cd setmp3 |
Force set to MP3 format |
/ap2cd setflac |
Force set to FLAC format |
Configuration
config.yml
# [AP2CD Config]
# Disable or enable the automatic conversion process while items are being used.
automaticConvert: false
# Debug Mode - To display some more logging and Stack Trace information.
# You SHOULD NOT turn this on, unless you want to be spammed by a lot of messages (console and player side).
debugMode: false
# [Update Checker Config]
# Enable automatic update checks against Modrinth.
# Operators 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: 1
Version Support Matrix
| Minecraft version | Paper & Forks (Purpur, Leaf, ...) | Folia & Forks |
|---|---|---|
| 1.21.7-9, 1.21.8 | 1.0.0 - 1.2.4 | 1.0.0 - 1.2.4 |
| 1.21.9, 1.21.10 | 1.0.0 - 1.2.4 | 1.0.0 - 1.2.4 |
| 1.21.11 | 1.1.1 - 1.2.4 | 1.1.1 - 1.2.4 |
| 26.1, 26.1.1, 26.1.2 | 1.2.0 - 1.2.4 | 1.2.0 - 1.2.4 |
| 26.2 | 1.2.1 - 1.2.4 | 1.2.1 - 1.2.4 |
| 26.3 | 1.2.4 | 1.2.4 |
Notes
- This plugin may (or may not) work with earlier versions of PaperMC/Folia.
- While this plugin is marked as compatible with Paper's forks, no extensive tests have been made on them. Report any issues on our Discord !
- Versions 1.1.0 to 1.1.4 required ProtocolLib. As of 1.1.5, it is no longer needed and is replaced by PacketEvents.
- This plugin is available on both Modrinth and Hangar.
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 AudioPlayer to CustomDiscs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
发布版本 1.2.4
- 添加 26.3 兼容性
- 更新依赖项。(Gradle + CommandAPI + 拼写错误修复)
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
评论 0
登录后参与评分
还没有评论,来抢沙发吧