# CustomJukebox<\/p>\n
CustomJukebox is a fully-featured Minecraft Paper plugin for **1.21+** that adds advanced jukebox functionality, fully implemented in Java. It lets you create and manage custom music discs, fragments, and a jukebox GUI without replacing any vanilla discs.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \ud83c\udfb5 Custom Music Discs
\n– Create **custom music discs** without overriding vanilla discs
\n– Use **custom sounds** via resource packs (`.ogg` format)
\n– Fully **customizable metadata**: title, author, lore, CustomModelData
\n– **Duration tracking**: discs automatically stop after their configured play time
\n– **JSON-based configuration** via `disc.json` for easy management<\/p>\n
### \ud83e\udde9 Fragment System
\n– **Disc fragments**: collect fragments to craft complete discs
\n– **Creeper drops**:
\n – Skeleton kills Creeper \u2192 fragment drop
\n – Player kills Creeper \u2192 configurable chance (e.g. 5%)
\n– **Loot integration**:
\n – Fragments can appear in dungeons, bastions, end cities, and more
\n– **Shapeless crafting**:
\n – 9 fragments = 1 complete disc (fully configurable)<\/p>\n
### \ud83c\udfa8 GUI & Interaction
\n– **Jukebox GUI**:
\n – Right-click an empty jukebox to open a disc selection GUI (if enabled)
\n– **Admin GUI**:
\n – `\/cjb gui` for admin access to all discs
\n– **Simple interaction**:
\n – Hold a disc in your hand and right-click a jukebox to start playback<\/p>\n
### \ud83e\udd9c Parrot Dance System
\n– Parrots **dance in sync** with custom music
\n– **Configurable radius** (default: 3 blocks)<\/p>\n
### \ud83c\udf0d Plugin Integrations
\n– **WorldGuard**:
\n – Region-based jukebox usage depending on `USE` flag
\n– **GriefPrevention**:
\n – Claim-based jukebox permissions (requires container trust)
\n– Full, working integrations \u2013 not just placeholders<\/p>\n
—<\/p>\n
## \ud83d\udce6 Requirements<\/p>\n
– **Server:** Paper 1.21+ (or compatible Paper\/Spigot fork)
\n– **Java:** 21+
\n– **Optional Plugins:**
\n – [WorldGuard] \u2013 region-based jukebox permissions
\n – [GriefPrevention] \u2013 claim-based jukebox permissions<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1. **Download** the latest `CustomJukebox-x.x.x.jar`.
\n2. Place the JAR into your server\u2019s `plugins\/` folder.
\n3. Start the server. The plugin will generate:
\n – `config.json`
\n – `disc.json`
\n – `languages\/` folder
\n4. Configure `config.json` and `disc.json` to fit your needs.
\n5. Set up and host your resource pack (see below).
\n6. Run `\/cjb reload` or restart the server to apply changes.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
All main settings are handled in `config.json`. Example:<\/p>\n
“`json
\n{
\n “settings”: {
\n “enabled”: true,
\n “language”: “en”,
\n “enable-gui”: true,
\n “debug”: false
\n },
\n “discs”: {
\n “creeper-drops”: true,
\n “creeper-drop-chance”: 0.05,
\n “dungeon-loot”: true,
\n “trail-ruins-loot”: true,
\n “max-loot-discs”: 2,
\n “loot-chance”: 0.15,
\n “enable-crafting”: true,
\n “fragments-per-disc”: 9
\n },
\n “parrots”: {
\n “enable-dancing”: true,
\n “dance-radius”: 3
\n },
\n “integrations”: {
\n “worldguard”: true,
\n “griefprevention”: true
\n }
\n}<\/p>\n","protected":false},"excerpt":{"rendered":"
Fully-featured Paper 1.21+ jukebox plugin with custom music discs, disc fragments, GUI support, and WorldGuard\/GriefPrevention integration.<\/p>\n","protected":false},"featured_media":35147,"template":"","meta":{"_minecraft_slug":"bs-customjukebox","_minecraft_project_id":"SFWdW3tI","_minecraft_author":"boondocksulfur","_minecraft_license":"MIT","_minecraft_downloads":458,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bs-customjukebox.zip","_minecraft_size_bytes":4811546,"_minecraft_version_count":19,"_minecraft_updated_at":"2026-05-16T10:47:47.432426Z","_minecraft_date_created":"2025-12-14T01:14:13.679376Z","_minecraft_date_modified":"2026-05-06T10:42:26.176042Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bs-customjukebox","_minecraft_icon_attachment_id":35147,"_minecraft_imported_at":"2026-06-01T16:58:10+00:00","_minecraft_import_hash":"e346a2ecc99f6a18c18f65bb2843ab49","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,125,89,127,128,129,123],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-35146","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-folia","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n