安装说明在页面底部,全程只需 5 分钟。
关于
本插件配合服务器资源包使用,允许你在 Minecraft 服务器上从 YouTube 链接或 MP3 文件创建并播放自定义音乐唱片,并为玩家提供实时更新。
安装完成后,所有操作均可在游戏中完成,无需手动编辑资源包文件来添加或删除自定义唱片。
该插件支持 Minecraft 的空间音频效果来播放音乐,但你也可以选择以立体声模式播放。
此外,原版命令如 /playsound 和 /stopsound 同样适用于自定义音乐,因此你不需要将唱片放入唱片机中即可播放。
使用方法
| 创建自定义唱片 | |
| 1. 使用“create”命令并粘贴你的链接 | 3. 所有已登录的玩家会收到包含新创建的自定义唱片的更新后服务器资源包 |
| 2. 等待曲目被下载、转换并添加到服务器资源包中 | 4. 你将获得该自定义唱片,尽情享受音乐吧! |
![]() |
![]() |
命令概览
显示命令列表:
/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,来自 Deno GitHub 仓库,采用 MIT 许可证
- yt-dlp,来自 yt-dlp GitHub 仓库,采用 Unlicense
- FFmpeg,来自 FFmpeg-Builds GitHub 仓库(Windows) 和 FFmpeg 静态构建(Linux),采用 GNU 通用公共许可证第 3 版 (GPLv3)
工具用途
- Deno 被 yt-dlp 用于解释 YouTube 的 JavaScript 并解密其签名密码,这是从 YouTube 提取和下载音频数据所必需的。
- yt-dlp 从 YouTube URL 下载 MP3 音频文件。
- FFmpeg 将 MP3 文件转换为 Ogg Vorbis 格式以兼容 Minecraft。
安装
本插件需要进行简短的设置,以确保玩家加入 Minecraft 服务器时自动下载资源包。
使用 API 模式(默认模式)的安装步骤:
- 将
URLCustomDiscs.jar插件下载到你的 Minecraft 服务器的plugins文件夹中。 - 启动你的 Minecraft 服务器,以便插件生成包含
config.yml文件的plugins/URLCustomDiscs文件夹。 - 打开
plugins/URLCustomDiscs/config.yml并将以下字段设置为pluginUsageMode: api - 在同一配置文件中,找到 REMOTE API MODE CONFIGURATION 部分。
重要字段包括:apiBaseURL:远程 API 的基础 URLtoken:初始为空,在创建第一个自定义唱片后自动生成apiDownloadResourcePackURL:初始为空,在创建第一个自定义唱片后自动生成localYtDlp:定义是否使用插件文件夹中自动安装的 yt-dlp 工具直接在您自己的服务器上从 YouTube 下载音频文件,而不是依赖外部 API。此字段默认为 false。
- 在游戏中使用
/customdisc create <URL OR audio_name.mp3> <disc_name> <mono/stereo>命令创建你的第一个自定义唱片。
此操作将生成你的唯一token和apiDownloadResourcePackURL。 - 复制生成的
apiDownloadResourcePackURL并将其粘贴到 Minecraft 服务器的server.properties文件中的resource-pack=字段下,例如:
resource-pack=https://your-generated-apiDownloadResourcePackURL.zip - 重启你的 Minecraft 服务器以应用资源包设置。
- (可选)要强制玩家下载资源包,请在
server.properties中设置require-resource-pack=true并重启你的 Minecraft 服务器。 - (可选回退方案)在极少数情况下,如果 API 服务器被 YouTube 封锁,如果你不想手动下载 MP3 文件并希望继续使用 YouTube URL,你可以配置插件直接在 Minecraft 服务器上使用自动安装的 yt-dlp 依赖项。
为此,请在config.yml文件中设置以下字段:localYtDlp: true,然后重启你的 Minecraft 服务器。此选项在大多数共享 Minecraft 托管提供商上可能无法生效。更多详细信息,请参阅 Audio Download Options 部分。
- (可选)将
ProtocolLib.jar插件下载到你的 Minecraft 服务器的plugins文件夹中以实现自定义“正在播放”提示框,然后重启你的 Minecraft 服务器。
支持与社区
本插件依赖于由我维护的远程 API 和资源包托管。
如果你想支持该项目并帮助支付服务器和存储费用,请考虑通过 Ko-fi 进行捐赠。谢谢!❤️
如有任何疑问、帮助或建议,欢迎加入 Discord 服务器!
免责声明
请注意,每个用户有责任遵守适用的版权法以及任何音乐提供商的服务条款。本插件的开发人员不对未经授权的使用或违反此类法律法规的行为承担任何责任。
THE INSTALLATION INSTRUCTIONS ARE AT THE BOTTOM OF THE PAGE AND TAKE 5 MINUTES.
About
This plugin, along with a server resource pack, allows you to create and play custom music discs from YouTube URLs or MP3 files on your Minecraft server, with real-time updates for players.
Once installed, everything is done in-game, and there's no need to manually edit the resource pack files to add or remove custom discs.
The plugin supports Minecraft's spatial audio for music, but you can also play it in stereo.
Additionally, vanilla commands such as /playsound and /stopsound work with the custom music, so you do not need to use a disc in a jukebox.
Usage
| Create a custom disc | |
| 1. Use the "create" command and paste your URL | 3. All logged-in players receive the updated server resource pack containing the created custom disc |
| 2. Wait for the track to be downloaded, converted, and added to the server resource pack | 4. The custom disc is given to you, enjoy the music! |
![]() |
![]() |
Commands Overview
Display the list of commands:
/customdisc help
Create a custom music disc from a YouTube URL or local MP3 file:
/customdisc create <URL OR audio_name.mp3> <disc_name> <mono/stereo>
- mono: enables spatial audio (as when played in a jukebox)
- stereo: plays the audio in the traditional way
Instructions for local MP3 files (admin-only):
- Place your MP3 file inside the
audio_to_sendfolder in the plugin directory.- Rename the MP3 file to a simple name with no spaces and no special characters.
- Run the create command with the
audio_name.mp3.
- Don't forget to include the
.mp3extension in theaudio_name.mp3field.
Give yourself a custom music disc:
/customdisc give <disc_name>
Show the list of custom music discs (click a disc name to autofill the give command):
/customdisc list
Delete a custom music disc:
/customdisc delete <disc_name>
Show details of the custom music disc you're holding (useful for debugging):
/customdisc info
Update Deno and yt-dlp dependencies:
/customdisc updatedep
Vanilla command to play a custom track (can be used with coordinates):
/playsound minecraft:customdisc.<disc_name> ambient @a ~ ~ ~ 1 1
Vanilla command to stop a custom track:
/stopsound @a * minecraft:customdisc.<disc_name>
Usage Modes
The plugin offers three modes of use, depending on your setup and preferences:
- API Mode (default):
Uses a dedicated remote API to manage custom discs, the resource pack, and dependencies. Ideal for quick and easy setup, but with some limitations on the resource pack and audio files. - Self-Hosted Mode:
For advanced users who prefer to host and manage everything themselves. You can bypass the API and configure the plugin manually using your own setup and HTTP server. - Edit-Only Mode:
Allows you to update the resource pack locally and duplicate it to a custom path with a custom name. Useful if you already host another resource pack and want to merge it with theURLCustomDiscsPack.zip.
API Mode Resource Pack Limitations
To minimize storage space and ensure fast downloads, the resource pack has the following limitations:
- Up to 10 custom discs can be included in the resource pack at the same time.
- Each custom disc is limited to a maximum duration of 5 minutes.
- The resource pack size is limited to 80 MB (more than enough).
- If no activity (adding or deleting a custom disc) occurs for 3 months, the token and resource pack will be automatically deleted to free up space.
Self-Hosted Mode Requirements
You must provide a personal HTTP server to host the resource pack. Depending on whether your Minecraft server and HTTP server are on the same machine or on separate machines, the HTTP server must support:
- Local access: The plugin can update the resource pack via an absolute path.
- Online access: The plugin can download and upload the resource pack using HTTP requests.
- Player access: Players must be able to download the resource pack and receive real-time updates for custom music discs.
Documentation
This Modrinth page focuses on the default API Mode, which is the recommended setup for most users.
You can also find this documentation on the URLCustomDiscs GitHub repository.
If you want to use the Self-Hosted Mode or the Edit-Only Mode instead, please refer to the dedicated documentation from the URLCustomDiscs GitHub repository: Self-Hosted and Edit-Only Modes documentation
For more details, you may explore the API documentation, source code and architecture in the URLCustomDiscsAPI GitHub repository.
Audio Download Options
Warning: YouTube may block my API server in the future (never happened). Please notify me via Discord if this occurs, so I can resolve it.
In the meantime, you have two alternative options:
- Use the auto-installed yt-dlp dependency (Minecraft server-side download)
The plugin uses the yt-dlp dependency to download the audio from the YouTube URL into the plugin folder and then send it to the API.This method is unlikely to work on shared Minecraft hosting providers, such as Shockbyte, as they often do not allow execution of yt-dlp, or the IP ranges of those servers are likely already banned by YouTube.
- Manually download the MP3 file (admin-only, 100% reliable)
If you don't mind downloading the audio as an MP3 file, use a website like noTube to download it manually. Then, place the MP3 file directly into theaudio_to_sendfolder inside theURLCustomDiscsplugin directory.
After that, use the appropriate command to create a custom disc with this MP3 file.This method only works for Minecraft server admins, as it requires access to the server’s file system.
Dependencies
Optional plugin
ProtocolLib [Download]: used to display a custom "Now Playing" toast when a custom disc is inserted into a jukebox
External Tools
License & Attribution
The plugin automatically installs and uses the following tools (Deno and yt-dlp are also kept up to date):
- Deno, from the Deno GitHub repository, licensed under the MIT License
- yt-dlp, from the yt-dlp GitHub repository, licensed under the Unlicense
- FFmpeg, from the FFmpeg-Builds GitHub repository (Windows) and the FFmpeg Static Builds (Linux), licensed under the GNU General Public License version 3 (GPLv3)
Tool Usage
- Deno is used by yt-dlp to interpret YouTube’s JavaScript and decrypt its signature cipher, which is required to extract and download audio data from YouTube.
- yt-dlp downloads MP3 audio files from YouTube URLs.
- FFmpeg converts MP3 files to Ogg Vorbis format for Minecraft compatibility.
Installation
This plugin requires a brief setup to ensure players automatically download the resource pack when they join the Minecraft server.
Steps to install with the API Mode (default mode):
- Download the
URLCustomDiscs.jarplugin into your Minecraft server'spluginsfolder. - Start your Minecraft server so the plugin generates the
plugins/URLCustomDiscsfolder containing aconfig.ymlfile. - Open
plugins/URLCustomDiscs/config.ymland set the following field topluginUsageMode: api - In the same config file, locate the REMOTE API MODE CONFIGURATION section.
Important fields include:apiBaseURL: the base URL of the remote APItoken: initially empty, automatically generated after creating your first custom discapiDownloadResourcePackURL: initially empty, automatically generated after creating your first custom disclocalYtDlp: defines whether to use the auto-installed yt-dlp tool in the plugin folder to download audio files from YouTube directly on your own server instead of relying on the external API. This field is set to false by default.
- Create your first custom disc in-game using the
/customdisc create <URL OR audio_name.mp3> <disc_name> <mono/stereo>command.
This action will generate your uniquetokenand theapiDownloadResourcePackURL. - Copy the generated
apiDownloadResourcePackURLand paste it into your Minecraft server'sserver.propertiesfile under theresource-pack=filed, for example:
resource-pack=https://your-generated-apiDownloadResourcePackURL.zip - Restart your Minecraft server to apply the resource pack settings.
- (Optional) To force players to download the resource pack, set
require-resource-pack=trueinserver.propertiesand restart your Minecraft server. - (Optional fallback) In the extremely rare case that the API server gets blocked by YouTube, if you don’t want to manually download MP3 files and would prefer to keep using YouTube URLs, you can configure the plugin to use the auto-installed yt-dlp dependency directly on your Minecraft server.
To do this, set the following field in theconfig.ymlfile:localYtDlp: true, then restart your Minecraft server.This option likely won’t work on most shared Minecraft hosting providers. For more details, refer to the Audio Download Options section.
- (Optional) Download the
ProtocolLib.jarplugin into your Minecraft server'spluginsfolder for custom "Now Playing" toasts, then restart your Minecraft server.
Support & Community
This plugin relies on a remote API and resource pack hosting maintained by me.
If you'd like to support the project and help cover server and storage costs, please consider contributing via Ko-fi. Thank you! ❤️
For any questions, help, or suggestions, feel free to join the Discord server!
Disclaimer
Please note that it is the sole responsibility of each user to comply with applicable copyright laws and the terms of service of any music provider when using this plugin. The developer of this plugin does not assume any liability for unauthorized use or violations of such laws and regulations.
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 URL Custom Discs
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新
修复了自定义唱片在从原版和自定义维度的唱片机中取出时,声音无法正确停止的问题。
现在会获取世界的内部名称。
如何更新
如果您的服务器上已安装该插件,只需将其替换为新版本即可。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持


评论 0
登录后参与评分
还没有评论,来抢沙发吧