BS CustomJukebox
Music in Minecraft has always been a subtle but powerful part of the atmosphere. The vanilla jukebox and its handful of discs are iconic, but what if you could expand that system without replacing a single original track? That is exactly what BS CustomJukebox delivers. This fully-featured Paper plugin for Minecraft 1.21+ lets you create your own custom music discs, design a unique fragment crafting system, and even give your parrots new dance moves — all while keeping the vanilla experience intact.
Why BS CustomJukebox Stands Out
Unlike other music plugins that overwrite existing discs or rely on complex workarounds, BS CustomJukebox is built entirely in Java and integrates directly with Paper’s API. It adds new discs with custom sounds, metadata, and models, all configured through simple JSON files. The plugin respects your server’s existing content, so players can still enjoy classic discs like "Cat" and "Pigstep" alongside your custom creations.
Server owners running Paper 1.21 or newer (including compatible forks) will find the plugin lightweight yet powerful. It requires Java 21, making it optimized for modern server performance. Whether you want to add a few custom tracks for a themed survival world or build an elaborate music collection system, BS CustomJukebox gives you the tools to do it without touching a single line of Java code.
Core Features of BS CustomJukebox
Custom Music Discs Without Limits
At the heart of the plugin is the ability to define entirely new music discs. You control every detail: the disc’s name, lore, CustomModelData for resource pack integration, and the exact .ogg sound file it plays. Duration tracking ensures each disc stops automatically after its configured play time, so you don’t need to worry about overlapping audio. All disc definitions live in a clean disc.json file, making bulk management a breeze.
Fragment Crafting System
BS CustomJukebox introduces a unique fragment mechanic. Instead of finding complete discs, players collect disc fragments from various sources. Skeletons killing Creepers can drop fragments, and you can set a custom drop chance when a player kills a Creeper. Fragments also appear in dungeon chests, trail ruins, end cities, and other loot tables. Once a player gathers nine fragments (or whatever number you configure), they can combine them in a shapeless crafting recipe to assemble a full custom disc. This adds a rewarding progression layer to your server’s music collection.
Intuitive GUI and Interaction
Right-clicking an empty jukebox opens a clean, user-friendly GUI where players can browse and select any available custom disc. No commands needed for everyday use. For server staff, the /cjb gui command provides an admin panel to manage all discs. The plugin also supports simple hand-held disc insertion: just hold a custom disc and right-click the jukebox to start playback instantly.
Parrots That Dance to Your Beat
One delightful detail is the parrot dancing system. When a custom disc plays, nearby parrots will dance in sync, just like they do with vanilla discs. You can configure the radius (default 3 blocks) to control how far the groove spreads. It’s a small touch that brings your custom music to life.
Seamless Plugin Integrations
BS CustomJukebox works harmoniously with popular protection plugins. WorldGuard integration lets you restrict jukebox usage based on region flags, while GriefPrevention support ties permissions to container trust. These aren’t just placeholder hooks — they’re fully functional, ensuring your custom music system respects your server’s existing claim and region rules.
How to Install BS CustomJukebox
Getting started is straightforward. First, download BS CustomJukebox from its official page or through a trusted launcher. If you use the foxygame.net launcher, you can find BS CustomJukebox in the add-on catalog and install it with a single click, complete with automatic version compatibility checks and updates. For manual installation, place the downloaded JAR file into your server’s plugins/ folder and restart. The plugin will generate all necessary configuration files, including config.json, disc.json, and a languages/ folder.
After the initial setup, you’ll need to prepare a resource pack containing your custom .ogg sound files and assign the appropriate CustomModelData values in disc.json. Host the resource pack on a web server or use a service like Dropbox, then set the pack URL in your server.properties. Reload the plugin with /cjb reload and your custom music is ready to play.
Configuration Deep Dive
The main settings are controlled via config.json. Here you can enable or disable the plugin, choose a language file, toggle the jukebox GUI, and adjust fragment drop rates. For example, you can set creeper-drops to true and define a creeper-drop-chance of 0.05 (5%) for player kills. Loot integration is equally flexible: enable dungeon or trail ruins loot, set the maximum number of discs that can appear, and tweak the loot chance. The parrot dance system and integrations with WorldGuard or GriefPrevention can also be toggled on or off.
Disc definitions in disc.json allow you to specify a unique identifier, display name, lore lines, CustomModelData integer, and the exact sound event from your resource pack. Duration is set in ticks (20 ticks = 1 second), so a 3-minute track would be 3600 ticks. This granular control ensures every custom disc behaves exactly as you envision.
Why Choose BS CustomJukebox for Minecraft
This plugin fills a gap that many server owners have felt for years: the desire to add new music without breaking vanilla features. The fragment system encourages exploration and trading, while the GUI makes music selection accessible to all players. Parrot dancing and robust region protection round out a package that feels both polished and playful.
If you’re running a Paper 1.21+ server and want to give your community a fresh auditory experience, BS CustomJukebox for Minecraft is the ideal solution. The installation is quick, the configuration is intuitive, and the result is a server where every jukebox can become a portal to custom soundscapes. Whether you’re crafting a fantasy RPG, a sci-fi adventure, or just want to share your favorite tunes, this plugin puts the power of music in your hands.
Ready to transform your server’s soundtrack? Download BS CustomJukebox today, follow the simple setup, and let your players discover a world of new melodies — one fragment at a time.
--- **Update Sep 21, 2026:** Added 6 files for version 26.2, 26.1.2, 26.1.1, 26.1, 1.21.9, 1.21.8, 1.21.7, 1.21.6, 1.21.5, 1.21.4, 1.21.11, 1.21.10.