How to Run ZMusic, the Minecraft Music Plugin, in 2026

Want music playing across your Minecraft server without telling everyone to alt-tab into a separate app? That's the gap ZMusic fills. It's a server plugin that lets players search for songs, queue them for the whole server, and read scrolling lyrics, all from inside the game. Personal playlists too, if you'd rather keep your taste to yourself.

What ZMusic Does

At its core, ZMusic turns your server into a jukebox anyone can feed. A player searches for a track by keyword, picks one from the results, and it plays. You can fire off a server-wide request so everyone hears it, or keep playback to just yourself. It pulls from more than one search source, so you're not locked into a single platform's catalog.

The lyrics part surprised me. ZMusic shows synced lyrics while a track plays, and it can display a translated version right alongside the original. On a server with players scattered across different countries, that's a genuinely thoughtful feature.

Playlists come in two flavors: personal and server-wide. Your lobby can loop a curated global playlist while individual players still build their own. Add volume control and BungeeCord support (so it works across a linked network, not just one box) and you've got a fairly complete setup.

It's written in Kotlin and sits at 151 stars. The bStats counters show real servers running it, which is more than you can say for a lot of hobby plugins.

Why You'd Bother Running It

Picture a hub server. Players load in, and instead of dead silence there's a track playing that someone queued thirty seconds ago. That's the obvious use.

But the request feature is where it gets fun. Roleplay servers spin up in-character radio stations. Build servers throw on background music during long sessions. I've seen the listening-party angle work surprisingly well too: someone queues an album, everyone hangs out on a plot, and it turns into a social thing rather than a feature nobody touches.

A silent server feels like a tech demo. A server with a shared soundtrack feels alive.

Would I run it on a hardcore survival server where immersion is the whole point? Probably not. Right tool, right server.

Getting It Installed

This is a standard Paper plugin install, so if you've ever dropped a jar into a plugins folder you already know the drill. Grab the release jar from GitHub:

wget https://github.com/zmusic-dev/zmusic-plugin/releases/download/2.12.0/zmusic-plugin-2.12.0-all.jar

Then move it into your server's plugins directory and restart:

mv zmusic-plugin-2.12.0-all.jar /path/to/server/plugins/
# restart the server so the plugin loads

There's a second download in the releases, the addon jar (zmusic-addon-2.5.0-all.jar). The 2.12.0 changelog notes the addon got bumped to 2.5.0 to round out high-version Paper support, and the same notes mention adapting to Paper 1.21.11, so on a newer Paper build you'll likely want both files rather than just the main plugin.

Exact in-game commands and config options live in the project's docs (over at zmusic.zhenxin.me), and I'd point you there rather than guess at syntax, since the 2.12.0 release actually rebuilt the login system to support multiple login methods. The docs are the source of truth here.

One practical aside: if you're spinning up a fresh server to test this, a clean memorable address beats handing friends a raw IP. minecraft.how has a free Minecraft DNS tool that sorts that out in a couple of minutes.

Features Worth Knowing About

A few things stand out once you're past setup.

Multi-source keyword search

You don't need a song's exact ID or URL. Type a keyword, get results from several sources, pick one. This matters more than it sounds, because no single platform has everything, and search sources go down or change their APIs constantly. Having a few to fall back on keeps requests from dead-ending.

Lyrics, with translation

Synced lyrics scroll as the track plays, and the translation display is the real treat: original and translated lines together. Great for international communities, or honestly just for figuring out what that one song is actually saying.

Personal and server-wide playlists

Two layers here. A global playlist the whole server shares (handy for a lobby on loop) and personal playlists each player curates. Volume control sits on top so nobody gets blasted out of their chair.

Now-playing toasts

The changelog's mention of fixing "Paper 1.21.11 Toast" points at the plugin using those little achievement-style popups for now-playing info. Small touch, but it means players see what's spinning without spamming chat.

Bilibili full-video playback

The latest release widened Bilibili support from music-only to full video audio, and patched the audio conversion headers plus a transcoding timeout that used to trip it up. If your community leans on that platform, recent versions handle it noticeably better.

Where People Get Tripped Up

First thing: ZMusic is built around Chinese music platforms and the deeper docs are primarily in Chinese. There are English and Japanese readme versions, but the detailed documentation assumes some comfort with the original. Not a dealbreaker, just set expectations.

Second, it's GPL-3.0 licensed. Totally fine for running on your server, but if you fork it or build on top, you inherit GPL obligations (your derivative has to stay open under the same license). Worth knowing before you start hacking on it.

Then there's version drift. Minecraft moves fast, and a plugin doing low-level audio work has to chase NMS changes constantly. The project clearly keeps up (the changelog shows Paper 1.21.11 fixes), but always match the plugin version to your server version rather than assuming the newest jar runs everywhere. Actually, that goes for the addon too, not just the main plugin.

And the addon. People grab the main plugin, skip the addon jar, then wonder why newer Paper builds misbehave. If you're on a recent Paper, grab both.

Alternatives Worth a Look

ZMusic isn't the only way to get audio into Minecraft, though it's one of the more feature-packed plugins for actual song requests.

OpenAudioMc takes a different route. It streams audio to a browser companion tab and shines at region-based ambient sound, like different music in different areas of your map. Honestly, less about letting players DJ, more about atmosphere.

For the truly old-school, there are note-block song plugins that play tunes through Minecraft's own sound engine with no external audio at all. Limited, but they work on any client with zero setup. And if your real goal is voice plus a little music, a voice-chat mod scratches a completely different itch. Different tool, different job.

My Take

ZMusic is genuinely impressive for what it's: a polished, actively maintained music system that handles the whole loop from search to synced lyrics. The lyric translation alone puts it ahead of most options I've tried.

The catch is the Chinese-platform and Chinese-docs orientation. If your community is comfortable with that, this is one of the better picks out there. If not, you'll spend some time in translation tools getting it dialed in.

Either way, it's the kind of project that makes a server feel less like an empty world and more like a place people want to hang out. (And if you're polishing the vibe anyway, minecraft.how's skin creator is a fun rabbit hole for giving yourself a fresh look while the music plays.)