AudioPlayer-to-CustomDiscs

AudioPlayer To CustomDiscs v1.1.6

For Paper and Folia

1.21.7 to 1.21.11

⚠️ 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.

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

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

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:

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

Notes

• This plugin may (or may not) work with earlier versions of PaperMC/Folia.
• 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.