Jukebox Custom Disc Fix Mod is a utility mod that fixes bug MC-260346 by stopping custom music discs from being cut off in jukeboxes for Minecraft on Fabric, Forge, NeoForge, and Quilt. It is designed for players and server owners who use custom disc audio and want playback to continue until the disc is actually removed.
The problem here is simple but annoying: a custom song can start correctly, then stop early when the equivalent vanilla disc would normally end. That breaks immersion fast, especially in modpacks, servers, adventure maps, or themed builds where custom audio matters. With more than 1.1 million downloads on Modrinth, this fix has already become a go-to solution for players who want custom jukebox discs to feel dependable instead of inconsistent.
Key Features of Jukebox Custom Disc Fix Mod
- Fixes MC-260346 for custom jukebox playback — The main benefit is direct and easy to appreciate: custom music discs are no longer forced to stop at the vanilla disc timeline. If you use custom songs that are longer than vanilla tracks, this matters immediately because your audio can finally play the full intended length.
- Server-side stop logic based on actual disc removal — Instead of stopping a song when vanilla timing says it should end, the mod changes behavior so playback stops when the disc is removed from the jukebox. That feels more natural in real play, because the music now follows what the block is doing rather than an unrelated vanilla limit.
- Client-side fix for Minecraft 1.21 and later — As of Minecraft 1.21, the mod also includes a client-side approach that ignores premature stop instructions and waits until the jukebox no longer has a record. This is especially useful if you want to join servers with a custom disc resource pack and still hear tracks play through properly.
- Useful for resource-pack-based custom discs — The author notes that Minecraft 1.21 has a vanilla datapack-based way to add custom discs, and that route is strongly recommended. Even so, if you still prefer the simpler resource-pack-only approach, this mod fills the gap and keeps those custom discs from being cut short.
- Flexible server use — When installed on a server, connecting clients do not have to install it as well. That makes it attractive for server owners because they can correct the jukebox behavior without turning the fix into another required client download for everyone who joins.
- Broad loader and version coverage — The project supports Fabric, Forge, NeoForge, and Quilt, with listed game versions spanning from 1.20.1 up through 1.21.11, plus 26.1 and 26.1.1 entries. For a focused utility mod, that range is important because it gives players more ways to fit the fix into an existing setup instead of rebuilding around one loader.
Screenshots
How to Install Jukebox Custom Disc Fix Mod
- Check your Minecraft version first, then choose the matching loader for your setup: Fabric Mod Loader, Minecraft Forge, NeoForge, or Quilt Loader.
- Install the correct loader on your client or server before adding the mod. This mod is available across multiple loaders, but you still need the proper loader base in place first.
- Download the Jukebox Custom Disc Fix file that matches both your Minecraft version and your loader. The shown download entries include Fabric and NeoForge builds for 26.1.1 and 26.1, plus Fabric builds from 1.21.6 through 1.21.11.
- Place the mod file into your Minecraft
modsfolder, or into the servermodsfolder if you are installing it server-side. Then launch the game or server normally so the loader can detect it. - Test a custom music disc in a jukebox after startup. If you are on Minecraft 1.21 or later and use resource-pack-based custom discs, this is the easiest way to confirm that playback now continues until the record is removed.
Requirements & Compatibility
| Item | Details |
|---|---|
| Category | Minecraft Mods |
| Author | eclipseisoffline |
| Supported loaders | Fabric Mod Loader, Minecraft Forge, NeoForge, Quilt Loader |
| Listed Minecraft versions | 26.1.1, 26.1, 1.21.11, 1.21.10, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.3, 1.21.2-pre1, 1.21.2, 1.21.1, 1.21, 1.20.6, 1.20.5, 1.20.4, 1.20.2, 1.20.1 |
| Download entries shown | 26.1.1 and 26.1 for Fabric and NeoForge, plus 1.21.11 through 1.21.6 for Fabric |
| License | LGPL-3.0-only |
| Published | 2024-02-28 |
| Updated | 2026-04-01 |
| Tags | game-mechanics, optimization, utility |
What's New
- The latest changelog entry marks 26.1.1 as supported.
- The current project listing was updated on 2026-04-01, which shows the mod is still being maintained.
- Current download entries shown include Fabric and NeoForge files for 26.1.1 and 26.1.
- Fabric download entries are also shown for Minecraft 1.21.6 through 1.21.11.
Pros and Cons
Pros
- Directly fixes a specific jukebox bug that is easy to notice in real gameplay.
- Helpful for servers because clients do not have to install it when the server uses the mod.
- Still useful on Minecraft 1.21+ for resource-pack custom discs.
- Supports Fabric, Forge, NeoForge, and Quilt across a wide set of listed versions.
- Appears focused and lightweight because it targets one clear gameplay issue.
Cons
- Its scope is narrow, so players who never use custom music discs may see little benefit.
- Minecraft 1.21 introduced a vanilla datapack route for custom discs, which can reduce the need for this mod in some setups.
- Shown download availability varies by version and loader, so you need to match your file carefully.
- This is a utility fix, not a content mod with new songs, discs, or jukebox features.
Alternatives to Jukebox Custom Disc Fix Mod
- AudioPlayer Mod — A complementary choice if you want broader custom audio options beyond fixing jukebox stop timing.
- Sound Physics Remastered Mod — A good companion if your goal is a more immersive sound experience across Minecraft, not just music disc behavior.
- Presence Footsteps Mod — Another audio-focused mod that pairs well with custom music setups by making the rest of the game world sound more detailed.
Download Jukebox Custom Disc Fix Mod
| Minecraft Version | Fabric | NeoForge |
|---|---|---|
| For Minecraft 26.1.1 | Download | Download |
| For Minecraft 26.1 | Download | Download |
| For Minecraft 1.21.11 | Download | — |
| For Minecraft 1.21.10 | Download | — |
| For Minecraft 1.21.9 | Download | — |
| For Minecraft 1.21.8 | Download | — |
| For Minecraft 1.21.7 | Download | — |
| For Minecraft 1.21.6 | Download | — |
| For Minecraft 1.21.5 | Download | — |
| For Minecraft 1.21.4 | Download | — |
| For Minecraft 1.21.3 | Download | — |
| For Minecraft 1.21.2 | Download | — |
Always download mods from official sources to stay safe.
Frequently Asked Questions
Does Jukebox Custom Disc Fix Mod really fix MC-260346?
Yes — this mod is specifically made to fix MC-260346. Its whole purpose is to stop custom music discs from being cut off when the matching vanilla disc would normally end.
Do I need to install Jukebox Custom Disc Fix Mod on both server and client?
No — when the mod is installed on a server, clients connecting do not have to install it. That said, the mod also has a client-side fix as of Minecraft 1.21 for resource-pack custom discs.
Is this mod still useful on Minecraft 1.21?
Yes — it can still be useful on Minecraft 1.21 if you want custom discs through a resource pack alone. The bug report is marked resolved, but the author still recommends the vanilla datapack method for adding custom discs where possible.
Which loaders are supported?
It supports Fabric, Forge, NeoForge, and Quilt. You should still check the file you download, because the shown download entries vary by Minecraft version and loader.
What makes the 1.21 client-side fix important?
It lets the client keep playing the song until the jukebox no longer has a record. That matters for players joining servers with a custom disc resource pack, because early stop packets no longer cut the music short.
Does this mod add new music discs or audio content?
No — this is a bug-fix utility mod, not a content expansion. It improves how existing custom discs behave in jukeboxes rather than adding new songs, new items, or a new audio system.
