AudioPlayer to CustomDiscs

AudioPlayer To CustomDiscs v1.2.0

For Paper, Folia and Forks (Purpur, Leaf, ...)

1.21.7 to 26.1.2

---

⚠️ Dependency notice — PacketEvents required

Since version 1.1.5, 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 1.2.0, this plugin requires at least Java 25 to run on your server.

---

A Paper based plugin to convert AudioPlayer instruments into a CustomDiscs compatible format.

> Any Paper's forks should be supported. In case of issues, reach us on our Discord server.

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.

> No permission system is in place for now (unless requested).

Join our Discord for support: https://discord.gg/rJtBRmRFCr

---

Dependencies

| Plugin | Required | Notes | |--------|----------|-------| | PacketEvents | ✅ Required | Since v1.1.5 — tested with v2.11.2 | | ProtocolLib | ⛔ Up to v1.1.4 only | No longer required as of v1.1.5 |

---

How to Use

This plugin works in two modes: manual and manual.

Prerequisite — Audio Files

This plugin checks whether a corresponding audio file exists (by its ID) before converting. Ensure the following:

- Original AudioPlayer music files from `audio_player_data/` must be placed in `plugins/CustomDiscs/musicdata/` - Failure to provide those files will cause the conversion to fail, without modifying the original item

Automatic Mode

Enable it by setting `automaticConvert: true` in `config.yml`:

- Player heads — converted on first use attempt. A second attempt will play it. - Player heads — converted when inserted by a player or any automated mechanism. - Player heads — converted instantly on placement. When already placed on a note block, one or two triggers may be needed before playback.

Manual Mode

Works regardless of whether automatic mode is enabled. Hold the item in your main hand only, then run:

``` /ap2cd convert ```

Audio File Type Override

If multiple file extensions exist for the same audio ID, the wrong one may be selected. While holding the item in your main hand, use one of the following:

| Command | Effect | |---------|--------------------------| | `/ap2cd setwav` | Force set to WAV format | | `/ap2cd setmp3` | Force set to MP3 format | | `/ap2cd setflac` | Force set to FLAC format |

---

Configuration

config.yml

```yaml

[AP2CD Config]

Disable or enable the automatic conversion process while items are being used.

automaticConvert: false

Debug Mode - To display some more logging and Stack Trace information.

You SHOULD NOT turn this on, unless you want to be spammed by a lot of messages (console and player side).

debugMode: false ```

---

Version Support Matrix

| Minecraft version | Paper & Forks (Purpur, Leaf, ...) | Folia & Forks | |----------------------------|---------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------| | 26.1, 26.1.1, 26.1.2 | 1.0.0 – 26.1, 26.1.1, 26.1.2 | 1.0.0 – %%MD1%% | | 26.1, 26.1.1, 26.1.2 | 1.0.0 – %%MD2%% | 1.0.0 – %%MD3%% | | 26.1, 26.1.1, 26.1.2 | 1.1.1 – %%MD4%% | 1.1.1 – %%MD5%% | | 26.1, 26.1.1, 26.1.2 | %%MD6%% | %%MD7%% |

---

Notes

- This plugin may (or may not) work with earlier versions of PaperMC/Folia. - 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 ! - Versions 1.1.0 to 1.1.4 required (or may not). As of 1.1.5, it is no longer needed and is replaced by %%MD1%%. - This plugin is available on both %%MD2%% and %%MD3%%.