Music HUD

Enjoy music in all situations powered by Netease Cloud Music (NCM) | 基于网易云的全场景音乐模组

Автор: Etern54,8 тыс.19обновлён 17 окт. 2026 г.

ОбщениеУтилиты

Описание

Banner Home View (See more in gallery)

A GUI-based, all situations (singleplayer/multiplayers) music mod/plugin designed with zero modifications to game mechanics

Due to service scope provided by NetEase, this mod might not work well outside China

Prerequisites

ModernUI (only client, recommend to use mVUS fork on 1.21.9-11, this fork on 26.2 and 26.3)
Forge Config API Port (only Fabric)
Fabric API (only Fabric)
~~Architectury API~~ (Fabric / NeoForge, required by MusicHUD 1.2.0 and below)

Features

With graceful GUI, providing an in-game operation interface and an easily configurable HUD.
Can read NetEase Cloud Music account playlists for convenient song requests.
The server does not retain user data; it is only temporarily stored during session.
Streamed playback with no redundant client-side caching.
Staggered lyrics auto scroll inspired by Apple Music
HUD dynamic fluid background
Windows SMTC / Linux MPRIS (have not fully tested yet) support (Powered by slightly modified JMTC)
Using optimized high-quality audio pipeline based on OpenAL, supports NetEase Cloud Music's all quality options, and outputs 32-bit float audio and multichannel surround audio if device supports
Connected mode: Synchronized server-wide play queue and progress.
Isolated mode: Do all works on client, enjoy music yourself.
Sharing same playback model between connected mode and isolated mode, easy to use
Low network bandwidth / performance required for server side, audio stream downloading and processing is done on client side
Fixes MC-265514 on 1.21.1 (exists from 23w31a to 1.21.4), which worsen the audio output quality

Functions

Search for musics, playlists, albums and artists.
Favorite/Unfavorite musics, subscribe/unsubscribe playlists, albums and artists.
Vote for skipping current music
Log in to NetEase Cloud Music account via QR code or SMS code to explore subscribed playlists, albums and artists.
Scrobble your play record to NetEase Cloud Music account
Manage your NetEase Cloud Music Cloud Drive
Configure idle playback sources for automatic random song switching when music player is idle.
Display lyrics, requesting player (or avatar) in the HUD and user interface.

Compatibility

Mute Reactive Music when MusicHUD is playing
Connected mode compatible with ViaVersion
Adapted to Sound Physics Perfected, disabled its reverb applied to MusicHUD audio pipeline to improve audio quality
Compatible with Raise Sound Limit Simplified while maintaining Blaze3D audio fix on 1.21.1

TO-DO List

Customizable HUD layout [target 1.4.0]
More music platform support (QQ Music, Kugou Music or more) [target 2.0.0]

Usage

Client

Single-player or LAN Multi-player Host

All you need is to configure or deploy an API server.

Multiplayer (join Server or LAN Multi-player)

Connected mode

You don't need to configure or deploy an API server, but the server or LAN multiplayer host needs to configure or deploy MusicHUD and API server.

Isolated mode

All you need is to configure or deploy an API server.

Server

All you need is to configure or deploy an API server.

How to Deploy an API Server

Deploy bound with mod (recommend for client)

This method allows MusicHUD to manage lifecycle of api server.

Due to some limitations, API Server may not be auto-closed when game exit abnormal (e.g., due to a critical crash)

Auto Deploy

You can find "Download API..." button in setting page, which will open a download guide, and download API backend from Netease Cloud Music API Enhanced's releases with optional GH Proxy speedup

Manual Deploy

Go to https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced/releases
Download platform binary artifacts matches to your pc/server platform
Uncompress the binary executable file from ZIP file to ...
- Mod edition: {corepath}/music-hud/ and rename it to api (api.exe on Windows)
- Plugin edition: {corepath}/plugins/MusicHud/ and rename it to api (api.exe on Windows)
- Or place it anywhere and modify config in game or option serverApiBinaryExecutablePath (absolute or relative path) in config file /config/music_hud-common.toml.

Deploy separately (recommend for server)

Deploy NetEase Cloud Music API Enhanced with guide in repository.
If not using the default port (3000) of NCM API Enhanced or deploying on another server, modify the serverApiBaseUrl property in the config file /config/music_hud-server.toml.

Experimentally, there is another Rust version API server, which remains most of api endpoints same with Node.js version but is much faster. MusicHUD have adapted to it since 1.2.13. You can find binary executable files in its release page. But there are still some issues in this api server edition. So use it at your own risk.

CN version description

图形化的全场景（单人/多人游戏）音乐模组/插件，设计上不修改任何游戏机制

前置依赖

ModernUI （仅客户端，建议在 1.21.9 - 1.21.11 上使用 mVUS 分支，在 26.2、26.3 上使用该分支 (26.2 release) (26.3 release)）
Forge Config API Port （仅 Fabric）
Fabric API （仅 Fabric）
~~Architectury API~~ （Fabric / NeoForge，MusicHUD 1.2.0 以及更低版本需要）

