MineVinyl

Guide

Custom music disc datapacks

A resource pack can only replace the audio of an existing disc, and Minecraft still cuts your track off at the original disc's length. A datapack does it properly: it registers brand-new discs with their own names and their own full-length audio, and every vanilla disc keeps working. The generator's Custom discs mode builds the whole bundle for you; this page is what to do with it.

What's in the bundle

The download is one zip holding three things:

  • The datapack registers each track as a jukebox song: its display name, its real length (so hoppers eject at the right moment), and a comparator signal.
  • The resource pack carries the actual audio. The datapack points at it; without it, discs work but play silence.
  • README.txt and give-commands.txt: install steps and a ready-made /give command for every disc.

Singleplayer install

  1. Drop the datapack zip into your world's datapacks folder:
.minecraft/saves/<your world>/datapacks/
  1. Put the resource pack zip in .minecraft/resourcepacks/ and enable it under Options → Resource Packs.
  2. In the world, run /reload once (or leave and rejoin).
  3. Give yourself the discs (cheats required). Each command is in give-commands.txt; they look like this:
/give @s minecraft:music_disc_cat[minecraft:jukebox_playable="mypack:midnight_drive",minecraft:item_name='"DJ Chip - Midnight Drive"']

On 1.21 through 1.21.4 the component takes an object instead: jukebox_playable={song:"mypack:midnight_drive"}. The generator writes the right form for your chosen version.

The vanilla disc in the command only supplies the artwork. The sound, name, and length are yours. Drop it in a jukebox and the whole track plays.

Server install, and the catch

  1. Put the datapack zip in the server's world/datapacks/ folder and restart. The discs now exist for everyone who joins, because datapacks are server-side.
  2. The audio is not. Each player's game needs the resource pack, so host it at a direct-download URL and point server.properties at it:
resource-pack=https://example.com/mypack-resource-pack.zip
resource-pack-sha1=<the zip's sha1>

Players who accept the pack hear your music; players who decline get working-but-silent discs. Our server resource pack guide covers hosting, the sha1, and the failure modes.

Version support

Custom disc datapacks need the jukebox song registry, which shipped in Java 1.21. Every Java version from 1.21 to the current release works: pick your version in the generator and it writes the matching pack formats for both files. Bedrock doesn't support jukebox song datapacks; for Bedrock, use the generator's .mcpack mode instead.