BS CustomJukebox

[2.1.0] - 2026-02-18

Added

• Adventure API Integration: Migrated to modern Paper Adventure API
  • New AdventureUtil class for unified text component handling
  • Full support for HEX colors, gradients, and MiniMessage format
  • Better performance and future-proofing for Paper 1.21+

Changed

• Modernized Text Handling: Core components now use Adventure API
  • CustomDisc.createItemStack() uses displayName() and lore() methods
  • DiscFragment.createItemStack() uses Adventure Components
  • JukeboxListener titles and action bars use Adventure API
  • Player.sendTitle() → Title.title() with proper durations
  • Player.sendActionBar() → Adventure Component-based

Fixed

• Critical Playlist Bug: Fixed playlists stopping after first song

  • stopPlayback() now has clearPlaylistQueue parameter
  • Playlist queue is preserved during auto-progression to next track
  • Playlist queue is cleared only when manually stopping playback
  • This was a critical bug preventing playlists from working correctly!

• Resource Leak in UpdateChecker: Properly closes HTTP connections

  • Added try-finally blocks with explicit connection.disconnect()
  • Added proper BufferedReader closing
  • Prevents resource exhaustion on update checks

Deprecated

• ColorUtil class marked as @Deprecated (but still functional)
  • Kept for backwards compatibility
  • New code should use AdventureUtil instead
  • Legacy ChatColor/BungeeCord API calls will be phased out

Technical

• Deprecation Warning Reduction: 70 → 1 warning (98.6% reduction)
  • Migrated all ColorUtil.colorize() calls to AdventureUtil
  • Replaced 7 internal deprecated method calls
  • Only remaining warning: GriefPrevention external API (cannot be fixed)
• Adventure API bundled in Paper 1.21+ (no extra dependency needed)
• Full backwards compatibility maintained
• All existing features continue to work unchanged

Migration Notes

• Plugin users: No action required - update is fully compatible
• Plugin developers using API: Consider migrating to AdventureUtil for new code
• All color codes (&a, &#RRGGBB, gradients) continue to work as before