AudioPlayer 是一款使玩家能够上传自定义音频并将其加持于音乐唱片及山羊角的服务端模组。

特性

• 服务器运行时直接上传音频

• 支持 mp3 与 wav 格式

• 通过 URL 上传音频

• 直接将音频上传至服务器

• 通过 Filebin 上传音频

• 服务端安装即可

• 无需重启服务器

• 不需要资源包

• 不需要在客户端做任何变更

• 上传限制可配置

• 命令权限可配置

• 唱片音响范围可配置

• 山羊角音响范围可配置

• 山羊角冷却时间可配置

• 可通过漏斗、投掷器、发射器为唱片机插入唱片（可在配置中禁用）

• 可使用漏斗取出唱片（可在配置中禁用）

命令

执行 /audioplayer 命令可获取关于如何上传文件的大体信息。

• 通过 URL 上传音频

  执行 /audioplayer url "https://example.com/myaudio.mp3" 命令。将 https://example.com/myaudio.mp3 替换为导向 .mp3 或 .wav 文件的直链即可。

• 直接向服务器上传文件

  将你的 .mp3 或 .wav 文件放入服务器的 audioplayer_uploads 文件夹并执行 /audioplayer serverfile "yourfile.mp3" 命令。yourfile.mp3 应为文件名。

• 通过 Filebin 上传音频

  执行 /audioplayer filebin 命令并依照向导完成操作。

• 将自定义音频写入音乐唱片

  将一张唱片（任何可在唱片机中正常播放的唱片均可）持握于主手并执行 /audioplayer musicdisc <ID> 命令。此外，你还可以通过一个额外的参数为唱片指定一个自定义名称，命令为 /audioplayer musicdisc <ID> "<CUSTOM-TEXT>"。

• 将自定义音频写入山羊角

  将一只山羊角持握于主手并执行 /audioplayer goathorn <ID> 命令。指定自定义名称的方式参见上条。

• 获取现存自定义唱片/山羊角的音频 ID

  将带有自定义音频的音乐唱片/山羊角持握于主手并执行 /audioplayer id 命令。

兼容性

• 使用该模组自定义的音乐唱片仅能够通过原版的唱片机播放自定义音频。使用其它模组中能够播放唱片的设备则将播放原本的歌曲。

• 物理声效重制版 (Sound Physics Remastered) 能够正确起效于正在播放自定义音频的唱片机。

• 玉 🔍 (Jade 🔍) 不会为正在播放自定义音频的唱片机显示玩家所指定的名称。“正在播放：”后仍为音乐唱片原本的歌曲标题

• 手持物品信息 (Held Item Info) 会同时显示玩家为自定义音乐唱片及山羊角指定的名称以及原本的歌曲标题/山羊角乐器。你可以在前者的配置中将“Music disc title”与“Goat horn instrument”设为 false