DiscX

DiscX is a Fabric mod for Minecraft 1.21.8 that makes it easy to add custom music discs using simple files instead of writing Java code.

Add an OGG file, create a small JSON definition, optionally include a custom texture, then let DiscX generate the datapack and resource pack needed for Minecraft to load the disc.

Features

• Custom music discs from JSON
• Vanilla jukebox support
• Custom title and artist
• Optional custom disc texture
• Automatic OGG duration detection
• Generated datapack and resource pack zips
• DiscX creative tab
• Multiplayer/server support
• Commands for reload, validation, listing, info, 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.ogg
  disc.png

disc.png is optional. If it is not included, DiscX uses its default disc texture.

Example disc.json:

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

The id should use lowercase letters, numbers, underscores, hyphens, or periods only.

After adding your files, run:

/discx reload

DiscX will generate:

config/discx/generated_pack/discx_datapack.zip
config/discx/generated_pack/discx_resourcepack.zip

Server Setup

For multiplayer servers:

1. Put discx_datapack.zip in your world’s datapacks folder.
2. Give players discx_resourcepack.zip, or host it as your server resource pack.
3. Restart the server after adding brand-new discs.
4. Make sure both the server and clients have the DiscX mod installed.

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

DiscX does not include copyrighted music. Only use audio you own, created yourself, or have permission to distribute.