Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
Net Music: Better Login
A Fabric port of ming-sc/NetMusic-BetterLogin (originally built for Forge 1.20.1), bringing better login support to the NetMusic (net-music) mod.
Supported versions: Minecraft 26.1.2 (Java 25), 1.21.1 (Java 21+) and 1.20.1 (Java 17+).
What the original mod does
NetMusic-BetterLogin is an add-on for the NetMusic mod, which lets you play NetEase Cloud Music (网易云音乐) inside Minecraft. The base mod's default login is cumbersome, so Better Login replaces it with convenient login methods and unlocks VIP playback for the whole server:
- QR-code login — scan a QR code with the NetEase Cloud Music mobile app and confirm on your phone.
- Email / account login — sign in with your email, phone number, or username + password.
- SMS verification-code login — receive a code on your phone and log in without a password.
- Persisted login — the session cookie is saved to a config file and automatically reapplied on every restart.
- Single sign-on, server-wide VIP — only one person (usually the server owner) needs to log in; the server then holds a VIP credential and every player can play VIP (standard / Hi-Res / Lossless) songs.
What this port changes
This version keeps all of the above features but is rebuilt for the Fabric loader.
Minecraft 26.1.2 (Java 25):
- Ported from Forge 1.20.1 to Fabric 26.1.2 (Fabric Loader ≥ 0.19.2, Java 25), depending on
net-music1.5.1+ (which ships a Fabric build by ming-sc). - Fixed QR-code rendering on Fabric 26.1 — bundled ZXing correctly as a shaded jar, used the new
RenderPipelines.GUI_TEXTUREDblit, and built theDynamicTexturedirectly from aNativeImageso the code image actually displays. - Fixed dedicated-server startup crash — split the mod into
ModInitializer(server) andClientModInitializer(client GUI) entry points, removing aNoClassDefFoundError: Screenthat broke dedicated servers.
Minecraft 1.20.1 (Java 17+):
- Ported from Forge 1.20.1 to Fabric 1.20.1 (mojmap official mappings, Java 17), depending on
net-music1.5.1-fabric+mc1.20.1. /nmbl loginimplemented as a server command + S2C packet — on Fabric a client command tree shadows server commands with the same root, so the login GUI is opened by the server sending a packet to the client (works in single-player and multiplayer).
Minecraft 1.21.1 (Java 21+):
- Ported from the NeoForge 1.21.1 branch to Fabric 1.21.1 (mojmap official mappings, Java 21), depending on
net-music1.5.1-fabric+mc1.21.1. - Modern payload networking — the S2C login trigger uses
CustomPacketPayload+StreamCodec(1.20.5+ networking).
All versions:
- Kept the single sign-on VIP sharing via a persisted cookie, with OP commands to reload / clear the cookie and view / set audio quality.
Why use it
If you run a Minecraft server with the NetMusic mod and want your players to enjoy VIP music without everyone juggling accounts, this mod lets one login cover the entire server. It also modernizes the login UI for the current Fabric generation.
Requirements
| Minecraft | Java | Required mods | Optional |
|---|---|---|---|
| 26.1.2 | Java 25 | net-music 1.5.1+ (Fabric), fabric-api, forgeconfigapiport |
cloth-config + modmenu |
| 1.21.1 | Java 21+ | net-music 1.5.1+ (Fabric 1.21.1), fabric-api |
cloth-config + modmenu |
| 1.20.1 | Java 17+ | net-music 1.5.1+ (Fabric 1.20.1), fabric-api |
cloth-config + modmenu |
forgeconfigapiportis only required on 26.1.2 becausenet-musicitself declares it as a dependency; the 1.21.1 / 1.20.1 builds ofnet-musicdo not need it.
Usage
Run /nmbl login in-game to open the login screen — the server sends a packet to your client, which opens the GUI (single-player and multiplayer).
OP commands:
/nmbl server cookie reload # reload and apply the cookie from the config file
/nmbl server cookie clear # clear the cookie
/nmbl server level # show the current audio quality level
/nmbl server level set <level> # set level: STANDARD / HIGHER / EXHIGH / LOSSLESS / HIRES
Security Notice
此模组的配置文件中存储了你的网易云 Cookie,请勿将 Cookie 泄露给他人,否则可能导致账号被盗。如账号被盗用或被封禁,本模组不承担任何责任。请务必保护好你的账号安全。
This mod stores your NetEase Cloud Music cookie in its config file. Never share your cookie with anyone — it can be used to take over your account. The mod is not responsible for any account loss or ban caused by leaked credentials. Please keep your account safe.
Credits
- Original mod: ming-sc/NetMusic-BetterLogin (Forge 1.20.1 / NeoForge 1.21.1) by IMG, MIT licensed.
- Base mod: NetMusic (net-music) by ming-sc.
- Fabric ports: Rogic460.


