# Custom Discs v6.0.0
\n### For Paper, Folia and Forks (Purpur, Leaf, …)
\n### 1.21.7 to 26.1.2<\/p>\n
 <\/p>\n
—<\/p>\n
## \u26a0\ufe0f Dependency notice \u2014 PacketEvents required<\/p>\n
**Since version 5.2.0, PacketEvents (v2.11.2+) is required.**
\nProtocolLib is no longer used \u2014 it can be safely removed if no other plugin needs it.<\/p>\n
## \u26a0\ufe0f Java 25 required<\/p>\n
**Starting with version 6.0.0, this plugin requires Java 25 or newer to run on your server.**<\/p>\n
—<\/p>\n
A Paper fork of henkelmax’s Audio Player. Special thanks to Athar42 for maintaining this plugin.<\/p>\n
> Any Paper forks should be supported. In case of issues, reach us on our Discord server.<\/p>\n
Play custom music discs, goat horns and player heads using the Simple Voice Chat API.<\/p>\n
> The Simple Voice Chat mod is required on both the client and the server.<\/p>\n
– Music files go into `plugins\/CustomDiscs\/musicdata\/`
\n– Subdirectories can be enabled in `config.yml` via the `subdirectory-depth` setting:
\n – `none` (default): all files must be in the root of `musicdata\/`
\n – `single`: one level of subdirectory (e.g. `musicdata\/rock\/song.mp3`)
\n – `unrestricted`: unlimited depth (e.g. `musicdata\/rock\/metal\/song.mp3`)
\n– Supported formats: `.wav`, `.flac`, `.mp3`
\n– Use `\/customdisc` or `\/cd` to see available commands<\/p>\n
Join our Discord for support: https:\/\/discord.gg\/rJtBRmRFCr<\/p>\n
—<\/p>\n
## Dependencies<\/p>\n
| Plugin | Required | Notes |
\n|——–|———-|————————————|
\n| Simple Voice Chat | \u2705 Required | v2.6.1 minimum |
\n| PacketEvents | \u2705 Required | Since v5.2.0 \u2014 tested with v2.11.2 |
\n| ProtocolLib | \u26d4 Up to v5.1.4 only | No longer required as of v5.2.0 |<\/p>\n
—<\/p>\n
## Downloading Files<\/p>\n
Use the command `\/cd download > **Always write the URL between double quotes.** ### Direct URL<\/p>\n Any URL that starts an immediate file download when opened in a browser.<\/p>\n “` – The file extension in ` ### Filebin<\/p>\n Filebin is a free, no-registration file hosting service. Two URL formats are supported (final `\/` is optional, `www.` prefix is accepted in both cases):<\/p>\n **Bin URL** \u2014 `https:\/\/filebin.net\/ “` **Direct Bin file URL** \u2014 `https:\/\/filebin.net\/ “` > 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.<\/p>\n —<\/p>\n ## Permissions<\/p>\n | Permission | Description | > Playing discs does not require any permission.<\/p>\n —<\/p>\n ## Setting the range<\/p>\n Use `\/cd range “` —<\/p>\n ## Reverting a custom item<\/p>\n Use `\/cd revert` while holding a custom disc, goat horn, or player head to revert it back to its original vanilla state. “` —<\/p>\n ## Reloading the configuration<\/p>\n Use `\/cd reload` to reload `config.yml` and `lang.yml` without restarting the server.<\/p>\n “` —<\/p>\n ## Configuration<\/p>\n **config.yml**<\/p>\n “`yaml # The maximum download size in megabytes. # The maximum length the file name (including the file extension) should be when downloaded. Using a too high value could crash the server. # The master volume of music discs from 0-1. (You can set values like 0.5 for 50% volume). # Subdirectory depth allowed in musicdata folder. Possible values are : # Debug Mode – To display some more logging information and Stack Trace informations # [Music Discs Config]<\/p>\n # Enable custom music discs. # Enable “Now playing” message for custom music discs. # The distance from which music discs can be heard in blocks. # The max distance from which music discs can be heard in blocks. # [Goat Horns Config]<\/p>\n # Enable custom goat horns. # Enable “Now playing” message for custom horns. # The distance from which custom horns can be heard in blocks. # The max distance from which custom horns can be heard in blocks. # The default instrument to restore when reverting a custom goat horn. # The default cooldown time for horns in ticks from 1 to the max value of horn-max-cooldown (1 second is 20 ticks). # The default max cooldown time for horns in ticks (1 second is 20 ticks). # [Player Heads Config]<\/p>\n # Enable custom player heads. # Enable “Now playing” message for player heads. # The distance from which player heads can be heard in blocks. # The max distance from which player heads can be heard in blocks. # [Update Checker Config]<\/p>\n # Enable automatic update checks against Modrinth. # Do not modify this value \u2014 it is used for automatic config migration. —<\/p>\n ## Language<\/p>\n **lang.yml**<\/p>\n “`yaml —<\/p>\n ## Version Support Matrix<\/p>\n | Minecraft version | Paper & Forks (Purpur, Leaf, …) | Folia & Forks | A Paper plugin to add custom music discs, goat horns and player heads using the Simple Voice Chat API.<\/p>\n","protected":false},"featured_media":53064,"template":"","meta":{"_minecraft_slug":"customdiscs-plugin","_minecraft_project_id":"b7pWaVta","_minecraft_author":"Navoei","_minecraft_license":"MIT","_minecraft_downloads":2928,"_minecraft_follows":15,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customdiscs-plugin.zip","_minecraft_size_bytes":8211881,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T05:16:47.863375Z","_minecraft_date_created":"2025-10-27T08:08:35.502090Z","_minecraft_date_modified":"2026-04-22T23:34:41.251417Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customdiscs-plugin","_minecraft_icon_attachment_id":53064,"_minecraft_imported_at":"2026-06-02T22:43:04+00:00","_minecraft_import_hash":"d7c83e64ad1263b947da89fb90d154e1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,89,127,128,867,92],"mod_loader":[131,132,133],"minecraft_version":[40,41,80,81,82,83,167,163],"class_list":["post-53063","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n> Without this, you’ll get a command error.<\/p>\n
\n\/cd download “https:\/\/example.com\/mysong.mp3” mysong.mp3
\n“`<\/p>\n
\n– **Google Drive** \u2014 Convert your sharing link to a direct download link: https:\/\/lonedev6.github.io\/gddl\/<\/p>\n
\nThe plugin queries the Filebin API and automatically downloads the first (and only the first) supported audio file found in the bin.<\/p>\n
\n\/cd download “https:\/\/filebin.net\/mybinname” mysong.mp3
\n“`<\/p>\n
\nDownloads a specific file from the bin.<\/p>\n
\n\/cd download “https:\/\/filebin.net\/mybinname\/mysong.mp3” mysong.mp3
\n“`<\/p>\n
\n|————|———————————————————————-|
\n| `customdiscs.*` | Grants all CustomDiscs permissions |
\n| `customdiscs.create` | Create a custom disc, goat horn or player head |
\n| `customdiscs.download` | Download a file from a URL |
\n| `customdiscs.range` | Set the audio range of a disc |
\n| `customdiscs.horncooldown` | Set the cooldown for custom goat horns |
\n| `customdiscs.revert` | Revert a custom item back to its original vanilla state |
\n| `customdiscs.reload` | Reload the plugin configuration and language files |
\n| `customdiscs.update` | Receive an update notification on join if a new version is available |<\/p>\n
\nThe range must be between 1 and the maximum value set in `config.yml` for the respective item type (default: 256).<\/p>\n
\n\/cd range 100
\n“`<\/p>\n
\nAll custom data (sound file, lore, range, cooldown) is then removed.<\/p>\n
\n\/cd revert
\n“`<\/p>\n
\n\/cd reload
\n“`<\/p>\n
\n# [General CustomDiscs Config]<\/p>\n
\nmax-download-size: 50<\/p>\n
\nfilename-maximum-length: 100<\/p>\n
\nmusic-disc-volume: 1<\/p>\n
\n# none: all files must be in the root of musicdata (default)
\n# single: one level of subdirectory allowed (e.g., musicdata\/rock\/song.mp3)
\n# unrestricted: unlimited subdirectory depth (e.g., musicdata\/rock\/metal\/song.mp3)
\nsubdirectory-depth: none<\/p>\n
\ndebugMode: false<\/p>\n
\nmusic-disc-enable: true<\/p>\n
\nmusic-disc-playing-enable: true<\/p>\n
\nmusic-disc-distance: 16<\/p>\n
\nmusic-disc-max-distance: 256<\/p>\n
\ncustom-horn-enable: true<\/p>\n
\ncustom-horn-playing-enable: true<\/p>\n
\ncustom-horn-distance: 16<\/p>\n
\ncustom-horn-max-distance: 256<\/p>\n
\n# Used only if the original instrument could not be saved at creation time.
\n# Valid values: ponder_goat_horn, sing_goat_horn, seek_goat_horn, feel_goat_horn,
\n# admire_goat_horn, call_goat_horn, yearn_goat_horn, dream_goat_horn
\ndefault-horn-instrument: ponder_goat_horn<\/p>\n
\nhorn-cooldown: 140<\/p>\n
\nhorn-max-cooldown: 6000<\/p>\n
\ncustom-head-enable: true<\/p>\n
\ncustom-head-playing-enable: true<\/p>\n
\ncustom-head-distance: 16<\/p>\n
\ncustom-head-max-distance: 256<\/p>\n
\n# Operators or players with permission “customdiscs.update” are notified on join when an update is available.
\n# An initial check is performed on startup, then every 24 hours as long as the server is running.
\nupdate-checker:
\n enabled: true
\n # Release channel to check against: release, beta
\n channel: release<\/p>\n
\nconfig-version: 1
\n“`<\/p>\n
\nprefix: ‘&8[&6CustomDiscs&8]&r’
\ninvalid-filename: ‘&cThis is an invalid filename!’
\ninvalid-format: ‘&cFile must be in wav, flac, or mp3 format!’
\nfile-not-found: ‘&cFile not found!’
\nnot-holding-correct-item: ‘&cYou must either hold a disc, goat horn or player head in your main hand.’
\ncreate-filename: ‘&7Your filename is: &a”%filename%”.’
\ncreate-custom-name: ‘&7Your custom name is: &a”%custom_name%”.’
\ndownloading-file: ‘&7Downloading file…’
\nfile-too-large: ‘&cThe file is larger than %max_download_size%MB.’
\nsuccessful-download: ‘&aFile successfully downloaded to &7%file_path%&a.’
\ncreate-disc: ‘&aCreate a disc by doing &7\/cd create %filename% “Custom Lore”&a.’
\ndownload-error: ‘&cAn error has occurred while downloading.’
\nnow-playing: ‘&6Now playing: %song_name%’
\ndisc-converted: ‘&aConverted disc to new format! &fThis is due to changes in newer Minecraft versions which introduced &7ToolTipDisplay&f.’
\ninvalid-range: ‘&cYou need to chose a range between 1 and %range_value%’
\ncreate-custom-range: ‘&7Your range is set to: &a”%custom_range%”.’
\nnot-holding-custom-goathorn: ‘&cYou must hold a custom goat horn in your main hand.’
\ninvalid-cooldown: ‘&cYou need to chose a cooldown between 1 and %cooldown_value% (in ticks).’
\ncreate-custom-goat-cooldown: ‘&7Your goat horn cooldown is set to: &a”%custom_goat_cooldown%” ticks.’
\ncustom-music-disabled: ‘&7Custom music discs are disabled in the configuration.’
\ncustom-head-disabled: ‘&7Custom player heads are disabled in the configuration.’
\ncustom-horn-disabled: ‘&7Custom goat horns are disabled in the configuration.’
\ninvalid-protocol: ‘&cOnly HTTP:\/\/ and HTTPS:\/\/ URL are allowed.’
\ninvalid-filename-length: ‘&cThe maximum file name is restricted to %filename_length_value% characters.’
\nfilebin-no-audio: ‘&cNo supported audio file (wav\/mp3\/flac) found in this Filebin bin.’
\nfilebin-api-error: ‘&cFailed to access Filebin API. The bin may not exist or is unavailable.’
\nfile-already-exists: ‘&eA file named &7%filename%&e already exists, saving as &7%new_filename%&e instead.’
\nsubdirectory-not-allowed: ‘&cSubdirectories are not allowed in musicdata.’
\nsubdirectory-depth-exceeded: ‘&cOnly one level of subdirectory is allowed in musicdata.’
\nrevert-success: ‘&aItem successfully reverted.’
\nrevert-not-custom: ‘&cThe item in your hand is not a custom disc, horn or head.’
\nreload-success: ‘&aConfiguration reloaded successfully.’
\nupdate-available: ‘&eA new version of CustomDiscs is available: &6%latest_version% &7(current: %current_version%)’
\n“`<\/p>\n
\n|————————————|——————————————————————————-|—————————————————————————————————|
\n| **1.19** | 1.1.0 \u2013 2.1 | \u2014 |
\n| **1.19.1, 1.19.2, 1.19.3** | 2.2 \u2013 2.2.3 | \u2014 |
\n| **1.19.4** | 2.3 \u2013 2.3.2 | \u2014 |
\n| **1.20, 1.20.1** | 2.4 \u2013 2.4.1 | \u2014 |
\n| **1.20.2** | 2.5 \u2013 2.5.1 | \u2014 |
\n| **1.20.3, 1.20.4, 1.20.5, 1.20.6** | 2.6 \u2013 2.6.1 | \u2014 |
\n| **1.21, 1.21.1** | 3.0 | \u2014 |
\n| **1.21.2, 1.21.3** | 4.1 | \u2014 |
\n| **1.21.4** | 4.2 \u2013 4.4 | \u2014 |
\n| **1.21.5** | 4.4 | \u2014 |
\n| **1.21.6, 1.21.7-8** | 4.5 | \u2014 |
\n| **1.21.7-9, 1.21.8** | 5.0 \u2013 6.0.0 | (only since 1.21.8) 5.1.1 \u2013 6.0.0 |
\n| **1.21.9, 1.21.10** | 5.1.2 \u2013 6.0.0 | 5.1.2 \u2013 6.0.0 |
\n| **1.21.11** | 5.1.3 \u2013 6.0.0 | 5.1.3 \u2013 6.0.0 |
\n| **26.1, 26.1.1, 26.1.2** | 6.0.0 | 6.0.0 |<\/p>\n","protected":false},"excerpt":{"rendered":"