BS CustomJukebox

# CustomJukebox **Real music on your Minecraft server.** CustomJukebox turns jukeboxes into a full music system: custom discs with your own `.ogg` tracks, playlists, and ambient zones that play background music automatically as players walk into an area — all without replacing a single vanilla disc. Built for **Paper and Folia**, configured in JSON, and translated into four languages. --- ## 🎧 Bedrock players? CustomJukebox streams audio from a Java resource pack, which Bedrock clients handle differently. If you run **Geyser/Floodgate**, install the companion plugin: ### ➡️ (https://modrinth.com/plugin/bs-customjukebox-bedrock-extension) It hooks into the public API events this plugin fires, so no extra configuration is needed on the CustomJukebox side — install both and they work together. --- ## ✨ Features ### 🎵 Custom Music Discs - Add **your own music discs** without overriding vanilla ones - Real audio via resource pack (`.ogg`) — full quality, not note blocks - Customisable **title, author, lore and CustomModelData** - Automatic stop at the configured track length - Managed in `disc.json`, or entirely **in-game** through the admin GUI ### 📻 Ambient Zones & Server Radio Background music that starts on its own for everyone who enters an area — no disc, no command, no redstone. - **Four area types:** radius, cuboid, WorldGuard region, or **global** (a server-wide radio station reaching every player in every world) - **Priority** decides which zone wins where several overlap — a lobby zone can override the radio - **Two playback modes:** `synced` (everyone hears the same track together — ideal for events) or `individual` (each player hears complete tracks from the moment they arrive — ideal for lobbies) - **Height range:** cover the full column (default) or bound the zone in Y as a true 3D sphere/box - **Loop and shuffle**, reshuffled on every lap - Per-zone **volume** and **playlist** ### 🎶 Playlists & Categories - Group discs into playlists and play them in sequence - **Shuffle** and repeat modes (`loop`, `repeat-one`) - **Playback range** per playlist: normal, whole world, server-wide, or a custom radius in blocks - Categories to keep large disc collections organised ### 👤 Player Controls Every player gets these by default — no permission setup required. - **`/cjb music on|off`** — opt out of plugin music entirely, saved across sessions - **`/cjb music volume`** — a personal volume, independent of the server setting - **`/cjb skip`** — skip the track you are currently hearing - **`/cjb favorite`** — keep a personal favourites list and play it as a playlist; discs can also be favourited by shift-clicking them in the disc menu - **Progress bar** — an optional boss bar showing the current track and how far into it you are ### 🧩 Fragment System - Collect **disc fragments** and craft them into complete discs (shapeless, count configurable) - **Creeper drops:** guaranteed when a skeleton kills a creeper, configurable chance for player kills - **Loot integration:** fragments appear in dungeons, bastions, end cities, trail ruins and more ### 🖥️ In-Game Administration - **Jukebox GUI** — right-click an empty jukebox to pick a disc - **Admin panel** (`/cjb gui`) — create, edit and delete discs, playlists and categories without touching a file - Step-by-step **creation wizards** with input validation - **Zone editor GUI** that tells you exactly why a zone is not playing yet - Every list **paginates**, so large collections stay fully reachable - Delete confirmations on destructive actions ### 🌍 Integrations & Compatibility - **Paper 1.21.4 – 26.x** and **Folia** (region-threaded scheduling, auto-detected) - **WorldGuard** — respects the `USE` flag, and can bind ambient zones to regions - **GriefPrevention** — respects container trust - **PlaceholderAPI** — 16 placeholders (disc in hand, volume, mute state, totals, and more) - **Multi-language:** English, German, Spanish, Italian — fully translated, editable - **Developer API** with four Bukkit events (`DiscPlaybackStart/Stop`, `DiscRegistered/Removed`) - **bStats** metrics (opt-out) ### 🦜 Parrot Dancing Parrots react to custom music within a configurable radius. --- ## 📋 Commands ### For everyone | Command | Description | |---|---| | `/cjb music <on\|off\|toggle\|volume <0-4\|reset>\|status>` | Your personal music settings | | `/cjb skip` | Skip the track you are hearing | | `/cjb favorite <add\|remove\|toggle\|list\|play\|clear>` | Manage and play your favourites | | `/cjb gui` | Open the disc menu | | `/cjb list ` · `/cjb info <disc>` | Browse discs | ### For admins | Command | Description | |---|---| | `/cjb zone <...>` | Create and manage ambient zones and radio stations | | `/cjb playlist <...>` | Create and play playlists | | `/cjb play <disc> ` | Play a disc at your position | | `/cjb give` · `/cjb fragment` | Hand out discs and fragments | | `/cjb vol