# AudioPlayer To CustomDiscs v1.2.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 1.1.5, 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 1.2.0, this plugin requires at least Java 25 to run on your server.**<\/p>\n
—<\/p>\n
A Paper based plugin to convert AudioPlayer instruments into a CustomDiscs compatible format.<\/p>\n
> Any Paper’s forks should be supported. In case of issues, reach us on our Discord server.<\/p>\n
Useful if you need to play a custom music disc, goat horn or player head initially created with AudioPlayer, then ported to a CustomDiscs-compliant server.<\/p>\n
> No permission system is in place for now (unless requested).<\/p>\n
Join our Discord for support: https:\/\/discord.gg\/rJtBRmRFCr<\/p>\n
—<\/p>\n
## Dependencies<\/p>\n
| Plugin | Required | Notes |
\n|——–|———-|——-|
\n| PacketEvents | \u2705 Required | Since v1.1.5 \u2014 tested with v2.11.2 |
\n| ProtocolLib | \u26d4 Up to v1.1.4 only | No longer required as of v1.1.5 |<\/p>\n
—<\/p>\n
## How to Use<\/p>\n
This plugin works in two modes: **automatic** and **manual**.<\/p>\n
### Prerequisite \u2014 Audio Files<\/p>\n
This plugin checks whether a corresponding audio file exists (by its ID) before converting. Ensure the following:<\/p>\n
– Original AudioPlayer music files from `audio_player_data\/` must be placed in `plugins\/CustomDiscs\/musicdata\/`
\n– Failure to provide those files will cause the conversion to fail, **without modifying the original item**<\/p>\n
### Automatic Mode<\/p>\n
Enable it by setting `automaticConvert: true` in `config.yml`:<\/p>\n
– **Goat horns** \u2014 converted on first use attempt. A second attempt will play it.
\n– **Custom discs** \u2014 converted when inserted by a player or any automated mechanism.
\n– **Player heads** \u2014 converted instantly on placement. When already placed on a note block, one or two triggers may be needed before playback.<\/p>\n
### Manual Mode<\/p>\n
Works regardless of whether automatic mode is enabled.
\nHold the item in your **main hand** only, then run:<\/p>\n
“`
\n\/ap2cd convert
\n“`<\/p>\n
### Audio File Type Override<\/p>\n
If multiple file extensions exist for the same audio ID, the wrong one may be selected.
\nWhile holding the item in your **main hand**, use one of the following:<\/p>\n
| Command | Effect |
\n|———|————————–|
\n| `\/ap2cd setwav` | Force set to WAV format |
\n| `\/ap2cd setmp3` | Force set to MP3 format |
\n| `\/ap2cd setflac` | Force set to FLAC format |<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
**config.yml**<\/p>\n
“`yaml
\n# [AP2CD Config]<\/p>\n
# Disable or enable the automatic conversion process while items are being used.
\nautomaticConvert: false<\/p>\n
# Debug Mode – To display some more logging and Stack Trace information.
\n# You SHOULD NOT turn this on, unless you want to be spammed by a lot of messages (console and player side).
\ndebugMode: false
\n“`<\/p>\n
—<\/p>\n
## Version Support Matrix<\/p>\n
| Minecraft version | Paper & Forks (Purpur, Leaf, …) | Folia & Forks |
\n|—————————-|—————————————————————————————|—————————————————————————————|
\n| **1.21.7-9, 1.21.8** | 1.0.0 \u2013 1.2.0 | 1.0.0 \u2013 1.2.0 |
\n| **1.21.9, 1.21.10** | 1.0.0 \u2013 1.2.0 | 1.0.0 \u2013 1.2.0 |
\n| **1.21.11** | 1.1.1 \u2013 1.2.0 | 1.1.1 \u2013 1.2.0 |
\n| **26.1, 26.1.1, 26.1.2** | 1.2.0 | 1.2.0 |<\/p>\n
—<\/p>\n
## Notes<\/p>\n
– This plugin may **(or may not)** work with earlier versions of PaperMC\/Folia.
\n – While this plugin is marked as compatible with Paper’s forks, no extensive tests has been made on them. Report any issues on our Discord !
\n– Versions 1.1.0 to 1.1.4 required ProtocolLib. As of 1.1.5, it is no longer needed and is replaced by PacketEvents.
\n– This plugin is available on both Modrinth and Hangar.<\/p>\n","protected":false},"excerpt":{"rendered":"
A Paper plugin to convert AudioPlayer custom items (music discs, goat horns and player heads) to be playable with CustomDiscs.<\/p>\n","protected":false},"featured_media":22349,"template":"","meta":{"_minecraft_slug":"audioplayer-to-customdiscs","_minecraft_project_id":"uGyuzT6k","_minecraft_author":"Athar","_minecraft_license":"MIT","_minecraft_downloads":611,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"audioplayer-to-customdiscs.zip","_minecraft_size_bytes":5663216,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T10:13:58.565128Z","_minecraft_date_created":"2025-10-23T06:17:47.364773Z","_minecraft_date_modified":"2026-04-22T23:30:09.175549Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/audioplayer-to-customdiscs","_minecraft_icon_attachment_id":22349,"_minecraft_imported_at":"2026-05-31T21:55:33+00:00","_minecraft_import_hash":"b220dd1acd621b4c109c6feabdb5fd98","_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-22348","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