DiscX

DiscX is a Minecraft mod for adding custom music discs without writing Java code.

Built for server owners, modpack creators, and players who want more control over their music, DiscX lets you create new discs using a simple folder, a small JSON file, and a MIDI or ABC track. Add an optional custom texture, reload DiscX, and the mod generates the resource pack needed for clients to hear and see your custom disc.

Features

• Custom music discs defined with simple JSON files
• MIDI, MIDI, and ABC track support
• Works with vanilla jukeboxes
• Custom disc title and artist text
• Optional custom disc textures
• Automatic duration detection for MIDI files
• Generated resource pack zip
• DiscX creative tab
• Multiplayer and dedicated server support
• Commands for reloading, validating, listing, inspecting, exporting examples, and giving discs

How To Add A Disc

Create a folder inside:

config/discx/discs/

Example folder structure:

config/discx/discs/my_custom_disc/
  disc.json
  song.mid
  disc.png

You can also use song.midi or song.abc instead of song.mid.

disc.png is optional. If no custom texture is included, DiscX uses its default disc texture.

Example disc.json:

{
  "id": "my_custom_disc",
  "title": "My Custom Disc",
  "artist": "Artist Name"
}

For ABC files, add duration_seconds to disc.json so DiscX knows how long the track should play.

After adding your files, run:

/discx reload

DiscX will generate:

config/discx/generated_pack/discx_resourcepack.zip

Multiplayer Setup

For multiplayer servers:

1. Install DiscX on the server.
2. Install DiscX on every client that will hear the custom discs.
3. Give players discx_resourcepack.zip, or host it as your server resource pack.
4. Run /discx reload after adding or changing discs.
5. Restart the server after adding brand-new discs if needed.

No datapack setup is required.

Commands

/discx reload
/discx list
/discx give <player> <disc> [amount]
/discx info <disc>
/discx validate
/discx export-example

Example give command:

/discx give <player> discx:my_custom_disc 1

Important Copyright Note

DiscX does not include copyrighted music or original audio recordings.

MIDI and ABC files are not original audio recordings, but songs, melodies, compositions, and arrangements may still be protected by copyright. Only distribute tracks you created yourself, tracks in the public domain, or tracks you have permission to use.