Troubleshooting
| Problem | Fix |
|---|---|
requires modmenu |
Install Mod Menu for your Minecraft version. |
| Open player key does nothing | Bind Open player under Controls. |
| A function key changes brightness or volume | On a Mac, hold fn, or turn on standard function keys in macOS settings. |
| A change doesn't apply | Wait for the ring next to it to go. Already-queued audio plays out first. |
| Seek is slow on a long song | Seeking decodes up to that point. Far into a 6-minute song can take a moment. |
| A pack's songs are missing | The pack points at files that don't exist in this version. Vanilla can't play them either. |
| Music sounds hollow with AirPods or other spatial audio | Turn off Directional Audio in Options → Music & Sounds. |
| Add-on songs are silent, or come out of a different device | With Keep add-on songs out of recordings on, they play through the system's default output, not the game's. See logs/cuemymusic-outside.log, or turn the setting off. |
| Broken config | Delete config/cuemymusic/config.json and relaunch. |
Report issues with logs/latest.log and your Minecraft, mods and loader versions.
Limits
- Only background music: sound effects and jukeboxes play as normal.
- Mods that replace the music stream, such as radios or other players, may bypass it.
- Pitch and speed sound best within about ±5 semitones and 0.75–1.5×; beyond that, some smearing or echo.