Guide · Help
Troubleshooting
Something not working? Find your problem below. If none of these fix it, contact us with details about your browser and Minecraft version.
Minecraft shows "This pack was made for an older/newer version of Minecraft"
This warning appears when the pack_format value in the pack doesn't match your game version. It's usually safe to click Yes to load it anyway — resource packs are generally forward-compatible. To fix the warning permanently, regenerate the pack in MineVinyl with the correct version selected. Double-check that the version shown in the MineVinyl dropdown matches the version shown in the bottom-left of Minecraft's main menu. For the full version-to-format table, see pack_format explained.
The disc plays the original Minecraft music instead of my track
Make sure the pack is actually enabled. In Minecraft go to Options → Resource Packs and confirm your pack appears in the right (Selected) column. If multiple packs are active, check that your MineVinyl pack is at the top of the stack — packs higher in the list take priority. Also confirm you're using the specific music disc slot you assigned the track to in MineVinyl (e.g. assigning to “Cat” only replaces the Cat disc). In hand-edited packs, this symptom also means the file path or filename is wrong: Java disc audio belongs in assets/minecraft/sounds/records/ and must use the exact vanilla filename for that slot, such as cat.ogg or creator_music_box.ogg.
No sound plays at all when the disc is in a jukebox
Check Minecraft's audio settings (Options → Music & Sounds). The Records volume slider must be above zero — this is a separate control from master volume. Also verify that the OGG file is not silent (some converters can produce a silent file if the input has encoding issues). Re-upload and try converting from a WAV source if possible. If the pack was edited after download, open the zip and make sure it is not double-nested: Minecraft should see pack.mcmeta at the top level of the zip, not inside an extra folder with the same name as the pack.
Conversion progress bar is stuck or the page freezes
FFmpeg WASM is memory-intensive. Try a hard refresh (Ctrl+Shift+R / Cmd+Shift+R) to clear cached state, then re-upload. If a specific file keeps failing, convert it to MP3 or WAV first using a tool like Audacity, VLC, or HandBrake, then upload the converted version. Very large files (>200 MB) may time out on low-memory devices — trim the track first. If a short file fails every time, the source may be corrupt, partially downloaded, or DRM-protected. Exporting a fresh DRM-free copy from an audio editor usually fixes the decode step.
The downloaded zip is empty or the file is corrupted
This occasionally happens if you click Generate before all conversions have completed. Wait for all progress bars to finish before generating. If the problem persists, try a different browser — Chrome and Firefox have the most robust WebAssembly support. Safari 16.4+ should also work.
The pack works in singleplayer but not on a multiplayer server
Resource packs are client-side only — each player must have the pack enabled in their own Minecraft client. The pack is not sent to the server. If you're an admin and want all players to hear the custom music, you'll need to configure a server resource pack in your server's server.properties (set resource-pack to a direct download URL).
The music plays everywhere at full volume instead of fading with distance
This happens when the disc's audio file is stereo rather than mono — Minecraft can only position mono sounds in 3D space, so stereo tracks play unpositioned, “inside your head”, across the whole world. Packs generated by MineVinyl shouldn't have this problem (every upload is downmixed to mono), but it's common in hand-made packs or if you swapped an OGG into the zip manually. Re-run the file through the generator, or read why Minecraft music needs mono OGG for the full explanation.
The pack was working before but broke after a Minecraft update
Major Minecraft updates sometimes change the required pack_format value. Regenerate your pack in MineVinyl with the new version selected. Your audio files don't need to be re-uploaded — just set the correct version, reassign the same tracks, and generate a new zip.