What's in the bundle

One more pack shows up on its own: at every server start the plugin writes GrimsJukeBoxes-FollowSounds.mcpack into plugins/Geyser-Spigot/packs/. It is not in the bundle and needs no install. See The follow-sound pack.

Steps

1. Stop the server. Back up plugins/GrimsJukeBoxes, plugins/Packforge/contents, and plugins/Geyser-Spigot.
2. Put the jar in plugins/, and remove any older Grims JukeBoxes jar.
3. Install the current grimsjukeboxes and gjb_reskin content folders in Packforge. Remove the older egw_jukebox reskin if present; gjb_reskin replaces it.
4. Big Jukebox on Java: the Big Jukebox shares Minecraft's note block with Grims Crops. The merged note_block.json replaces the one in the Grims Crops folder, and there must be exactly one note_block.json under contents. It's built for a specific Grims Crops release. README-NOTE-BLOCK.txt next to it names the release and shows how to check yours. Redo this step after every Grims Crops install or update.
5. Put the Bedrock pack in plugins/Geyser-Spigot/packs/, keeping only one Grims JukeBoxes pack there. Keep your music disc packs where they are. Put both mapping files directly in custom_mappings/, with no backup .json copies in any subfolder. Keep gameplay.enable-custom-content: true in Geyser's config.yml. The follow-sound pack needs no install: the plugin writes it at the next start.
6. Start the server with a full restart, because /geyser reload doesn't reload mappings. Then run /pf zip and /pf push all.
7. Check the console. Geyser starts with no Error in registering blocks or Unknown Java block state. Grims JukeBoxes logs Bedrock follow sounds: … for the custom disc packs it found, then Bedrock Walkmans follow their player for … discs, with no warning that packs share a UUID.

Use functional plugin items. Pack-host give commands create artwork items. Use the JukeBoxes recipes or /gjb give for working devices.

Install the matching Crops and JukeBoxes artwork together for the Big Jukebox’s Java appearance.

Upgrading from 0.0.6 or 0.0.7

Only the plugin changed. The resource packs, the Geyser mappings and the merged note_block.json are the same as in 0.0.6.

1. Stop the server. Back up plugins/GrimsJukeBoxes.
2. Replace the old jar with plugins/GrimsJukeBoxes-0.0.9.jar from the bundle.
3. Leave every pack where it is. The bundle's packs are named 0.0.8, but their content is the same as the 0.0.6 files already installed, so nothing needs replacing and players download nothing new.
4. Start the server. Test Java first, then Bedrock.

Coming from 0.0.5 or older, follow the steps above instead. The Big Jukebox block models and the Bedrock pack did change in 0.0.6, and the merged note_block.json from 0.0.5 stays where it is.

The main command is /grimsjukeboxes, alias /gjb.

Teemo's Walkman and the Big Jukebox have no recipe, so /gjb give is the only way to get them. There is no Speaker item or recipe: linking turns an existing block into a speaker.

Walkman Vouchers

A reward item for vote crates that turns into a Walkman. Giving it needs grimsjukeboxes.admin, which the console has, so a crate plugin hands one out with a console reward command:

Use your crate plugin's own player placeholder (%player%, {player}, <player> and so on) and leave out the leading / if it asks for commands without one.

• The item. A paper with the enchantment glint, named Walkman Voucher, with the lore Right-click to redeem a Walkman. and Replaces your current music player; your discs move to it. It has no custom art, so no pack changes are needed.
• Vouchers never stack. The item's maximum stack size is 1, so every voucher takes its own slot in the inventory, chests, shulker boxes and hoppers, two dropped vouchers stay two items when picked up, and a crafting grid slot holds only one.
• Amount. [amount] is 1 to 64, default 1. The command gives that many separate vouchers, one per slot, and the ones that don't fit in the inventory drop at the player's feet.
• Redeeming needs grimsjukeboxes.use. Right-click with a voucher in either hand, in the air or on a block. One click redeems only the voucher in the hand used, even with a voucher in each hand, and holding right-click down redeems just that one.
• What it gives. A Walkman bound to that player, exactly as /gjb give <player> walkman would. It becomes their active music player, their saved discs move to it, and the old player becomes a keepsake. Discs past the Walkman's 9 slots are given back to the player, so nothing is lost.
• If it fails. When the Walkman can't be saved, the voucher is returned and the old player stays active with all its discs. Its song has stopped, so the player presses Play again.
• Old vouchers. Vouchers given by 0.0.7 keep working. A stack of them stays a stack and redeems one voucher per click, and new vouchers never join it.

It is still paper to Minecraft. Any crafting recipe or villager trade that takes paper will use a voucher up. Only the plugin's hidden tag makes a voucher, so a paper renamed Walkman Voucher in an anvil does nothing.

Replaced devices are keepsakes

When a player gets a new music player, from a voucher, /gjb give or crafting, the older one is no longer deleted from inventories and containers. It becomes a keepsake: it never opens and never plays again, and says so when used. The plugin adds the lore line Replaced: keepsake when it next sees the item, and /gjb info reports it as replaced, keepsake.

• Keepsakes stay wherever they are kept: inventories, ender chests, chests, barrels, shulker boxes, bundles, item frames, shelves, armor stands and any other holder.
• Only a keepsake lying on the ground as a dropped item is removed, when its chunk loads. Devices that were never issued are still removed wherever they are found.
• A crafted Walkman or MP3 Player that still shows Loading albums when a newer player replaces it becomes a keepsake too. Before 0.0.7 that copy was deleted.

A player's speaker limit is the highest grimsjukeboxes.speakers.N they have, capped by linking.max-speakers. The primary jukebox doesn't count toward it.

