Yecoyz.
Docs/yecoyz_jukebox

Usage

Controls, commands, links and the jukebox editor.

Get yecoyz_jukebox

Using a jukebox

Use the jukebox with ox_target ("Use the jukebox") or the prompt (E). The player walks to the buttons and leans on the cabinet, and the camera looks down at the glass where the songs are listed. A key card in the bottom right corner shows the controls.

Key Action
↑ / ↓ or mouse wheel Browse the songs
Enter / E Play the song, or queue it when something is playing
L Play a link
← / → Jukebox volume (for everyone)
Space Skip
R Pause / resume
X Stop and clear the queue
Delete Remove a link from the list (whoever added it, or an admin)
Backspace / Esc Leave

Press L at the jukebox to open the link dialog, or stand at a jukebox and use /jukebox url.

Link How it plays
YouTube (watch, youtu.be, shorts, embed, live) Through a hidden YouTube player. Title and channel come from YouTube. Videos that don't exist or don't allow embedding are refused with a message.
Direct audio (mp3, ogg, wav) Streamed directly. Title and artist come from the file's tags, or from the file name.
Dropbox and Google Drive share links Turned into direct downloads automatically.

Title and artist fill in as you paste the link, and you can change them before pressing Play. Spotify links aren't supported.

A played link is added to that jukebox's song list, tagged YOUTUBE or LINK, so anyone can pick it again. The list keeps up to linkLimit links; when it's full, the oldest is removed. Links that fail to load are removed by themselves.

Note

YouTube plays outside the 3D audio engine, so YouTube songs get distance volume but no left/right pan or muffling through walls.

Commands

Command Description
/jukebox url <link> [title] Plays a link on the nearest jukebox. Without a title, it's looked up from the link.
/jukebox volume <0-100> Sets your own jukebox volume. It's saved.
/jukebox editor Opens the placement editor. Admins only. /jukebox place does the same.
/jukebox remove Removes the nearest placed jukebox within 4 m. Admins only.

Editor

/jukebox editor switches to a free camera with a mouse cursor. It needs the yecoyz_jukebox.place ace or the command ace.

Key Action
Right mouse button (hold) Look around
W A S D Fly
Q / E Down / up
Shift Faster
N Place a new jukebox where the cursor points, facing the camera
Click Select a placed jukebox
Drag the red / green / blue arrows Move along X / Y / Z
Drag the gold ring Turn
Drag the cabinet Slide it over the floor
Ctrl Snap (0.1 m, 15°, 0.25 m grid)
Mouse wheel Turn 15° (Shift: 1°)
Tab Change model
G Drop to the ground
L Name it (shown on the glass)
Enter Save
Delete (twice) Remove
Backspace Deselect / close

Placed jukeboxes are saved in data/placed.json. Moving one keeps its music playing. Jukeboxes that are part of the map can't be edited.