截图
介绍
（更多内容请见画廊）
一款基于 GUI、适用于各种场景（单人游戏/多人游戏）的音乐模组/插件，不会对游戏机制做任何改动
由于网易提供的服务范围有限，此模组在中国境外可能无法正常运行
相关链接
第三方旧版 Bukkit 插件（1.0.5 稳定版及更早版本）
前置要求
- ModernUI（仅客户端；建议在 1.21.9-11 使用mVUS 分支，在 26.2 和 26.3 使用此分支）
- Forge Config API Port（仅 Fabric 需要）
- Fabric API（仅 Fabric 需要）
Architectury API（Fabric / NeoForge；MusicHUD 1.2.0 及更早版本需要）
功能特色
- 界面优雅，提供游戏内操作界面和易于配置的 HUD。
- 可读取网易云音乐账号的歌单，方便点歌。
- 服务器不会保留用户数据；数据仅在会话期间临时存储。
- 采用流式播放，不会在客户端进行多余缓存。
- 受 Apple Music 启发的错落式歌词自动滚动
- HUD 动态流体背景
- 支持 Windows SMTC / Linux MPRIS（尚未完全测试）（由略经修改的 JMTC 提供支持）
- 使用基于 OpenAL 优化的高品质音频处理管线，支持网易云音乐的所有音质选项；如果设备支持，还可输出 32 位浮点音频和多声道环绕音频
- 联机模式：同步全服播放队列和播放进度。
- 独立模式：所有操作均在客户端进行，独自享受音乐。
- 联机模式和独立模式共用同一套播放模型，简单易用
- 服务端对网络带宽和性能的要求较低；音频流的下载和处理均在客户端完成
- 修复了 1.21.1 中降低音频输出质量的 MC-265514（该问题存在于 23w31a 至 1.21.4）
功能
- 搜索音乐、播放列表、专辑和艺人。
- 收藏/取消收藏音乐，订阅/取消订阅播放列表、专辑和艺人。
- 为跳过当前音乐投票
- 通过二维码或短信验证码登录网易云音乐账号，浏览已订阅的播放列表、专辑和艺人。
- 将播放记录同步到网易云音乐账号
- 管理网易云音乐云盘
- 配置闲置播放来源，以便音乐播放器闲置时自动随机切歌。
- 在 HUD 和用户界面中显示歌词、点歌者（或头像）。
兼容性
- MusicHUD 播放时静音 Reactive Music
- 联机模式兼容 ViaVersion
- 适配 Sound Physics Perfected，禁用其对 MusicHUD 音频管线应用的混响，以提升音质
- 兼容 Raise Sound Limit Simplified，同时保留 1.21.1 上的 Blaze3D 音频修复
待办事项
- 可自定义 HUD 布局 [目标版本 1.4.0]
- 支持更多音乐平台（QQ 音乐、酷狗音乐等）[目标版本 2.0.0]
使用方法
客户端
单人游戏或局域网多人游戏主机
只需配置或部署一个 API 服务器。
多人游戏（加入服务器或局域网多人游戏）
联机模式
你无需配置或部署 API 服务器，但服务器或局域网多人游戏主机需要配置或部署 MusicHUD 和 API 服务器。
隔离模式
只需配置或部署一个 API 服务器。
服务器
只需配置或部署一个 API 服务器。
如何部署 API 服务器
与模组绑定部署（推荐客户端使用）
此方法可让 MusicHUD 管理 API 服务器的生命周期。
由于某些限制，游戏异常退出时（例如发生严重崩溃）API 服务器可能不会自动关闭。
自动部署
你可以在设置页面找到“Download API…”按钮，点击后会打开下载指南；然后可从Netease Cloud Music API Enhanced 的发布页面下载 API 后端，并可选择使用 GH Proxy 加速
手动部署
- 前往 https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced/releases
- 下载与你的电脑/服务器平台匹配的平台二进制文件
- 将 ZIP 文件中的二进制可执行文件解压到……
- 模组版：
{corepath}/music-hud/，并将其重命名为api（Windows 上为api.exe） - 插件版：
{corepath}/plugins/MusicHud/，并将其重命名为api（Windows 上为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 端点大多与 Node.js 版本相同，但速度快得多。自 1.2.13 起，MusicHUD 已适配该版本。你可以在其发布页面找到二进制可执行文件。不过，此版本的 API 服务器仍存在一些问题，使用风险自负。
中文版说明
图形化的全场景（单人/多人游戏）音乐模组/插件，设计上不修改任何游戏机制
相关链接
第三方旧 Bukkit 插件实现 (1.0.5 stable -)
前置依赖
- ModernUI （仅客户端，建议在 1.21.9 – 1.21.11 上使用 mVUS 分支，在 26.2、26.3 上使用该分支 (26.2 版本) (26.3 版本)）
- 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 服务器
将 API 服务器绑定在模组中（推荐客户端）
这种方法会让 MusicHUD 管理 API 服务器的生命周期
由于一些限制，游戏异常退出时（例如发生某些严重崩溃），可能无法自动结束进程
自动部署（客户端，1.2.15+）
在设置页面中的 API 状态一栏中可找到“下载 API…”按钮，可打开一个下载指引，会从 Netease Cloud Music API Enhanced 的发行版页面 下载 API 后端，可选使用 GH Proxy 加速下载
手动部署
- 进入 Netease Cloud Music API Enhanced 的发行版页面
- 在最新的发行版中根据你的平台下载对应的二进制构建产物
- 解压下载得到的压缩包并将其中的二进制可执行文件放置到…
- 模组版：{核心目录}/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 实现对其兼容。可以在它的发行版页面中找到二进制可执行文件。但它仍然有一些问题。使用前请考虑风险
常见问题
Music HUD 支持哪些 Minecraft 版本？
Music HUD 支持 Minecraft Java 版 1.21.1–26.3，共 12 个版本，可用的加载器：Bukkit / Fabric / Folia / NeoForge / Paper / Purpur / Spigot / Velocity。下载时注意选择和你游戏版本一致的文件。
Music HUD 怎么安装？
先用 PCL2 或 HMCL 启动器安装对应版本的 Bukkit / Fabric / Folia / NeoForge / Paper / Purpur / Spigot / Velocity，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名 下面。运行环境：客户端和服务端都要装。
评论
登录后评论和评分