Creating Discs

/cdisc create writes a track onto the music disc in your hand. Any disc will do, vanilla ones included. From then on it is an ordinary item: carry it, trade it, store it in a chest, put it in a jukebox.

/cdisc create <link or search>

A link is written straight away. A search shows a list to pick from first.

/cdisc create https://youtu.be/dQw4w9WgXcQ
/cdisc create never gonna give you up
/cdisc create sc:lofi hip hop
/cdisc create sp:daft punk one more time
/cdisc create local:rain.mp3

Prefixes

Prefix	Searches
none	YouTube
yt:	YouTube
sc:	SoundCloud
sp:	Spotify (YouTube when no Spotify keys are set)
ym:	Yandex Music
vk:	VK Music
tt:	TikTok, followed by a video number rather than words
local:	The server's music folder, with Tab completion
broadcast:	Not a search: makes a broadcast disc

Links need no prefix: CDisc works out where they belong. The full list, and what each source needs, is on Sources.

Search and picking

The results are listed in chat: title, author and length, each line clickable. Clicking writes that track onto the disc you are holding at that moment.

• Five results by default. Ask for more with a trailing :N, up to 10: /cdisc create yt:feel good inc:10. The tail only counts when it is a number, so nightcore: reloaded stays a query.
• The list belongs to whoever searched; someone else clicking it does nothing.
• One search makes one disc. Picking uses the list up.
• After three minutes the list goes stale, and clicking it says so instead of writing a track you have forgotten about.
• A search that finds exactly one thing writes it without a list.

The disc stores the track's own address, not the query that found it, so it keeps playing what you picked even if the same search ranks something else first later.

Server owners set the default count and per-source ceilings under search in sources.yml.

What is on the disc

The title, the author, the address of the track, and what the plugin already learned about it: its format, its length, whether it is live. The audio itself is not stored, so a disc weighs nothing; it is fetched each time it plays. To keep a copy that survives the original disappearing, save it into the music folder with /cdisc admin download.

Playlists

/cdisc disc playlist <playlist link or search>

A window opens with one slot per track, 45 to a page, with arrows when there are more. Drop blank discs into the slots you want and close the window: every disc you laid out is written at once.

• Fewer discs than tracks is fine. You are told how many tracks had no disc.
• Discs that don't fit in your inventory drop at your feet.
• Only blank discs go into the slots, so nobody's music is overwritten by accident.

YouTube, SoundCloud, Spotify, Yandex Music and VK playlists and albums all open. A plain /cdisc create with a playlist link writes the first track and points at this command.

Clearing and converting

Command	Does
/cdisc disc clear	Returns the held disc, or goat horn, to its ordinary state
/cdisc disc convert	Turns a disc made by pv-addon-discs into a CDisc disc

Goat horns

Hold a goat horn instead of a disc and /cdisc create records a short sound onto it, from any source. Blowing the horn then plays that sound from you through voice chat instead of the horn's own call.

# config.yml
goat-horn:
  enabled: true
  max-seconds: 15     # longest sound a horn holds
  too-long: trim      # trim | refuse
  distance: 64.0      # blocks away it is still heard

Limits

A server can set a cooldown between discs, a longest allowed track, a ban on live streams, and allowed or blocked hosts. When /cdisc create refuses, the reason is in the reply. See Permissions.