Custom Discs

Custom Discs

Mixer stores an audio source and track metadata on an item. By default, that item must be a vanilla music disc; server owners can enable custom item requirements in config.yml.

Burning a disc

Hold the target item in your main hand and run:

/mixer burn <url>

Permission: mixer.command.burn.

Mixer loads the source asynchronously, then writes the author, title, and stable source onto the same inventory item. If the player changes or moves that item before loading finishes, Mixer cancels the burn instead of modifying a different item.

Supported sources

• Sources supported by Lavaplayer, including YouTube when enabled, SoundCloud, Bandcamp, Twitch, and compatible streams.
• Direct HTTP(S) media URLs.
• Local file:// sources accessible to the server.
• cobalt://<url> or cobalt:<url> sources resolved through Cobalt.
• Custom protocols registered by a Mixer addon.

Availability can depend on the source site, network access, and its current API.

Saving media locally

Append --save or -s as the final argument:

/mixer burn https://example.com/track --save
/mixer burn cobalt://https://example.com/video -s

Mixer resolves and downloads the media into plugins/Mixer/audio, then stores the local path on the disc. Local saving uses server disk space; back up or clean this directory according to your server policy.

Without the flag, Mixer keeps the original stable source on the disc. This is preferable for addon protocols and Cobalt URLs that may resolve to short-lived media URLs.

Custom burn items

Enable mixer.burnRequirements.enabled to accept a material, Custom Model Data value, and/or Paper item-model key instead of requiring a vanilla music disc. Every enabled check must match. See Installation and Configuration.

Playing a disc

1. Ensure the player has Simple Voice Chat installed and connected.
2. Right-click a jukebox with the custom disc.
3. With mixer.disc-inserted: true, the disc enters the jukebox. Right-click again to eject it. With false, playback starts without consuming or inserting the item.
4. Left-click the jukebox to stop Mixer playback.

Custom discs can also be played through a portable speaker or placed in an automated playlist container.