AudioPlayer To CustomDiscs v1.2.3

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

1.21.7 to 26.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: automatic 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:

• Goat horns — converted on first use attempt. A second attempt will play it.
• Custom discs — 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

# [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
1.21.7-9, 1.21.8	1.0.0 – 1.2.3	1.0.0 – 1.2.3
1.21.9, 1.21.10	1.0.0 – 1.2.3	1.0.0 – 1.2.3
1.21.11	1.1.1 – 1.2.3	1.1.1 – 1.2.3
26.1, 26.1.1, 26.1.2	1.2.0 - 1.2.3	1.2.0 - 1.2.3
26.2	1.2.1 - 1.2.3	1.2.1 - 1.2.3

---

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 ProtocolLib. As of 1.1.5, it is no longer needed and is replaced by PacketEvents.
• This plugin is available on both Modrinth and Hangar.