网络音乐机：更好的登录FA

网络音乐机：更好的登录FA

网易云音乐的更好登录体验，移植至Fabric 26.1.2。

杂项

Net Music: Better Login — Fabric 26.1.2 移植版

这是 ming-sc/NetMusic-BetterLogin 的 Fabric 移植版（原版为 Forge 1.20.1 构建），为 Minecraft 26.1.2 上的 NetMusic (net-music) 模组带来更好的登录支持。

原模组的功能

NetMusic-BetterLogin 是 NetMusic 模组的扩展插件，该模组允许你在 Minecraft 中播放网易云音乐。原版模组的默认登录方式较为繁琐，Better Login 用便捷的登录方式取而代之，并为整个服务器解锁 VIP 播放权限：

  • 二维码登录 — 使用网易云音乐手机应用扫描二维码，并在手机上确认。
  • 邮箱 / 账号登录 — 使用邮箱、手机号或用户名 + 密码登录。
  • 短信验证码登录 — 在手机上接收验证码，无需密码即可登录。
  • 持久化登录 — 会话 Cookie 会保存到配置文件中，并在每次重启时自动重新应用。
  • 单点登录，全服 VIP — 只需一人（通常是服务器所有者）登录，服务器便会持有 VIP 凭证，所有玩家都能播放 VIP（标准 / Hi-Res / 无损）歌曲。

此移植版的改动

此版本保留了上述所有功能，但针对 Fabric 加载器和全新的 Minecraft 26.1.2（Java 25）环境进行了重建：

  • 从 Forge 1.20.1 移植到 Fabric 26.1.2（Fabric Loader ≥ 0.19.2，Java 25），依赖 net-music 1.5.1+（该版本现已由 ming-sc 提供 Fabric 构建）。
  • 修复了 Fabric 26.1 上的二维码渲染问题 — 正确地将 ZXing 打包为 shaded jar，使用新的 RenderPipelines.GUI_TEXTURED blit，并直接从 NativeImage 构建 DynamicTexture，使得验证码图片能够正常显示。
  • 修复了专用服务器启动崩溃问题 — 将模组拆分为 ModInitializer（服务端）和 ClientModInitializer（客户端 GUI）入口点，消除了导致专用服务器崩溃的 NoClassDefFoundError: Screen 错误。
  • 保留了通过持久化 Cookie 实现的单点登录 VIP 共享，并提供了 OP 命令来重新加载 / 清除 Cookie，以及查看 / 设置音频质量。

为何使用

如果你运行着一个装有 NetMusic 模组的 Minecraft 服务器，并希望玩家无需各自管理账号就能享受 VIP 音乐，这个模组可以让一次登录覆盖整个服务器。它还为当前 Fabric / MC 26.1.2 时代现代化了登录界面。

环境要求

  • Minecraft 26.1.2，Fabric Loader ≥ 0.19.2，Java 25
  • net-music 1.5.1+（Fabric），fabric-api，forgeconfigapiport
  • 可选：cloth-config + modmenu 用于游戏内配置界面

使用方法

在游戏中运行 /nmbl login 打开登录界面。OP 命令：/nmbl server cookie reload|clear，/nmbl server level [set ]。

致谢