Custom Jukebox Discs
Music is a huge part of the Minecraft atmosphere. The ambient soundtrack, the nether's eerie hum, and the iconic discs like Cat and Mellohi all build the world's mood. But what if you could bring your own soundtrack into the game? That is exactly what the Custom Jukebox Discs add-on allows you to do. This clever mod transforms any MP3 or OGG file on your computer into a fully functional music disc that you can play in a standard jukebox, complete with all the vanilla mechanics you already know and love.
What Does Custom Jukebox Discs Do?
Simply put, this mod bridges the gap between your personal music library and the blocky world. You drop audio files into a specific folder, craft a special disc writer, and then burn your chosen track onto a blank disc. The result is a real, working music disc that integrates seamlessly with the game's existing systems. It is not a streaming service or a separate music player; it is a true vanilla extension.
How to Install Custom Jukebox Discs for Minecraft
Before you can start creating your own records, you need to get the mod running. The add-on is built for Minecraft 1.21.1 and requires the NeoForge mod loader. You will need to install the mod on both your client and your server, as it is a server-authoritative mod. The process is straightforward:
- Download the mod file from a trusted source like Modrinth or CurseForge.
- Place the downloaded JAR file into your
modsfolder for both your client and your server. - Launch the game to generate the necessary config and folder structures.
- Locate the new
customjukeboxdiscsfolder inside your.minecraftdirectory. - Drop your
.mp3or.oggfiles into theuploadssubfolder.
Once that is done, you are ready to start crafting. For players who prefer a more streamlined approach, using the foxygame.net launcher simplifies the entire process. This launcher offers a one-click install for Custom Jukebox Discs for Minecraft, automatically handling version compatibility and mod dependencies, so you can skip the manual file management and jump straight into the fun.
Crafting Your First Custom Disc
Now that the mod is installed, you need to create the tools to write your music. The mod introduces two new craftable items: the Disc Writer and the Blank Disc.
Required Recipes
- Disc Writer: Crafted with iron ingots, a redstone dust, and a jukebox. This block is the heart of the operation.
- Blank Disc: Crafted with a piece of paper and an iron nugget. These are the raw materials for your new records.
Once you have these items, place the Disc Writer down and right-click it to open its interface. Put a Blank Disc into the slot, and a list of all the audio files you placed in the uploads folder will appear. Select the track you want, hit the write button, and your custom disc is created. The disc will be assigned one of 12 unique disc designs, ensuring that a wall of your custom records doesn't look like a stack of identical items.
How to Use Your Custom Discs
Your new disc works exactly like any other music disc in the game. Place it in a jukebox, and it will play your track on the "Records" volume slider. The sound has proper distance falloff, so walking away makes it quieter, and breaking the jukebox stops the song instantly. The discs also interact with redstone components: hoppers can move them, and comparators can read them. This opens up a world of possibilities for creating custom music-based contraptions and adventure maps.
There is also a new Disc Rack block, a 9-slot shelf that displays the discs you place inside it. You can right-click a disc to grab it or sneak-click to open the entire rack like a chest. Comparators can read how full the rack is, making it a great storage and display solution.
Server Administration and Commands
If you run a server, Custom Jukebox Discs gives you complete control. By default, only operators can write discs, which can be surprising for new players. You can change this with a few simple commands:
/customdiscs access mode everyone- Allows all players to write discs./customdiscs access mode allowlist- Restricts writing to a specific list./customdiscs access allow <player>- Adds a player to the allowlist./customdiscs access deny <player>- Denies a player access, which overrides operator status.
You can also manage the tracks themselves with commands like /customdiscs tracks list, /customdiscs tracks info, and /customdiscs tracks delete. The server re-reads every uploaded file to determine its true length, ignoring any claims from the client, ensuring fair play. Tracks are stored by their content hash, so if five players upload the same song, it only takes up one slot on the server's disk.
Important Considerations and Limits
Before you start uploading your entire library, there are a few things to keep in mind. The mod has default limits that you can edit in the customjukeboxdiscs-server.toml file:
- File size limit of 10 MiB.
- Maximum track length of 10 minutes.
- 20 tracks per player.
- 100 MiB of storage per player.
- 2 GiB of total storage per server.
- Transfer rate of 512 KiB/s per player.
Audio is downmixed to mono to ensure proper positional audio. The mod does not transcode anything and has no native binaries or telemetry. It is completely open-source under the MIT license. For those looking to expand their server's musical capabilities, the foxygame.net launcher's add-on catalog features Custom Jukebox Discs alongside other quality-of-life mods, and its auto-update feature ensures you always have the latest version without breaking your existing worlds.
Final Thoughts
Custom Jukebox Discs is a fantastic mod for anyone who wants to personalize their Minecraft experience. It is simple, functional, and deeply integrated with the vanilla game mechanics. Whether you are creating an atmospheric adventure map, building a player-run nightclub, or just want to hear your favorite song while you mine, this mod delivers. The only rule is to upload music you are allowed to share. So, download Custom Jukebox Discs today, and start filling your world with your own soundtrack.
--- **Update Sep 19, 2026:** Added 1 file for version 1.21.1 (NeoForge).