AudioPlayer to CustomDiscs

插件

· 作者 Athar

一个 Paper 插件,用于将 AudioPlayer 自定义物品(音乐唱片、山羊角和玩家头颅)转换为可通过 CustomDiscs 播放的格式。

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

最新 1.2.4 · 26.3 · Folia / Paper

一键开服(送7天)

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 上获取。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源