URL Custom Discs

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 ` - 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_send` folder 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 `.mp3` extension in the `audio_name.mp3` field.

Give yourself a custom music disc: `/customdisc give `

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 `

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. ambient @a ~ ~ ~ 1 1`

Vanilla command to stop a custom track: `/stopsound @a * minecraft:customdisc.`

## 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 the `URLCustomDiscsPack.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