CustomDiscs Plugin

# Custom Discs v6.0.3 ### For Paper, Folia and Forks (Purpur, Leaf, ...) ### 1.21.7 to 26.2 (https://img.shields.io/github/downloads/Navoei/CustomDiscs/total?style=plastic&label=GitHub%20Downloads&color=success "Click here to download the plugin")](https://modrinth.com/plugin/customdiscs-plugin) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (https://img.shields.io/modrinth/dt/customdiscs-plugin?style=plastic&label=Modrinth%20Downloads&color=success "Click here to download the plugin")](https://modrinth.com/plugin/customdiscs-plugin) --- ## ⚠️ Dependency notice — PacketEvents required **Since version 5.2.0, (https://modrinth.com/plugin/packetevents) (v2.11.2+) is required.**\ ProtocolLib is no longer used — it can be safely removed if no other plugin needs it. ## ⚠️ Java 25 required **Starting with version 6.0.0, this plugin requires Java 25 or newer to run on your server.** --- A Paper fork of henkelmax's Audio Player. Special thanks to Athar42 for maintaining this plugin. > Any Paper forks should be supported. In case of issues, reach us on our (https://discord.gg/rJtBRmRFCr). Play custom music discs, goat horns and player heads using the (https://modrinth.com/plugin/simple-voice-chat) API. > The Simple Voice Chat mod is required on both the client and the server. - Music files go into `plugins/CustomDiscs/musicdata/` - Subdirectories can be enabled in `config.yml` via the `subdirectory-depth` setting: - `none` (default): all files must be in the root of `musicdata/` - `single`: one level of subdirectory (e.g. `musicdata/rock/song.mp3`) - `unrestricted`: unlimited depth (e.g. `musicdata/rock/metal/song.mp3`) - Supported formats: `.wav`, `.flac`, `.mp3` - Use `/customdisc` or `/cd` to see available commands Join our Discord for support: https://discord.gg/rJtBRmRFCr --- ## Dependencies | Plugin | Required | Notes | |--------|----------|------------------------------------| | (https://modrinth.com/plugin/simple-voice-chat) | ✅ Required | v2.6.1 minimum | | (https://modrinth.com/plugin/packetevents) | ✅ Required | Since v5.2.0 — tested with v2.11.2 | | (https://github.com/dmulloy2/ProtocolLib) | ⛔ Up to v5.1.4 only | No longer required as of v5.2.0 | --- ## Downloading Files Use the command `/cd download <url> <filename.extension>` to download an audio file directly to the server. > **Always write the URL between double quotes.**\ > Without this, you'll get a command error. ### Direct URL Any URL that starts an immediate file download when opened in a browser. ``` /cd download "https://example.com/mysong.mp3" mysong.mp3 ``` - The file extension in `<filename.extension>` must match the actual format of the file. Providing a wrong extension (e.g. naming a `.wav` file as `.mp3`) will cause an `UnsupportedAudioFileException` in the server console. - **Google Drive** — Convert your sharing link to a direct download link: https://lonedev6.github.io/gddl/ ### Filebin (https://filebin.net) is a free, no-registration file hosting service. Two URL formats are supported (final `/` is optional, `www.` prefix is accepted in both cases): **Bin URL** — `https://filebin.net/<bin>`\ The plugin queries the Filebin API and automatically downloads the first (and only the first) supported audio file found in the bin. ``` /cd download "https://filebin.net/mybinname" mysong.mp3 ``` **Direct Bin file URL** — `https://filebin.net/<bin>/<filename>`\ Downloads a specific file from the bin. ``` /cd download "https://filebin.net/mybinname/mysong.mp3" mysong.mp3 ``` > In all cases, if a file with the requested name already exists on the server, a unique name is automatically assigned (e.g. `mysong_1.mp3`) and you are notified in chat. --- ## Permissions | Permission | Description | |------------|----------------------------------------------------------------------| | `customdiscs.*` | Grants all CustomDiscs permissions | | `customdiscs.create` | Create a custom disc, goat horn or player head | | `customdiscs.download` | Download a file from a URL | | `customdiscs.range` | Set the audio range of a disc | | `customdiscs.horncooldown` | Set the cooldown for custom goat horns | | `customdiscs.revert` | Revert a custom item back to its original vanilla state | | `customdiscs.setmodel` | Apply a Custom Model Data to a custom item | | `customdiscs.revertmodel` | Remove a Custom Model Data from a custom item | | `customdiscs.reload` | Reload the plugin configuration and language files | | `customdiscs.update` | Receive an update notification o