特点

具有优雅的 GUI，提供游戏内操作界面，以及易配置的 HUD
可读取网易云账户歌单，方便点歌
服务端不保留用户数据，仅在连接会话中暂存
流式播放，无赘余的客户端缓存
受 Apple Music 启发的歌词交错滚动与逐字歌词
HUD 动态流体背景
Windows SMTC / Linux MPRIS（尚未充分测试）支持（略微修改自 JMTC）
使用优化过的 OpenAL 高质量音频管线，支持网易云的所有音质选项，在设备支持时可输出 32 位浮点音频和多声道环绕音频
连接模式：全服同步播放队列、进度
隔离模式：在客户端上独自享受音乐
连接模式/隔离模式共享同一播放模型，操作简便
服务端带宽/性能占用低，音频流下载和处理由客户端完成
在 1.21.1 上修复了一个导致了输出音频质量下降的 Bug MC-265514 (存在于 23w31a 至 1.21.4)

功能

搜索音乐、歌单、专辑和歌手
收藏/取消收藏音乐、歌单、专辑和歌手
投票跳过歌曲
通过二维码或短信验证码登录网易云账户，查看收藏的歌单、专辑和歌手
将你的播放记录同步到网易云账户
管理网易云账户云盘
配置空闲播放源，播放器空闲时随机切歌
在 HUD 和用户界面中展示歌词，点歌玩家（或头像）

兼容

在 MusicHUD 播放时静音 Reactive Music
连接模式与 ViaVersion 兼容
适配 Sound Physics Perfected, 禁用其无差别应用于 MusicHUD 音频管线的混响以保证音质
在 1.21.1 上兼容 Raise Sound Limit Simplified，同时保留了对 Blaze3D 音频管线的修复

大饼待办清单

可自定义的 HUD 布局 [目标 1.4.0]
更多音乐平台支持(QQ音乐、酷狗音乐等) [目标 2.0.0]

使用

客户端

单人模式或局域网联机主机

只需要配置/部署 API 服务器

加入服务器或加入局域网世界

连接模式

不需要配置/部署 API 服务器

但是需要服务器/局域网主机配置/部署 MusicHUD 和 API 服务器

隔离模式

只需要配置/部署 API 服务器

服务端

只需要部署 API 服务器

如何部署 API 服务器

绑定在 mod 中（推荐客户端）

这个方法会让 MusicHUD 管理 API 服务器生命周期

由于一些限制，在游戏非正常退出时（如某些严重崩溃）可能无法自动结束进程

自动部署（客户端，1.2.15+）

在设置页面中的 API 状态一栏中可找到“下载 API...”按钮，可打开一个下载指引，会从 Netease Cloud Music API Enhanced 的 release 页下载 API 后端，可选使用 GH Proxy 加速下载

手动部署

进入 Netease Cloud Music API Enhanced 的 release 页
在最新的 release 中根据你的平台下载对应的二进制构建产物
解压下载得到的压缩包并将其中的二进制可执行文件放置到...
- mod 版：{核心目录}/music-hud/ 并重命名为 api (对于 Windows 为 api.exe)
- 插件版: {核心目录}/plugins/MusicHud/api(.exe)
- 或者放在任意处并在游戏内或配置文件/config/music_hud-common.toml中修改选项 serverApiBinaryExecutablePath 对应(绝对/相对)目录

独立部署（推荐服务端）

参考 Netease Cloud Music API Enhanced 仓库内的说明部署
如果不使用 NCM API Enhanced 的默认端口 ( 3000 ) 或在其他服务器上部署，需要修改配置文件/config/music_hud-server.toml的 serverApiBaseUrl 属性

实验性地，有另一个Rust 版本的 API 服务器，保持了大部分 API 端点不变，但比 NodeJS 版本快得多。MusicHUD 已在 1.2.13 实现对其兼容。可以在它的 Release 页中找到二进制可执行文件。但它仍然有一些问题。使用前请考虑风险

Галерея

Последние версии

Все версии →

release

Music HUD 1.3.1

1.3.1

17 окт. 2026 г.50Minecraft: 1.21.1, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3velocity

Скачать

Что нового

