MusicHud TuneWeave Sync

Shared music queues and synchronized listening for players using the MusicHud TuneWeave client mod, with dedicated plugins for Paper, Velocity and BungeeCord.

What the plugin does

MusicHud TuneWeave Sync coordinates public playback state, song requests, shared queues, skip votes and client participation. On a proxy network, the proxy continues coordinating the shared session as players move between backend servers.

Players need the matching MusicHud TuneWeave client mod. Music browsing, sound playback, the HUD and lyrics are provided by the client. Installing this plugin alone does not add a music interface or music playback to an unmodified Minecraft client.

Choose your server or proxy

Select the file matching your actual host. The Paper file requires Paper; it does not claim compatibility with plain Bukkit or Spigot. Velocity and BungeeCord files run on their respective proxies.

On a proxy network, install this plugin only on the proxy. Do not install it on any backend server. Proxy/backend double installation is detected and conflicting connections are rejected. A standalone Paper server uses the Paper plugin directly.

Requirements

• A supported server or proxy and a Java runtime compatible with that host. The plugins target Java 21 bytecode; your host may require a newer Java version. The Paper API baseline is 1.21.1.
• Each participating player needs the MusicHud TuneWeave Fabric or NeoForge client for their Minecraft version, together with its ModernUI dependencies. Fabric clients also need Fabric API. Follow the client mod's version-specific dependency list.
• Use matching MusicHud TuneWeave client and plugin release versions. Standard and CF clients of the same base release use the same protocol.

The server and proxy do not need ModernUI or a TuneWeave installation. Music-provider access is handled by the client's TuneWeave service. The plugin does not download or start TuneWeave and does not store music-platform passwords, cookies or tokens.

Installation and use

1. Stop your server or proxy, place the matching plugin JAR in the location listed above, then start the host.
2. Install the matching client mod and its dependencies on participating players' game instances. Configure the client music service as described in the client setup guide.
3. Join the server and press M to open the client music interface. Request songs for the shared queue; the default . key votes to skip. Players can use Right Shift to switch to client isolation mode for independent playback. These are the default client key bindings and can be changed in Minecraft's controls.

Available music, lyrics, account features and audio quality depend on TuneWeave, the music provider and the user's account permissions.

Credits and support

This plugin is part of MusicHud TuneWeave, an independent fork of MusicHud by Ephern / Etern, maintained by MOPELotus under LGPL-3.0. The fork separates music-provider integration into TuneWeave and adds its own client protocol and server/proxy coordination. Upstream attribution and third-party notices are retained.

Development is human-led, with AI assistance in implementation, testing, review and documentation.

Deployment guide · Client setup and dependencies · Plugin source · Report an issue

When reporting an issue, include the server or proxy type and version, Java version, client and plugin versions, and reproduction steps. Remove private credentials from any shared logs.

中文说明

MusicHud TuneWeave Sync 是 MusicHud TuneWeave 的服务端/代理插件，负责公共播放状态、共享队列、点歌、切歌投票和参与客户端的同步。群组服中的玩家切换后端时，仍由代理协调同一个公共播放会话。

玩家需要安装匹配的 MusicHud TuneWeave 客户端模组及其前置。 音乐界面、声音播放、HUD 和歌词由客户端提供；仅安装插件不能让原版客户端获得这些功能。

• 独立 Paper 服务器：安装 Paper JAR 到该服务器的 plugins 目录。
• Velocity 群组服：只安装 Velocity JAR 到代理的 plugins 目录。
• BungeeCord 群组服：只安装 BungeeCord JAR 到代理的 plugins 目录。
• 群组服的所有后端都不要安装本插件。代理和后端双装会被检测，并导致冲突连接被拒绝。

插件采用 Java 21 字节码，实际 Java 版本还须满足宿主要求。Paper 文件要求 Paper，API 基线为 1.21.1。服务器和代理无需 ModernUI，不下载或启动 TuneWeave，也不保存音乐平台账号凭据。

客户端与插件使用匹配的发行版本；同一基础版本的普通版与 CF 客户端均可使用。进服后按 M 打开客户端界面，默认 . 键投票切歌，右 Shift 切换客户端隔离模式。项目由 MOPELotus 维护，保留 MusicHud 上游署名并按 LGPL-3.0 发布。