JukeBox

JukeBox offers you to work in music with only Minecraft opened!
♪

NoteBlockAPI is required!

WARNING: the latest versions are not compatible with MC < 1.21. Please download the
1.20.10 instead.

Features:

• All your songs are stored in a multiple-pages graphical interface, you just have to click on a song for listen it!
• Many languages available : English, Swedish, German, French (français montrez-vous !), Chinese, and more! (full list at the top of the page)
• Player-specific settings are saved into a data file to reload them when the server restarts! - those player datas can also be stored in a SQL database if configured so in config.yml!
• You can enable a song player when you log in.
• Download command: if you don't want to download a song on your computer, to transfer it in the folder... just write the URL and the command will make all the work!
• You can enable a shuffle mode, all the songs are randomly selected (and not played several times).
• You can pause/revive the current music.
• Playlists/favorites songs system, middle-click on your favorite songs to add them to your playlist!
• You can modify the volume of the music! (in a range of 0 - 100%)
• Particles effect can be enabled, and is synchronized with music tempo! (demo available on my Discord server)
• Server radio
• Easy-to-use admin commands
• Option to disable vanilla music as long as JukeBox music is being played!
• Almost lag-free ; most of the stuff which can be done asynchronously... is done asynchronously!
• Compatible with hex colors for > 1.16 servers by using the §#xxxxxx format in language file

Commands:

/music (alias:
/jukebox): to open the JukeBox (radio item do the same)

/adminmusic ... (alias:
/amusic):

reload: reload the configuration and songs

player <player>: see which song a player is listening

play <player> <id>: play a song to a player

playlist <player> <radio|favorites|playlist>: change the playlist a player is listening to

stop <player>: stop the currently listening song

setItem: set the radio item

download <url> <destinationFile>: download a song file from the internet and load it

shuffle|particles| <player>: toggle player options

volume <player> <value|-|+>: set/decrease/increase the volume

random <player>: play a random song

next <player>: skip the current song

Permissions:

music.command (given to players by default): gives access to the GUI

music.command.admin (given to operators by default): gives access to
/adminmusic
music.adminItem (given to operators by default): changes item format

Placeholders:
(only if PlaceholderAPI is enabled)

%jukebox_active% (show formatted active song)

%jukebox_active_title% (show title of active song)

%jukebox_active_author% (show author of active song)

%jukebox_active_description% (show description of active song)

%jukebox_playlist% (show active playlist)

%jukebox_playeroptions_
X
% (value of option
X: volume, shuffle, join, particles, loop)

Spoiler: config.yml

Code (YAML):

language - available by default : en, fr, de, se, cn, es, ja, sk, lt, hu, pl, id, ru, zh, ko, nl

lang
: en

force the music played on join (players can't disable it)

forceJoinMusic
: false

open the plugin GUI when a player click on a jukebox block with a disc

jukeboxClick
: false

send plugin message when starting/stopping music...

sendMessages
: true

load files asynchronously

asyncLoading
: false

list of worlds where music will be enabled (empty = all)

enabledWorlds
:
[
]

note particles

noteParticles
: true

enable or not action bar messages instead of chat (not available on 1.8)

actionBar
: false

enable or not server radio

radio
: true

automatically play the radio when a player joins

radioOnJoin
: false

reload the song the player was listening to before it left the server

reloadOnJoin
: true

periodically stops vanilla music - can cause a bit of lag

preventVanillaMusic
: false

material of songs in the GUI. Examples: DIRT, GOLD_INGOT. Any invalid material will lead to random records.

songItem
: RANDOM_RECORD

name of songs items for everybody (variables: NAME, ID, AUTHOR)

itemFormat
:
"{NAME}"

name of songs items for players with music.adminItem (variables: NAME, ID, AUTHOR)

itemFormatAdmin
:
"{NAME}    | {ID}"

formatted songs name (variables: NAME, ID, AUTHOR)

songFormat
:
"\"
{NAME
}\
", {AUTHOR}"

are player datas kept in a file when they quit - always enabled if database enabled

savePlayerDatas
: true

database configuration

database:

  enabled
: false

  host
:
"localhost"

  port
: 3306

  database
:
"jukebox"

  username
:
"unknown"

  password
:
"unknown"

  ssl
: false

player options gived to new players

defaultPlayerOptions:

  volume
: 70

  join
: false

  shuffle
: false

  particles
: false

  repeat
: false

CraftBukkit/Bukit are not supported. Spigot (or a fork, like Paper) must be used.

Installation:

• Put NoteBlockAPI and JukeBox .jar files in the plugins directory and launch the server. Two new folders will be created : plugins/JukeBox (with config.yml), and plugins/JukeBox/songs inside the first one.
• To add songs, download .nbs files from the Internet and copy them to the songs folder.

Trick: You can get NBS songs from
this list,
this one,
here or
there.

Don't forget to check the Documentation page in order to find interesting tutorials on how to download a song, how to setup a region music, how to play tunes to everybody...

♪ Have a good day ♥