All settings live in plugins/GrimsJukeBoxes/config.yml.

The cleanup worker keeps keepsakes wherever they are stored. It removes only devices that were never issued and keepsakes lying on the ground as dropped items.

Volume and reach

A record at 100 reaches about 64 blocks, 50 about 32, and 25 or lower about 16 (and is quieter below 25). Turning the jukebox and speakers down shortens how far each one reaches, so neighboring sources overlap less.

What /gjb reload applies

Volume, the Bedrock Walkman sound, linking, the duplicate warning, recipes, and placeholder settings for items created afterward. It also re-checks Geyser's packs folder to see which follow sounds exist, but it never rewrites GrimsJukeBoxes-FollowSounds.mcpack: only a restart does that. New volumes apply to the next song that starts. The audit period and both cleanup settings need a restart.

• Issue it with /gjb give <player> big_jukebox [amount]. The item is a note block with the jukebox icon, and each item can be placed once.
• Two blocks. It's a note block with an invisible barrier above it. The space above must be empty air when it's placed. Hoppers and dispensers never reach its playlist.
• Playlist: 45 discs in a 54-slot menu, ordered or shuffle. Adding a disc by using it on the jukebox needs jukebox.big.add. The owner or an admin can arrange and remove tracks.
• Breaking: only the owner or an admin, and only once it's empty. Break the cabinet; the barrier goes with it. A Big Jukebox holding tracks survives explosions.
• Looks: Stop, the end of the playlist, and breaking it go idle at once. A server stop leaves every cabinet idle, and a chunk saved mid-song is corrected when it loads.

Light demos

This release includes three demo Big Jukeboxes for choosing how brightly a playing Big Jukebox lights its surroundings on Bedrock. They are real Big Jukeboxes: the playlist, controls, and linking all work.

Java looks the same for all four, because a block model can't light the area on Java, so there the glow is drawn into the cabinet. Once a level is picked, a later build folds the demos into the standard Big Jukebox. Placed demos convert by themselves. Throw away any unplaced demo items before installing that build.

Walkman sound on Bedrock

Through Geyser, a song attached to a player stays where it started and fades out about 64 blocks away. So for a Bedrock (Floodgate) player's own Walkman, Teemo's Walkman, or MP3 Player, the plugin plays a non-positional copy of the disc that follows them however far they go, and Stop and Next work the same way. playback.bedrock-walkman-sound picks the copy:

• record (default) uses Bedrock's Jukebox/Note Blocks volume slider.
• ui uses Bedrock's UI sound category. Try it if a song still fades as a Bedrock player walks away, then run /gjb reload and start a new song.
• off plays the plain disc sound.

The Grims JukeBoxes Bedrock pack has copies for the 22 vanilla discs and the EGW, crow, and gmd discs. The plugin makes the copies for every other custom disc itself, in the follow-sound pack below, so every disc pack on the server follows its player. A disc neither pack covers still plays, but it fades out about 64 blocks from where it started. The console logs how many discs follow at startup and on reload.

The follow-sound pack

At each server start, with Geyser installed and playback.bedrock-walkman-sound not off, the plugin reads the music disc packs in plugins/Geyser-Spigot/packs and writes GrimsJukeBoxes-FollowSounds.mcpack into that same folder, before Geyser loads it on that same start.

• Nothing to install by hand. Add a disc pack, restart once, and its discs follow. /geyser reload alone doesn't cover a new pack; the next restart does.
• A disc counts when a .mcpack or .zip in that folder defines its sound as namespace:name in the record category, with the audio file in the same pack. EGW Port Studio 3D disc packs (crw, tst) work this way. Discs another pack already covers, like the EGW, crow, and gmd discs, are left to that pack.
• The console logs Bedrock follow sounds: 15 custom discs (crw, tst) in plugins/Geyser-Spigot/packs/GrimsJukeBoxes-FollowSounds.mcpack; Geyser loads it on this start. with your own count and namespaces. It ends with (unchanged) when the discs are the same as last time. Then Bedrock Walkmans follow their player for N discs … counts every disc that follows.
• The file carries no audio, so it is small. It changes only when the discs change, and each change gets a new pack version, so Bedrock players download it once more.
• Leave it in packs/ and keep no second copy of it there. It carries no textures, so it never conflicts with the art packs.
• Encrypted packs (with a .key file beside them) and packs Geyser downloads from a URL can't be read, so their discs keep the plain sound. The console names an encrypted pack.
• If you remove Grims JukeBoxes, delete GrimsJukeBoxes-FollowSounds.mcpack too. Left behind it is harmless.

The Bedrock pack

• Every version uses the same pack UUID, so keep exactly one GrimsJukeBoxes-Bedrock pack in packs/. The console warns if there are two. The 0.0.6, 0.0.7 and 0.0.8 files are the same pack, so any one of them is fine.
• The pack carries the workshop jukebox look, including Vibrant Visuals maps. Delete the old standalone EGW-Jukebox-Bedrock pack if it's still there.
• The Big Jukebox glass is clear on Bedrock, with a thin rim and two light streaks. Java keeps the smoked glass. Past half render distance, the Bedrock window turns solid smoke.

Known issues

• Withers, /fill, /setblock, and WorldEdit can remove a Big Jukebox without going through the plugin's checks. Its music stops, and the next time that chunk loads the Big Jukebox is deleted with its stored discs. Empty a Big Jukebox before building over it.
• Crafting a Walkman while an 18-slot player is active still keeps the discs in slots 10-18 in the saved library, out of sight, instead of giving them back. Only vouchers and /gjb give give them back. Crafting the MP3 upgrade from that Walkman shows them again.