Use

Open the player from the music button on the title screen or pause menu, or from Mod Menu.

Playlists

The ⋯ menu by a playlist's name deletes it.

Select songs

Selected songs share one right-click menu.

Your stats

A play is 30 seconds, or half of a song that ends on its own. Saved in config/cuemymusic/stats.json. The listening above is sample data.

Playback

Previous restarts the song after its first 3 seconds.

The queue

When the queue ends, the game's music returns on its own schedule. The queue shows its next song and the break before it. Click it to play it now.

Disliked songs are skipped. Songs you pick keep playing through dimension changes and menus.

Music pauses while Minecraft is in the background. Turn this off with Pause in background.

Mixing

With add-on songs, a Mix chip shows a list as a mix. Click a transition to edit it, then drag a song to move it a beat at a time. The pack above is sample data, so it's silent.

Auto picks the transition:

TransitionWhen
BlendTempos within 6%, and keys that go together.
RiseTempos match, keys clash.
FadeA small tempo gap.
EchoA big tempo gap.

Beatmatching changes the next song's speed by up to 8%, without changing its pitch.

Resource packs

A pack that adds or replaces music gets its own page, with its name, icon and author.

Name a pack's songs in assets/<namespace>/cuemymusic.json:

{
  "tracks": {
    "mypack:music/rain": { "title": "Rain", "artist": "Someone", "album": "Weather" }
  }
}

Add-ons mode plays a pack's songs. Vanilla + FX leaves them out.

Keys

Key Does
Unbound Opens the player.
Unbound Plays or pauses.
Unbound Plays the next song.
Unbound Plays the previous song.
Unbound Turns effects on or off.
Space Plays or pauses.
Cmd ← Cmd → Plays the previous or next song.
Cmd ↑ Cmd ↓ Changes the music volume.
Cmd S Cmd R Turns shuffle or repeat on or off.
Cmd F Cmd Shift L Searches this page or everything.
Shift-click, Cmd-click, Shift ↑ Shift ↓, Cmd A Selects songs.
Enter Delete Esc Plays, removes from this page, or clears the selection.

Rebind under Controls → Key Binds → Cue My Music. The keys from Space down work in the player, with Cmd on a Mac and Ctrl elsewhere.

Commands

They work on any server.

Command Does
/cmm play <song> Plays the song now, then the queue, then the game's music.
/cmm play Resumes.
/cmm queue <song> Adds the song to the queue.
/cmm next Next song.
/cmm prev Previous song, or the start of this one.
/cmm pause Pauses.
/cmm repeat [off|all|one] Sets repeat, or cycles it with no argument.
/cmm dislike [song] Dislikes the song, or the one playing. Again to undo.