URL Custom Discs

Updates

Improved platform detection and system compatibility for Self-Hosted and Edit-Only modes:
The plugin now detects the exact OS, CPU architecture and C library (musl libc or glibc) and downloads matching binaries (Deno, yt-dlp, FFmpeg).

Currently supported platforms:

• Windows x64
• Windows ARM64
• Linux x64 (glibc)
• Linux ARM64 (glibc)
• Linux ARMv7 (glibc)
• Linux x64 (musl libc)
• Linux ARM64 (musl libc)

Deno requirement for YouTube URL downloads:
yt-dlp now requires Deno to interpret YouTube's JavaScript and decrypt its signature cipher, which is necessary to extract and download audio data from YouTube. The plugin will automatically download the Deno binary and keep it up to date.

The README and SELF-HOSTED_AND_EDIT-ONLY_MODES_INSTALLATION files have also been updated with new instructions.

To Update

If you already have the plugin installed on your server, just replace it with the new version.

Updates

Bug fixed: Playlist downloading is disabled. If you provide a URL that is part of a playlist, only the specific video you linked will be downloaded, not the entire playlist.

The Self-Hosted Mode has been entirely rebuilt and comes with new features:

• Bug fixed: There are no more restrictions on the resource pack and audio files.
• yt-dlp and FFmpeg are now automatically installed (yt-dlp is also kept up to date).
• This usage mode is now fully compatible with Minecraft versions 1.21 to 1.21.8 (latest available).

The disc management system with jukeboxes has been entirely rebuilt to simulate vanilla-like usage of custom discs and now allows:

• Bug fixed: Extracting vanilla discs from jukeboxes.
• Inserting and "physically" (drop) removing custom discs from jukeboxes
• Dropping the custom disc when the jukebox is broken
• Placing blocks on a jukebox containing a custom disc while sneaking, without extracting the disc
• Preventing a custom disc from being removed if the player sneaks and right-clicks the jukebox while holding an item
• Displaying a custom "Now Playing" toast when a custom disc is inserted into a jukebox (requires the ProtocolLib plugin, but not mandatory for the URLCustomDiscs plugin to work)

Note: A vanilla behavior workaround was required to avoid playing the Disc 13 sound that serves as the model for custom discs. Inserting a custom disc into a jukebox is only a functional illusion and may not be compatible with mods that, for example, display the physically inserted disc.

For users who already have an HTTP server serving another resource pack and a plugin that can merge it, a third usage mode has been added. The Edit-Only Mode allows you to create and delete custom discs in a local URLCustomDiscsPack.zip resource pack, which will be duplicated in a custom path and renamed with a custom name.

The README and plugin's config.yml files have also been updated with new instructions.

Warning

If you already have installed the plugin on your server and want to use this new version, please make sure to back up your token and apiDownloadResourcePackURL from config.yml.
Then, delete config.yml, install the new version of the plugin, start your Minecraft server so it regenerates the file, and paste your saved token and apiDownloadResourcePackURL back into it.
Restart your server to apply changes. Your previously created discs will not be deleted!

Updates

The plugin is now fully compatible with Minecraft versions 1.21 to 1.21.8 (latest available).
It now automatically handles resource pack generation for both the old format (1.21–1.21.3) and the new format introduced in 1.21.4+.

The README.md file has also been updated with the latest compatibility notes.

Warning

Resource packs generated for Minecraft 1.21 to 1.21.3 are not compatible with versions 1.21.4 and above due to internal changes in how Minecraft handles assets.

If you're updating your server from 1.21-1.21.3 to 1.21.4 or later, your current resource pack will no longer work properly.

There’s no need to save your old token or downloadPackURL.
Instead, reinstall the plugin from scratch: delete its folder, install the latest version, and follow the setup steps again.

Updates

YouTube has started blocking audio downloads via yt-dlp by banning the server where the API is hosted.
To continue creating custom discs, two new options are now available:

• Use yt-dlp locally on your Minecraft server: Set localYtDlp: true in config.yml to enable this option.
  The plugin will automatically download and keep yt-dlp up to date.

  When using this method:

  • The audio will be downloaded as an .mp3 file to the audio_to_send folder.
  • Then, the audio is sent to the API server to be processed and added to your server resource pack.
  • A new command /customdisc update is now available to manually force an update of yt-dlp without restarting the server.

This method is unlikely to work on shared Minecraft hosting providers (like Shockbyte), as they often block external tool execution (like yt-dlp) or their IP ranges are already banned by YouTube (just like my API server currently is).

• Manually upload .mp3 files to the audio_to_send folder: You can now manually download your audio as .mp3 and place it in the audio_to_send folder.
  Make sure the file name is simple (no spaces or special characters).

  When creating a custom disc, instead of providing a URL, simply use the file name of your .mp3 (including the ".mp3" extension).

This method only works for Minecraft server admins, as it requires access to the server file system.

The README.md file has been updated with new instructions.

Warning

If you have already installed the plugin on your server and want to use this new version, please make sure to back up your token and downloadPackURL from config.yml.
Then, delete config.yml, install the new version of the plugin, start your Minecraft server so it regenerates the file, and paste your saved token and downloadPackURL back into it.
Your previously created discs will not be deleted!

Updates

This update makes setting up and using the plugin much... MUCH easier, whether you're running a local Minecraft server or using a shared Minecraft hosting provider.

The plugin now links your Minecraft server to a remote API and to your resource pack stored on a storage space via a token.

Your Minecraft server simply sends requests to the API with parameters such as your token, the URL of your audio, and so on.

All operations such as installing and updating yt-dlp and FFmpeg dependencies, downloading, modifying, and uploading your resource pack are now fully handled by the API.

You no longer need to install and configure an HTTP server or be limited by shared Minecraft hosting providers that block the execution of dependencies.

The README.md documentation has been revamped. The installation now takes just 10 lines and less than 5 minutes!
However, you can still use your own custom setup if you prefer the old way. The documentation for self-hosted installation is now available here: SELFHOSTEDINSTALLATION.md

Warning

If you have already installed the plugin on your server and want to use this new version, please delete the URLCustomDiscs plugin folder before starting your server with the new version.

Updates

• Online-hosted Minecraft servers now supported for Windows and Linux
• README updated
• Fixed bug where yt-dlp and FFmpeg could start simultaneously
• Improved log management

Warning

• yt-dlp and FFmpeg must now be installed in your_mc_server_folder/plugins/URLCustomDiscs/
• If you have already installed the plugin and want to update it with this new version, delete the your_mc_server_folder/plugins/URLCustomDiscs folder that contains the plugin files.

Critical bug fixed : zipFilePath

The plugin is now compatible in 1.21.1

The plugin now automatically supports yt-dlp and FFmpeg dependencies for Linux. Updated README for Linux users.

Initial upload