URL Custom Discs

插件

· 作者 Allium_

一个插件,允许你从 YouTube 链接或 MP3 文件创建并播放自定义音乐唱片到你的 Minecraft 服务器,并为玩家提供实时更新。

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

最新 2.7.2 · 26.3 · Bukkit / Paper

一键开服(送7天)

安装说明在页面底部,全程只需 5 分钟。

关于

本插件配合服务器资源包使用,允许你在 Minecraft 服务器上从 YouTube 链接或 MP3 文件创建并播放自定义音乐唱片,并为玩家提供实时更新。

安装完成后,所有操作均可在游戏中完成,无需手动编辑资源包文件来添加或删除自定义唱片。

该插件支持 Minecraft 的空间音频效果来播放音乐,但你也可以选择以立体声模式播放。

此外,原版命令如 /playsound 和 /stopsound 同样适用于自定义音乐,因此你不需要将唱片放入唱片机中即可播放。

使用方法

创建自定义唱片
1. 使用“create”命令并粘贴你的链接 3. 所有已登录的玩家会收到包含新创建的自定义唱片的更新后服务器资源包
2. 等待曲目被下载、转换并添加到服务器资源包中 4. 你将获得该自定义唱片,尽情享受音乐吧!
create_custom_disc play_custom_disc

命令概览

显示命令列表:
/customdisc help

从 YouTube 链接或本地 MP3 文件创建自定义音乐唱片:
/customdisc create <URL OR audio_name.mp3> <disc_name> <mono/stereo>

  • mono:启用空间音频(与在唱片机中播放时的效果相同)
  • stereo:以传统方式播放音频

本地 MP3 文件使用说明(仅限管理员):

  • 将你的 MP3 文件放置在插件目录下的 audio_to_send 文件夹中。
  • 将 MP3 文件重命名为简单的名称,不包含空格和特殊字符。
  • 使用 audio_name.mp3 运行创建命令。
    • 别忘了在 audio_name.mp3 字段中包含 .mp3 扩展名。

给自己发放自定义音乐唱片:
/customdisc give <disc_name>

显示自定义音乐唱片列表(点击唱片名称可自动填充 give 命令):
/customdisc list

删除自定义音乐唱片:
/customdisc delete <disc_name>

显示你手中持有的自定义音乐唱片详情(有助于调试):
/customdisc info

更新 Deno 和 yt-dlp 依赖项:
/customdisc updatedep

用于播放自定义曲目的原版命令(可配合坐标使用):
/playsound minecraft:customdisc.<disc_name> ambient @a ~ ~ ~ 1 1

用于停止自定义曲目的原版命令:
/stopsound @a * minecraft:customdisc.<disc_name>

使用模式

该插件提供三种使用模式,具体取决于你的设置和偏好:

  • API 模式(默认):
    使用专用的远程 API 来管理自定义唱片、资源包和依赖项。适合快速且简单的设置,但在资源包和音频文件方面存在一些限制。
  • 自托管模式:
    适合希望自行托管和管理所有内容的高级用户。你可以绕过 API,并使用你自己的设置和 HTTP 服务器手动配置插件。
  • 仅编辑模式:
    允许你在本地更新资源包,并将其复制到具有自定义名称的自定义路径。如果你已经托管了其他资源包并希望将其与 URLCustomDiscsPack.zip 合并,此模式非常有用。

API 模式资源包限制

为了最小化存储空间并确保快速下载,资源包有以下限制:

  • 同一时间内资源包中最多可包含 10 个自定义唱片。
  • 每个自定义唱片的最大时长限制为 5 分钟。
  • 资源包大小限制为 80 MB(绰绰有余)。
  • 如果 3 个月内没有任何活动(添加或删除自定义唱片),令牌和资源包将被自动删除以释放空间。

自托管模式要求

你必须提供一个个人 HTTP 服务器来托管资源包。根据 Minecraft 服务器和 HTTP 服务器是否在同一台机器上,HTTP 服务器必须支持:

  • 本地访问:插件可以通过绝对路径更新资源包。
  • 在线访问:插件可以使用 HTTP 请求下载和上传资源包。
  • 玩家访问:玩家必须能够下载资源包并接收自定义音乐唱片的实时更新。

文档

本 Modrinth 页面主要介绍默认的 API 模式,这是大多数用户推荐的设置。
你也可以在 URLCustomDiscs GitHub 仓库 找到本文档。

如果你想使用自托管模式或仅编辑模式,请参考 URLCustomDiscs GitHub 仓库中的专用文档:自托管和仅编辑模式文档

更多详细信息,你可以在 URLCustomDiscsAPI GitHub 仓库 探索 API 文档、源代码和架构。

音频下载选项

