URL Custom Discs

About

This plugin, along with a required server resource pack, allows you to create and play custom music discs from YouTube URLs 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 server resource pack files to add or remove 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.

Important:

• Currently works on Windows and Linux due to dependencies.
• Make sure to use a direct video link without parameters (such as playlist, timecode, etc.), or you might be in for a surprise. Delete everything starting from & in the URL.

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:
/customdisc create <URL> <disc name> <mono/stereo>

• mono: enables spatial audio (like played in a jukebox)
• stereo: plays the sound in the traditional way

Give a custom music disc:
/customdisc give <disc name>

Display custom music discs list (you can give yourself a music disc directly by clicking on its name in the chat):
/customdisc list

Delete a custom music disc:
/customdisc delete <disc name>

Display custom music disc details in hand (used for debugging):
/customdisc info

Vanilla command to play a custom track (can be used with coordinates):
/execute positioned ~ ~ ~ run playsound minecraft:customdisc.<disc name> ambiant @a

Vanilla command to stop a custom track:
/stopsound @a * minecraft:customdisc.<disc name>

Dependencies

• yt-dlp to download an MP3 audio file from a YouTube URL.
• FFmpeg to convert MP3 format to Ogg format.
• A personal local web server hosting the server resource pack, which allows:
  • the plugin to edit the server resource pack via an absolute path for locally-hosted Minecraft server;
  • the plugin to edit the server resource pack via download and upload (POST method) for online-hosted Minecraft server;
  • players to download the server resource pack and receive real-time updates for custom music discs.

License And Attribution

This plugin uses yt-dlp (unlicense) and FFmpeg from the FFmpeg.org under the LGPLv2.1.
yt-dlp and FFmpeg are not included in this project and must be installed separately.

Download

The URLCustomDiscs.jar plugin and the URLCustomDiscsPack.zip server resource pack are available for download in the Versions section.

Installation

This plugin requires proper setup and is not just a simple URLCustomDiscs.jar drop-in.
Make sure to READ THE DOCUMENTATION carefully to ensure everything is configured correctly.

You can find the Servers Guide, Configuration Guide, and Dependencies Installation Guide in the README of the URLCustomDiscs GitHub repository.

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.