## Client ### Improve - Overhauled lyrics animations in GUI and HUD: - - Continuous staggered spring easing in GUI and HUD - - Toggleable blur on non-highlighted lyrics in GUI - - Adjusted lyrics text size on both home view and GUI sidebar - - Improved lyric floating effect in GUI - - HUD gradient lyric highlight - HUD fade in/out when visibility changes - HUD background scaling - Improved HUD text rendering, reduced layout jitter during animations - Effect and performance of HUD background theme color extract - Lyric parser text normalization - Connection mode switch transition - Image downloading and processing - Album image temp folder management for JMTC - Supported to use gh-proxy.org's AxisNow CDN when downloading api server - Volume now will mix with “Master Volume” in "Music & Sound Options" if mix option is enabled - 1.21.1 only: Improved render pipeline alpha handling and texture rendering ### Fix - Unable to (un)subscribe artist - Idle play source loading error card display - Several concurrent issues in audio pipeline and event registration - Music stuck at end occasionally when next idle music remains same - Several minor cache, JSON and network issues - Potential NullPointerException crashes - 1.21.1 only: Fixed a potential state pollution issue ## Server ### Fix - Unable to (un)subscribe artist - Several concurrent issues in event registration - Music stuck at end occasionally when next idle music remains same - Several minor cache, JSON and network issues --- ## 客户端 ### 改进 - GUI 和 HUD 歌词动画大修： - - GUI 和 HUD 内的连续交错弹簧缓动 - - 可开关的非高亮歌词模糊 - - 调整了 GUI 中主页和侧边栏歌词字号 - - 改进了 GUI 歌词浮动效果 - - HUD 歌词渐变高亮 - HUD 切换显示时淡入淡出 - HUD 背景缩放 - HUD 背景主题色提取的效果和性能 - 改进了 HUD 文本渲染，减小了动画进行时的布局抖动 - 改进了歌词解析器文本规范化 - 连接模式切换的过渡 - 图像下载和处理 - 改进了 JMTC 使用的专辑封面临时目录处理 - 支持下载 API 服务器时使用 gh-proxy.org 的 AxisNow CDN - 在启用原版音量混合选项后，音量会和 “音乐和声音选项” 中的 “主音量” 进行混合 - 仅 1.21.1：改进了渲染管线对透明度的处理和贴图渲染 ### 修复 - 无法（取消）关注歌手 - 空闲播放源加载错误时的卡片展示 - 一些音频管线和事件注册的并发问题 - 音乐有时会在下一首空闲播放源和当前曲目相同时卡在结尾 - 修复了一些有关缓存，JSON 和网络的问题 - 修复了潜在的空指针异常崩溃问题 - 仅 1.21.1：修复了一个渲染管线可能状态泄漏的问题 ## 服务端 ### 修复 - 无法（取消）关注歌手 - 一些事件注册的并发问题 - 音乐有时会在下一首空闲播放源和当前曲目相同时卡在结尾 - 修复了一些有关缓存，JSON 和网络的问题

release

Music HUD 1.3.1

1.3.1

17 окт. 2026 г.123Minecraft: 1.21.1, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, folia, paper, purpur, spigot

Скачать

Что нового

release

Music HUD 1.3.1+26.3

1.3.1+26.3

17 окт. 2026 г.18Minecraft: 26.3neoforge

Скачать

Что нового

release

Music HUD 1.3.1+26.2

1.3.1+26.2

17 окт. 2026 г.25Minecraft: 26.2neoforge

Скачать

Что нового

release

Music HUD 1.3.1+26.1-26.1.2

1.3.1+26.1-26.1.2

17 окт. 2026 г.14Minecraft: 26.1, 26.1.1, 26.1.2neoforge

Скачать

Что нового

release

Music HUD 1.3.1+1.21.11

1.3.1+1.21.11

17 окт. 2026 г.7Minecraft: 1.21.11neoforge

Скачать

Что нового

release

Music HUD 1.3.1+1.21.9-10

1.3.1+1.21.9-10

17 окт. 2026 г.8Minecraft: 1.21.9, 1.21.10neoforge

Скачать

Что нового

release

Music HUD 1.3.1+1.21.6-8

1.3.1+1.21.6-8

17 окт. 2026 г.7Minecraft: 1.21.6, 1.21.7, 1.21.8neoforge

Скачать

Что нового

release

Music HUD 1.3.1+1.21.1

1.3.1+1.21.1

17 окт. 2026 г.50Minecraft: 1.21.1neoforge

Скачать

Что нового

release

Music HUD 1.3.1+26.3

1.3.1+26.3

17 окт. 2026 г.155Minecraft: 26.3fabric

Скачать

Что нового

Music HUD

Описание

Related Links

Prerequisites

Features

Functions

Compatibility

TO-DO List

Usage

Client

Single-player or LAN Multi-player Host

Multiplayer (join Server or LAN Multi-player)

Connected mode

Isolated mode

Server

How to Deploy an API Server

Auto Deploy

Manual Deploy

CN version description

相关链接

前置依赖

特点

功能

兼容

大饼 待办清单

使用

客户端

单人模式 或 局域网联机主机

加入服务器 或 加入局域网世界

连接模式

隔离模式

服务端

如何部署 API 服务器

自动部署（客户端，1.2.15+）

手动部署

Галерея

Последние версии

Music HUD 1.3.1

Music HUD 1.3.1

Music HUD 1.3.1+26.3

Music HUD 1.3.1+26.2

Music HUD 1.3.1+26.1-26.1.2

Music HUD 1.3.1+1.21.11

Music HUD 1.3.1+1.21.9-10

Music HUD 1.3.1+1.21.6-8

Music HUD 1.3.1+1.21.1

Music HUD 1.3.1+26.3

大饼待办清单

单人模式或局域网联机主机

加入服务器或加入局域网世界