MCTOOLBOX
MC ToolboxMC TOOLBOX

July 20, 2026

Server & Performance

Custom Music Discs & Sound Events in Minecraft 26.x

Replace jukebox music discs or add brand new custom audio tracks to your server using Java & Bedrock resource packs.

Custom music discs allow you to add custom soundtracks, meme audio, or background music to your Minecraft server or adventure map using resource packs.

Minecraft Music Disc Maker showing disc selection, audio upload, and pack export settings
Select a vanilla disc slot, upload the replacement audio, then export a Java ZIP or Bedrock MCPACK.

Audio Format Requirements

Minecraft requires all custom audio files to be encoded in OGG Vorbis (.ogg) format at 44.1kHz sample rate.

sounds.json Registry Configuration

In your resource pack, register the audio file in assets/minecraft/sounds.json:

{
  "music_disc.custom_track": {
    "sounds": [
      { "name": "records/my_custom_song", "stream": true }
    ]
  }
}

Converting MP3/WAV Audio Automatically

Converting audio files and setting up the JSON manually can be tricky. Use our web-based Music Disc Maker to drag and drop your audio files and export a complete Java or Bedrock pack in seconds!

Add audio to a resource pack

  1. Convert audio to OGG Vorbis and use a lowercase filename without spaces.
  2. Place the file under your namespace in the resource pack.
  3. Register the sound event in sounds.json with a path that matches the file.
  4. Reload resources and test the event with /playsound before connecting it to an item.
  5. Test volume and falloff from several distances.

Diagnose silent audio

Check the game log for a missing file or invalid JSON, confirm the sound category is audible and verify that the OGG encoding is supported. File paths are case-sensitive inside packs even when the operating system is forgiving.

A custom sound event does not automatically create a fully independent music disc item. Depending on the target version and design, a datapack, item component or replacement model may also be required.

Gio Nui

Gio Nui

Independent web developer and editor of MC Toolbox. Guides are maintained alongside the site's browser-based Minecraft tools, with commands, file formats and version notes reviewed during updates.

More Guides