CustomJukebox

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.

✨ Features

🎵 Custom Music Discs

• Create custom music discs without overriding vanilla discs
• Use custom sounds via resource packs (.ogg format)
• Fully customizable metadata: title, author, lore, CustomModelData
• Duration tracking: discs automatically stop after their configured play time
• JSON-based configuration via disc.json for easy management

🧩 Fragment System

• Disc fragments: collect fragments to craft complete discs
• Creeper drops:
  • Skeleton kills Creeper → fragment drop
  • Player kills Creeper → configurable chance (e.g. 5%)
• Loot integration:
  • Fragments can appear in dungeons, bastions, end cities, and more
• Shapeless crafting:
  • 9 fragments = 1 complete disc (fully configurable)

🎨 GUI & Interaction

• Jukebox GUI:
  • Right-click an empty jukebox to open a disc selection GUI (if enabled)
• Admin GUI:
  • /cjb gui for admin access to all discs
• Simple interaction:
  • Hold a disc in your hand and right-click a jukebox to start playback

🦜 Parrot Dance System

• Parrots dance in sync with custom music
• Configurable radius (default: 3 blocks)

🌍 Plugin Integrations

• WorldGuard:
  • Region-based jukebox usage depending on USE flag
• GriefPrevention:
  • Claim-based jukebox permissions (requires container trust)
• Full, working integrations – not just placeholders

📦 Requirements

• Server: Paper 1.21+ (or compatible Paper/Spigot fork)
• Java: 21+
• Optional Plugins:
  • [WorldGuard] – region-based jukebox permissions
  • [GriefPrevention] – claim-based jukebox permissions

🚀 Installation

1. Download the latest CustomJukebox-x.x.x.jar.
2. Place the JAR into your server’s plugins/ folder.
3. Start the server. The plugin will generate:
   • config.json
   • disc.json
   • languages/ folder
4. Configure config.json and disc.json to fit your needs.
5. Set up and host your resource pack (see below).
6. Run /cjb reload or restart the server to apply changes.

⚙️ Configuration

All main settings are handled in config.json. Example:

```json { "settings": { "enabled": true, "language": "en", "enable-gui": true, "debug": false }, "discs": { "creeper-drops": true, "creeper-drop-chance": 0.05, "dungeon-loot": true, "trail-ruins-loot": true, "max-loot-discs": 2, "loot-chance": 0.15, "enable-crafting": true, "fragments-per-disc": 9 }, "parrots": { "enable-dancing": true, "dance-radius": 3 }, "integrations": { "worldguard": true, "griefprevention": true } }