BS CustomJukebox

Fully-featured Paper 1.21+ jukebox plugin with custom music discs, disc fragments, GUI support, and WorldGuard/GriefPrevention integration.

File Details
Download

CustomJukebox-1.2.1.jar

## [1.2.1] - 2025-12-14

### Fixed

- **Critical Configuration Fix**: Fixed inconsistency between `disc.json` and `sounds.json` default configurations

- Updated example disc entries to use correct sound keys (`customjukebox:epic_journey`, etc.)

- Now includes three example discs: Epic Journey, Ocean Dreams, and Forest Walk

- All sound keys now properly match between disc.json and sounds.json

### Added

- **Startup Validation System**: Plugin now validates all disc configurations on startup

- Checks for missing or invalid sound keys

- Verifies sound key format (namespace:sound_name)

- Warns about missing duration settings

- Provides clear error messages for configuration issues

- Helps identify why sounds might not play

- **Enhanced Error Handling**: Significantly improved error feedback when sounds fail to play

- Detailed console logs with troubleshooting steps

- In-game notifications to players when sound playback fails

- Clear explanations of possible causes (missing resource pack, wrong sound key, etc.)

- Suggestions for how to fix common issues

### Changed

- **Documentation Update**: Completely updated resource pack README.md

- All YAML references replaced with JSON (disc.json, config.json)

- Corrected configuration examples to use JSON syntax

- Updated command examples and troubleshooting guides

- Added information about server.properties resource pack configuration

- More detailed testing and debugging instructions

### Technical

- Added `validateDiscs()` method in DiscManager for configuration validation

- Enhanced `playSound()` method in PlaybackManager with comprehensive error reporting

- Improved logging output for debugging sound playback issues

- Better player feedback when sound playback fails