
ZMusic
Cross-platform Music System for Minecraft
About this Mod
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
Feedback
Develop
clone
git clone https://github.com/RealHeart/ZMusicbuild
cd ZMusic gradlew clean build
Usage
Download the latest version in release
move jar to plugins folder
Run Server
Documentation
Repositories
- ZMusic - Plugin
- ZMusic Mod - Mod
- ZMusic Docs - Documentation
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
How to Install ZMusic on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
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
Minecraft Versions
26.1.2, 26.1.1, 26.1 (+38 more)
Server-side
✗ UnsupportedRecommended 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.
Similar Mods
Rent Modded Server
Install ZMusic with just one click on your server.