Guide · Reference
Why Minecraft music needs mono OGG
Walk away from a jukebox and the music fades. Walk past it on the left and the song sits in your right ear. That spatial behaviour is one of Minecraft's small joys — and it silently breaks if your custom disc audio is stereo. Here's the full story.
How Minecraft positions sound in the world
Minecraft's sound engine treats most sounds as point sources in 3D space. When a jukebox plays a disc, the game places that sound at the jukebox's block position, then continuously recalculates volume and left/right balance based on where you are standing and which way you are facing. The result is positional audio: the music gets quieter with distance and pans between your ears as you turn.
The catch is that this spatialisation only works on mono sources. A mono file is a single channel of audio, which the engine can freely place anywhere in the stereo field. A stereo file already has two baked-in channels, so the engine cannot reposition it — there is no single “point” to pan.
What stereo audio does in a jukebox
Feed a jukebox stereo audio via a resource pack and Minecraft plays it unpositioned: at constant volume, centred in your headphones, regardless of where the jukebox is or how far you walk from it. The track effectively plays “inside your head” until it ends — across the map, in another dimension, anywhere. All of Mojang's own disc recordings are shipped as mono files for exactly this reason.
Occasionally that global behaviour is what a map-maker wants (think background music for a custom map), but for a music disc that should feel like it is coming out of a physical jukebox, mono is the only correct choice.
How MineVinyl handles conversion
When you assign a track in the generator, MineVinyl runs FFmpeg (compiled to WebAssembly, entirely in your browser) with settings chosen for jukebox playback:
- Downmix to mono — both stereo channels are blended into one, so the positional audio described above works correctly.
- OGG Vorbis encoding at quality level 5 (roughly 160 kbps) — the only audio format Minecraft's engine reads.
- 44.1 kHz sample rate — the standard rate the vanilla discs use.
- Metadata stripped — tags, artwork and chapter data are removed, keeping the file lean.
This applies even when you upload a file that is already OGG — it is re-encoded to guarantee the mono channel layout, since a stereo OGG would “work” but break spatialisation in the subtle way described above.
Does mono ruin my mix?
Downmixing folds the left and right channels together, so very wide stereo effects (hard-panned guitars, ping-pong delays) lose their width, and rare phase-inverted elements can drop in volume. For the vast majority of music the mono version sounds completely normal — you are usually hearing it through a small in-game “speaker” anyway. If your track relies heavily on stereo imaging, audition a mono bounce in your audio editor first; what you hear there is what the jukebox will play.
Bitrate and quality recommendations
There is little point feeding the converter ultra-high bitrates: the output is mono Vorbis at quality 5, which is transparent for most material. What matters more is the source:
- Start from a lossless file (WAV/FLAC) or a high-bitrate MP3 (192 kbps or better) when you can. Converting a low-bitrate MP3 stacks two generations of lossy compression.
- Keep tracks to a sensible length — the file plays in full from the jukebox, and enormous files bloat the pack zip every player downloads.
- See the supported formats guide for the full input format list and file size guidance.