🎵 CDisc Music

Turn any track from the internet into a real music disc. Put it in a jukebox and everyone nearby hears it through proximity voice chat: the closer you stand, the louder it gets.

YouTube, Spotify, SoundCloud, Yandex Music, VK, TikTok, Twitch, Discord attachments, your own music folder, and more.

No API keys, no tokens, no accounts. Install it and it plays. Keys still work if you have them, but nothing needs them.

📥 Requirements

• Simple Voice Chat or Plasmo Voice. One is enough; with both installed CDisc plays through both, so players on either mod hear the same jukebox, and players with both mods hear it once.
• Spigot, Paper or Folia, 1.20 or newer. One jar for all three.

Optional: WorldGuard for protecting jukeboxes in regions, PlaceholderAPI for placeholders.

Put CDisc and the voice plugin into plugins/ and restart. Players need the matching voice-chat client mod to hear the music.

🚀 Quick start

Hold any music disc and run:

/cdisc create never gonna give you up

Pick a track from the list in chat. The disc in your hand now carries that track, with its name and author in the tooltip. Put it in a jukebox, and it plays from the jukebox itself, in sync for everyone in range.

More ways to make a disc:

• /cdisc create https://youtu.be/dQw4w9WgXcQ writes a link straight to the disc
• /cdisc create sc:lofi hip hop searches SoundCloud (yt: sp: ym: vk: work the same way)
• /cdisc create local:rain.mp3 plays a file from plugins/CDisc/local, with Tab completion
• /cdisc disc playlist <link> writes a whole playlist: drop blank discs into the window and each gets a track

A disc is an ordinary item from then on: carry it, trade it, store it in a chest.

✨ Features

💿 Jukeboxes and the player screen

• Crouch at a playing jukebox to see a progress bar with the track and its time, then right-click it to open the player. Without crouching, a right-click takes the disc out as usual. /cdisc sneak lets each player choose how crouching works.
• The player screen: play / pause, seek ±5 s or type an exact timecode, previous / next, repeat (off, whole queue, one track) and shuffle. On 1.21.6+ it opens as a real window with sliders and buttons; older versions and Spigot get the chest screen.
• A queue of 42 discs per jukebox, played one after another. Choose what happens to a finished disc: it stays, it is ejected, or it moves to the end.
• Crossfade: the end of one disc blends into the next, with no gap between tracks.
• Nothing is lost: queues survive restarts and crashes, a playing jukebox resumes where it stopped, and breaking or burning a jukebox drops a jukebox that still holds every disc. Placing it again puts the queue back.
• Live streams from Twitch and YouTube play for as long as the broadcast runs.
• Parrots dance to CDisc discs just as they do to vanilla ones.

📡 Sound

• True proximity audio: the music comes from the jukebox and fades with distance.
• Beacon range boost: build a beacon pyramid under a jukebox and raise its range from the player screen. Bigger pyramids allow more range.

• Speaker groups: link up to 8 jukeboxes into one group and they play the same track in sync. Each speaker can be set to stereo, mono, the left channel or the right one, at its own volume. Good for a club, an arena or a town square.
• Carry a jukebox: pick a playing jukebox up without stopping the track, and the music follows you, through portals too. With /cdisc player scoreboard the lyrics go to your sidebar, and everyone else reads them over your head.
• Two volumes: one for everyone around the jukebox, and one for whoever carries it.
• Goat horns: /cdisc create with a goat horn in hand records a short sound onto it, up to 15 seconds by default. Blowing the horn plays it through voice chat.

🎤 Lyrics over the jukebox

• Timed lyrics float above a playing jukebox, line by line, from free lyrics databases.
• Each player chooses what they see: the words, the words with the track and time, the words with the time, the track and time, the time alone, or nothing. Left and right click on the lyrics button in the player screen step through the views, or use /cdisc lyrics.
• Your own look: /cdisc preset sets colours, size, opacity, line count, shadow, fade and slide, with a live sample in front of you. Everyone reads the hologram their own way, and /cdisc preset share <player> offers your look to a friend.
• Server presets: admins make named looks with /cdisc admin presets and hand them to players, to a selector, or to everyone as a default. Optionally forced, so nobody can change them.
• Live chat: on a Twitch or YouTube live stream, the stream's chat takes the place of the lyrics.

🎙️ Broadcasts (experimental)

⚠️ Experimental. Broadcasts are new and may still have bugs. If something goes wrong, please report it on GitHub, ideally with a /cdisc admin logs link. broadcast.enabled: false in config.yml switches them off.

/cdisc create broadcast:Name makes a disc that plays no music: in a jukebox it goes live. Its host adds up to six microphones. A handheld one can be passed from player to player; a block microphone hears everyone standing near it. Voices come out of the jukebox and every speaker linked to it, so a stage or a radio station is one disc away.

📁 Your own music folder

• Drop audio files into plugins/CDisc/local and they are discs: local: with Tab completion, played straight from disk with nothing fetched.
• A .jsonc file beside a track gives it its own name, volume, permission and lyrics. /cdisc admin local-files-config <file> edits all of it in a window.
• /cdisc admin download <link or search> saves a track into the folder from in game, from YouTube, Spotify, a direct link or a search, so it keeps playing whatever happens to the original.

🛠️ For server owners

• A permission for every action: pause, skip, seek, queue, carrying a jukebox, lyrics and more, all set in permissions.yml. Screens hide the buttons a player may not use. Limits for players who are not staff: a cooldown, the longest allowed track, live streams on or off, allowed and blocked hosts.
• WorldGuard: a jukebox inside a region answers only the region's members. The cdisc-jukebox flag opens a region's jukeboxes to everyone, or closes them to members too.
• A settings window: /cdisc admin config edits every config file in game (Paper 1.21.7+).
• Diagnostics: /cdisc admin doctor shows which sources work and which are missing something, and /cdisc admin logs uploads the log with that report for a bug report, with keys and tokens hidden.
• Updates itself: new releases from Modrinth or GitHub are downloaded and installed when the server stops. This can be turned off.
• 7 languages: English, Russian, Ukrainian, German, Spanish, Hebrew and Arabic. Each player reads their client's language, or you pin one for the whole server. Your own translation drops into languages/.
• PlaceholderAPI: %cdisc_track%, %cdisc_position%, %cdisc_progress% and more for the nearest jukebox a player can hear.
• API: other plugins can listen to TrackStartEvent, PlaybackStopEvent and the cancellable DiscCreateEvent, and ask CDiscApi what a jukebox is playing.
• Upgrades keep your settings: every config file is brought up to date from the new jar, your changes stay, and the old file is kept as .old.

🌍 Sources

A search shows a list to pick from; add :10 at the end for more results. Albums and playlists open too.

Why no keys are needed

YouTube is read directly first. When YouTube refuses the server, as it does for many hosting addresses, CDisc asks its public backend, which fetches the track from its own address. The same backend reads Spotify, Yandex Music and VK links without any tokens. It is on by default; sources.yml turns it off.

Keys and tokens in tokens.yml are still read if you add them: Spotify client keys, Yandex Music and VK tokens as a fallback when the backend cannot be reached, a YouTube po-token, and an outgoing proxy. None of them are required.

⌨️ Commands

📊 Stats

https://bstats.org/plugin/bukkit/CDisc%20Music