BS CustomJukebox

[1.2.0] - 2025-12-13

Added

• Playback Range System: Control who hears custom music with range parameters

  • /cjb play <disc> [loop] [global|world|<radius>]
  • global: All players on the server hear the music
  • world: Only players in the same world
  • Custom radius: Specify exact block radius (e.g., 50, 100, 200)
  • Perfect for server-wide events, world-specific ambiance, or localized music zones

• Volume Restart Feature: /cjb volume <value> restart

  • Apply volume changes to already playing songs instantly
  • Automatically restarts all active playbacks with new volume
  • No need to manually stop and restart songs anymore

• PlaybackRange Model: New enum system for managing playback ranges

  • Clean API for future range-based features
  • Supports NORMAL, GLOBAL, WORLD, and CUSTOM_RADIUS types
  • Automatic parsing from command parameters

Changed

• Extended PlaybackManager with range-aware sound distribution
• Enhanced JukeboxPlayback model to track playback range
• Loop functionality now preserves range settings across restarts
• Updated all command usages to include new parameters

Added (Features)

• Smart player detection based on range type
• Efficient range checking for different playback scopes
• Range information displayed in playback success messages

Updated (Translations)

• All 4 languages updated with new range-related messages (DE, EN, ES, IT)
• New messages: playback-range-info, playback-invalid-range, volume-restarted
• Updated command usage strings for all languages

Technical

• New PlaybackRange class for type-safe range management
• Added restartAllPlaybacks() method to PlaybackManager
• Extended shouldPlayerHearPlayback() with range logic
• Improved playback session management