警告:YouTube 未来可能会封锁我的 API 服务器(目前尚未发生)。如果发生这种情况,请通过 Discord 通知我,以便我解决。

与此同时,你有两种替代方案:

  • 使用自动安装的 yt-dlp 依赖项(Minecraft 服务器端下载)
    插件会使用 yt-dlp 依赖项将 YouTube URL 中的音频下载到插件文件夹中,然后将其发送到 API。

    此方法不太可能在共享 Minecraft 托管提供商上生效,例如 Shockbyte,因为它们通常不允许执行 yt-dlp,或者这些服务器的 IP 段很可能已被 YouTube 封锁。

  • 手动下载 MP3 文件(仅限管理员,100% 可靠)
    如果你不介意以 MP3 文件形式下载音频,可以使用 noTube 等网站手动下载。然后将 MP3 文件直接放入 URLCustomDiscs 插件目录内的 audio_to_send 文件夹中。
    之后,使用相应的命令用此 MP3 文件创建自定义唱片。

    此方法仅适用于 Minecraft 服务器管理员,因为它需要访问服务器的文件系统。

依赖项

可选插件

ProtocolLib [下载]:用于在唱片机插入自定义唱片时显示自定义的“正在播放”提示框

外部工具

许可与归属

插件会自动安装并使用以下工具(Deno 和 yt-dlp 也会保持更新):

工具用途

  • Deno 被 yt-dlp 用于解释 YouTube 的 JavaScript 并解密其签名密码,这是从 YouTube 提取和下载音频数据所必需的。
  • yt-dlp 从 YouTube URL 下载 MP3 音频文件。
  • FFmpeg 将 MP3 文件转换为 Ogg Vorbis 格式以兼容 Minecraft。

安装

本插件需要进行简短的设置,以确保玩家加入 Minecraft 服务器时自动下载资源包。

使用 API 模式(默认模式)的安装步骤:

  1. 将 URLCustomDiscs.jar 插件下载到你的 Minecraft 服务器的 plugins 文件夹中。
  2. 启动你的 Minecraft 服务器,以便插件生成包含 config.yml 文件的 plugins/URLCustomDiscs 文件夹。
  3. 打开 plugins/URLCustomDiscs/config.yml 并将以下字段设置为 pluginUsageMode: api
  4. 在同一配置文件中,找到 REMOTE API MODE CONFIGURATION 部分。
    重要字段包括:
    • apiBaseURL:远程 API 的基础 URL
    • token:初始为空,在创建第一个自定义唱片后自动生成
    • apiDownloadResourcePackURL:初始为空,在创建第一个自定义唱片后自动生成
    • localYtDlp:定义是否使用插件文件夹中自动安装的 yt-dlp 工具直接在您自己的服务器上从 YouTube 下载音频文件,而不是依赖外部 API。此字段默认为 false。
  5. 在游戏中使用 /customdisc create <URL OR audio_name.mp3> <disc_name> <mono/stereo> 命令创建你的第一个自定义唱片。
    此操作将生成你的唯一 token 和 apiDownloadResourcePackURL。
  6. 复制生成的 apiDownloadResourcePackURL 并将其粘贴到 Minecraft 服务器的 server.properties 文件中的 resource-pack= 字段下,例如:
    resource-pack=https://your-generated-apiDownloadResourcePackURL.zip
  7. 重启你的 Minecraft 服务器以应用资源包设置。
  8. (可选)要强制玩家下载资源包,请在 server.properties 中设置 require-resource-pack=true 并重启你的 Minecraft 服务器。
  9. (可选回退方案)在极少数情况下,如果 API 服务器被 YouTube 封锁,如果你不想手动下载 MP3 文件并希望继续使用 YouTube URL,你可以配置插件直接在 Minecraft 服务器上使用自动安装的 yt-dlp 依赖项。
    为此,请在 config.yml 文件中设置以下字段:localYtDlp: true,然后重启你的 Minecraft 服务器。

    此选项在大多数共享 Minecraft 托管提供商上可能无法生效。更多详细信息,请参阅 Audio Download Options 部分。

  10. (可选)将 ProtocolLib.jar 插件下载到你的 Minecraft 服务器的 plugins 文件夹中以实现自定义“正在播放”提示框,然后重启你的 Minecraft 服务器。

支持与社区

本插件依赖于由我维护的远程 API 和资源包托管。
如果你想支持该项目并帮助支付服务器和存储费用,请考虑通过 Ko-fi 进行捐赠。谢谢!❤️

如有任何疑问、帮助或建议,欢迎加入 Discord 服务器!

免责声明

请注意,每个用户有责任遵守适用的版权法以及任何音乐提供商的服务条款。本插件的开发人员不对未经授权的使用或违反此类法律法规的行为承担任何责任。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源