promotional bannermobile promotional banner

BS CustomJukebox

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

File Details
Download

CustomJukebox-2.2.0.jar

ByBoondockSulfur
  • R
  • May 2, 2026
  • 221.23 KB
  • 16
  • 1.21.11+11

File Name

CustomJukebox-2.2.0.jar

Supported Versions

  • 1.21.11
  • 1.21.10
  • 1.21.9
  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.21

[2.2.0] - 2026-05-02

Added

  • Public API Events: New event system for companion plugins
    • DiscPlaybackStartEvent — Cancellable event fired when a disc starts playing. Exposes disc, location, and mutable listener set.
    • DiscPlaybackStopEvent — Fired when playback stops, with StopReason enum (MANUAL, DURATION_END, BLOCK_BREAK, PLUGIN).
    • DiscRegisteredEvent — Fired when a new disc is created via GUI or config.
    • DiscRemovedEvent — Fired when a disc is removed, includes a snapshot of the deleted disc.
  • API method: CustomJukeboxAPI.getPluginDataFolder() — Allows companion plugins to locate disc sound files.

Changed

  • PlaybackManager: Now fires DiscPlaybackStartEvent before playing sounds (allows cancellation and listener modification) and DiscPlaybackStopEvent on stop.
  • DiscManager: Now fires DiscRegisteredEvent on disc creation and DiscRemovedEvent on disc deletion.

Technical

  • New package: de.boondocksulfur.customjukebox.api.events with 4 event classes
  • All events follow standard Bukkit event patterns (HandlerList, static getHandlerList)
  • Zero behavior change for existing users — events are no-ops without listeners
  • Foundation for the new BS-CustomJukebox Bedrock Extension