音乐界面 曲织

MusicHud TuneWeave — CurseForge 版

这是功能受限的 CurseForge 版。 不包含 TuneWeave 下载和更新功能。如需完整功能，我们推荐使用 GitHub 上的标准版本，或项目在 Modrinth 发布后使用该平台版本。音乐播放、歌词、HUD 和共享队列仍然可用。

MusicHud TuneWeave 添加了游戏内音乐浏览器、播放控制、同步歌词和可配置的 HUD。你可以独自播放，也可以与使用兼容客户端及受支持服务器或代理插件的其他玩家加入共享队列。

这是 Ephern / Etern 的 MusicHud 的独立维护分支。它将音乐提供商集成分离到 TuneWeave，使用自己的模组标识和数据路径，并包含对共享播放、队列协调以及服务器/代理集成的改动。它保留了上游署名，并以 LGPL-3.0 分发。

安装

请安装与你的 Minecraft 版本和加载器对应的文件，以及其必需的依赖项。Fabric 需要 Fabric API 和相应的 ModernUI 构建版本。大多数受支持的 ModernUI Fabric 构建版本还需要 Forge Config API Port；本项目的 26.2 ModernUI 分支则不需要。NeoForge 需要对应的 ModernUI 构建版本。切勿将此模组与上游 MusicHud 或另一个版本的 MusicHud TuneWeave 一同安装。

在世界中按 M 键打开音乐界面。搜索音乐、将曲目添加到队列，或使用受支持的播放列表作为空闲播放源。歌词、账户功能以及可用音质取决于音乐服务和用户自身的访问权限。

本地音乐服务

CurseForge 版通过其文件版本中的 -cf 标识。它不包含 TuneWeave 下载器或更新器，也不捆绑 TuneWeave 可执行文件。

用户需单独安装 TuneWeave。在设置中，选择一个已安装的可执行文件并选择启动或重启它，或输入你独立运行的服务地址。新配置的可执行文件路径为空，且自动启动处于禁用状态。用户可明确选择在未来的游戏启动时启用自动启动；切换版本时，现有的用户配置会保留。

当模组启动所配置的可执行文件时，它会直接调用该文件，而不通过 shell 命令。它将 TuneWeave 配置为监听回环接口。日志和 TuneWeave 数据存储在所选可执行文件旁。模组可以停止它所拥有的子进程。音频播放和系统媒体集成使用捆绑的原生库；这些库与 TuneWeave 可执行文件是分开的。

多人游戏

玩家需要客户端模组及其依赖项。独立 Paper 服务器使用 Paper 插件。Velocity 和 BungeeCord 网络仅需在代理端安装匹配的插件，任何后端均无需副本。这些插件负责协调公共播放，不运行 TuneWeave，也不存储音乐平台登录凭据。

支持与开发

请将可复现的问题连同 Minecraft、加载器、模组和 TuneWeave 版本报告到链接的问题追踪器。分享日志前请先移除其中的凭据。本项目由 MOPELotus 维护。

中文说明

这是功能有所精简的 CurseForge 专版，移除了 TuneWeave 下载和更新功能。推荐需要完整功能的用户使用 GitHub 上的普通版；Modrinth 项目发布后也会提供普通版。音乐播放、歌词、HUD 和共享队列仍可使用。

用户需要自行准备 TuneWeave，在设置中填写本地程序路径后启动，或连接已经运行的服务。新配置默认关闭自动启动，程序路径为空。普通版与 CF 版使用同一模组标识和协议，请只安装其中一种。