ZMusic

ZMusic

Cross-platform Music System for Minecraft

by
28.2K Downloads
fabricforgeneoforgeutility
Rent Server with this Mod

About this Mod





简体中文 | 日本語 | English

V3 version is under development based on TabooLib 6

V2 version is now LTS (long -term support) status

Introduction

This is a powerful music system that supports the following functions.

  • Full service song
  • Play separately
  • Lyrics display
  • Lyrics translation display
  • Multi -search source (Netease Cloud/Ximalaya/Bilibili/SoundCloud)
  • Keyword search
  • Personal song list
  • Full service song list
  • Play of the song list (Netease Cloud)
  • Volume adjustment (only Allmusic MOD support)
  • Support BungeeCord

Video

YouTube

Feedback

Develop

  1. clone

    git clone https://github.com/RealHeart/ZMusic
    
  2. build

    cd ZMusic
    gradlew clean build
    

Usage

  1. Download the latest version in release

  2. move jar to plugins folder

  3. Run Server

Documentation

Click view Documentation

Repositories

Open Source License

This project uses GPL-3.0 license for open source code

ZMusic - Powerful Music System
Copyright (C) 2022 RealHeart
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Thank

Contributors

Available Versions

ZMusic v3.7.1 NeoForge 1.20.4release
MC 1.20.2, 1.20.3, 1.20.4neoforge
June 2, 2026
ZMusic v3.7.1 NeoForge 1.20.6release
MC 1.20.5, 1.20.6neoforge
June 2, 2026
ZMusic v3.7.1 NeoForge 1.21.1release
MC 1.21.1neoforge
June 2, 2026
ZMusic v3.7.1 NeoForge 26.1.2release
MC 26.1, 26.1.1, 26.1.2neoforge
June 2, 2026
ZMusic v3.7.1 Forge 1.12.2release
MC 1.12.2forge
June 2, 2026

How to Install ZMusic on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).

3

Install Mod

Open the mod browser in the dashboard and search for "ZMusic". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabricforgeneoforge

Minecraft Versions

26.1.2, 26.1.1, 26.1 (+38 more)

Server-side

Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

ZMusic server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.

Is ZMusic compatible with fabric and forge and neoforge?

ZMusic officially supports fabric, forge, neoforge for Minecraft 26.1.2, 26.1.1, 26.1. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with ZMusic – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if ZMusic consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install ZMusic with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU General Public License v3.0 only
Server-side
Unsupported

Supported Versions

26.1.226.1.126.11.21.111.21.101.21.91.21.81.21.71.21.61.21.5+31 more