Jukebox Custom Disc Fix
This mod solves the problem with playing custom music discs in Minecraft jukeboxes. Without it, custom tracks are prematurely cut off at the moment when standard game discs would normally end.
What the Mod Fixes
The mod eliminates bug MC-260346, which causes custom music compositions in jukeboxes to be cut off prematurely. In the original version of Minecraft, the client receives a command to stop playing the sound as soon as the standard disc should end, regardless of the actual duration of the custom track.
Jukebox Custom Disc Fix changes this logic: now the sound stops only when the disc is physically removed from the jukebox — either by the player or using a hopper.
Features for Minecraft 1.21
Starting with Minecraft version 1.21, the game developers have officially fixed this issue. It is now recommended to add custom discs through datapacks using the game's built-in capabilities.
However, if you prefer to use resource packs to play custom discs, this mod will still be needed. The version for 1.21 includes a client-side fix that allows you to listen to full versions of tracks on any server, even if the mod is not installed there.
Technical Details
The client part of the mod (available from version 0.1.4-1.21) ignores packets from the server with commands to stop playback. Instead, it monitors changes in the jukebox block state (has_record) and stops the sound only when the value becomes false.
When installed on a server, the mod does not require it to be on clients — it is fully compatible with vanilla clients.
Supported Versions
| Minecraft Version | Fabric | Quilt | NeoForge | Forge |
|---|---|---|---|---|
| 1.21.6+7+8 | ✅ Current | ✔️ Use Fabric version | ❌ Unavailable | ❌ Unavailable |
| 1.21.5 | ✅ Current | ✔️ Use Fabric version | ❌ Unavailable | ❌ Unavailable |
| 1.21.4 | ✅ Current | ✔️ Use Fabric version | ❌ Unavailable | ❌ Unavailable |
| 1.21.2+3 | ✅ Current | ✔️ Use Fabric version | ❌ Unavailable | ❌ Unavailable |
| 1.21+1 | ✅ Current | ✔️ Use Fabric version | ❌ Unavailable | ❌ Unavailable |
| 1.20.5+6 | ✅ Current, no client side fix | ✅ Current, no client side fix | ✔️ Available, won't receive support | ❌ Unavailable |
| 1.20.4 | ✅ Current, no client side fix | ✅ Current, no client side fix | ✔️ Available, won't receive support | ❌ Unavailable |
| 1.20.2 | ✅ Current, no client side fix | ✔️ Use Fabric version | ❌ Unavailable | ❌ Unavailable |
| 1.20.1 | ✅ Current, no client side fix | ✔️ Use Fabric version | ✔️ Available, won't receive support | ✔️ Available, won't receive support |
Support is typically provided for the latest major and minor versions of Minecraft. Updates may be delayed as the developer does not always have the opportunity to immediately adapt the mod to new versions.
For versions 1.21.x and above, ports for modloaders other than Fabric are not planned due to the complexity of support.
Installation and Usage
Fabric API is not required. When installed on a server, the mod is not needed on clients for multiplayer gameplay.
The mod is distributed under the GNU LGPLv3 license.
