Net Music: Splayer Bridge

Net Music: SPlayer Bridge

Net Music: SPlayer Bridge is a Fabric addon for the Net Music (NetMusic) mod. It solves the issue of playing NetEase Cloud Music VIP songs in-game.

Features

• SPlayer Integration: When playing NetEase VIP songs, the server requests the unlocked CDN direct link from the locally running SPlayer, and passes it to the client. The client then streams the audio directly from the CDN. The server does not forward audio or use extra ports.
• FLAC Support: Non-MP3 formats (like FLAC) are downloaded to a local cache before playing, preventing IOException caused by stream scanning.
• Lyric Synchronization: Freezes the lyric tick until the decoder consumes about 4 seconds of audio, ensuring lyrics align perfectly with the sound.

Requirements

• Minecraft Versions: Fabric for 1.20.1 / 1.21.1 / 26.1.2
• Dependencies: NetMusic 1.5.x (Fabric)
• Installation: Both server and client must install this mod. SPlayer must be running on the server machine.

Disclaimer

This mod only bridges the unlocked results provided by SPlayer into NetMusic's playback chain. It does not include or provide any audio content. Audio copyright belongs to NetEase Cloud Music and the rights holders. This project is open-source under the MIT License.

网络音乐机：SPlayer桥 (Net Music: SPlayer Bridge)

Net Music: SPlayer Bridge 是 网络音乐机（NetMusic） 的 Fabric 附属模组，专门解决模组在播放网易云 VIP 歌曲时的取流问题。

主要功能

• SPlayer 介入：播放网易云 VIP 歌曲时，由服务端向本机运行的 SPlayer 请求解锁后的 CDN 直链，再将地址交给客户端，由客户端自行拉取音频。服务端不转发音频、不占用额外端口。
• FLAC 格式支持：客户端遇到非 MP3 格式（如 FLAC）会先下载到本地缓存再播放，解决原版流式播放扫描导致的报错问题。
• 歌词精准对齐：在音频真正开播前冻结歌词计时，等待解码器预读约 4 秒后放行，确保歌词与音频完美同步。

前置与安装要求

• 支持版本：Fabric (1.20.1 / 1.21.1 / 26.1.2)
• 前置模组：NetMusic 1.5.x (Fabric)
• 安装要求：服务端与客户端都需要安装本模组，且 SPlayer 必须运行在服务端所在的机器上。

免责声明

本模组仅将 SPlayer 已提供的解锁结果接入 NetMusic 的播放链路，不包含、也不提供任何音频内容。音频版权归网易云音乐及版权方所有，项目采用 MIT 许可证开源。