MineVinyl

Guide · Getting started

How to make custom music discs in Minecraft Java and Bedrock

This guide walks you through the full process of replacing Minecraft's music disc sounds with your own audio using MineVinyl. You can generate a Java resource pack directly in the browser, then use the Bedrock notes below when you need the same custom music discs packaged for Bedrock Edition.

How Minecraft music discs work

Each music disc in Minecraft (13, Cat, Blocks, Chirp, Far, Mall, Mellohi, Stal, Strad, Ward, 11, Wait, Otherside, Relic, and the newer additions) corresponds to a specific OGG Vorbis audio file stored inside a resource pack. When Minecraft plays a disc, it looks up the file by name from the active resource pack stack. If your pack provides a replacement file with the right name in the right folder, the game uses yours instead of the default. You can browse facts and replacement notes for every slot on the music disc pages.

MineVinyl handles the folder structure, file naming, OGG conversion (including the mono downmix Minecraft needs), and the required pack.mcmeta metadata file automatically.

Step 1 — Select your Minecraft Java version

Open the MineVinyl generator and choose your Minecraft Java version from the dropdown. This matters because:

  • Different versions have different numbers of music discs.
  • The pack_format value in pack.mcmeta must match your version or the game will show an incompatibility warning — see pack_format explained for the full version table.

If you're unsure of your version, open Minecraft and check the bottom-left of the main menu screen.

Step 2 — Assign audio files to disc slots

After selecting a version, the tool shows all available disc slots. For each disc you want to customise:

  1. Click the slot or drag a file onto it.
  2. Select your audio file. Supported formats include MP3, WAV, FLAC, AAC, M4A, OGG, and more. See the supported formats guide for a full list.
  3. MineVinyl converts the file to OGG Vorbis in the background. A progress indicator appears while conversion runs.

You can assign files to as many disc slots as you like. Discs you don't assign will keep their original Minecraft sounds — they're not included in the pack at all, so there's no risk of accidentally silencing them.

Step 3 — Name your pack (optional)

Give your pack a name and description using the Pack Details fields. The name is used as the filename of the downloaded zip and appears in Minecraft's resource pack list. The description appears below the pack name in-game.

Step 4 — Generate and download the Java .zip

Click Generate Resource Pack. The tool assembles the zip file in your browser and your download starts immediately. The zip contains:

  • pack.mcmeta — version metadata
  • assets/minecraft/sounds/records/ — your converted OGG files, named correctly for each disc

Step 5 — Install the Java resource pack

See the installation guide for full instructions. The short version:

  1. Move the .zip (do not unzip it) to your Minecraft resourcepacks folder.
  2. Open Minecraft and go to Options → Resource Packs.
  3. Enable your pack and click Done.
  4. Place a music disc in a jukebox. The disc you assigned a track to should now play your audio.

Bedrock Edition — custom music discs and .mcpack notes

Bedrock Edition also supports custom music discs through resource packs, but the installable file is usually an .mcpackinstead of the Java .zip. MineVinyl currently generates the Java pack structure, which is still useful for Bedrock creators because it gives you correctly converted OGG files and a clear disc-to-filename mapping.

  1. Use MineVinyl to assign audio to the disc slots you want and download the Java .zip.
  2. Unzip the pack and copy the converted disc OGG files from assets/minecraft/sounds/records/.
  3. Create or update a Bedrock resource pack with a manifest.json, the Bedrock sound definitions your project uses, and the same record filenames.
  4. Zip the Bedrock pack contents, change the extension to .mcpack, then open it with Minecraft Bedrock to import it.

In short: Java players can use the downloaded .zip directly, while Bedrock players should treat MineVinyl as a music disc maker for conversion and slot planning before wrapping the files in a Bedrock-compatible .mcpack. If you play on a server or Realm, make sure the resource pack is applied on the world so every Bedrock player hears the custom discs.

Troubleshooting

If the pack shows an incompatibility warning or the sounds don't play, see the troubleshooting guide. The most common cause is a version mismatch — double-check that the version selected in MineVinyl matches the game version you're running.