MeloSync

MeloSync

在游戏中通过简洁的游戏内播放器直接控制你的 Spotify 音乐。

MeloSync预览查看大图

MeloSync

从 Minecraft 控制 Spotify，在你已有的设备上播放音乐，不离游戏即可看到当前播放内容。

MeloSync 是一个客户端侧 Fabric 模组，用于控制和浏览 Spotify。它使用 Spotify Connect：音频仍将通过你桌面、手机、浏览器、游戏主机或其他活跃设备上的 Spotify 播放。MeloSync 在 Minecraft 内为你提供控制功能和一个简洁的“正在播放”HUD。

需要 Spotify Premium 才能使用 Spotify 播放控制。MeloSync 不包含、不播放也不重新分发音乐文件。

游戏内 HUD 元素

快速概览

  • 控制你活跃的 Spotify Connect 设备：播放、暂停、下一首、上一首、进度跳转、随机播放、循环模式和音量。
  • 从游戏内菜单搜索曲目、专辑、艺术家和播放列表。
  • 浏览喜欢的歌曲、已保存的专辑和你的播放列表。
  • 打开某个专辑或播放列表，然后使用内置的 播放专辑 或 播放播放列表 功能。
  • 显示一个轻量、透明的“正在播放”HUD，包含封面、标题、艺术家、进度和时长。
  • 将 HUD 拖放到屏幕任意位置，并从设置面板调整菜单/HUD 颜色。
  • 使用 P 键打开 MeloSync，使用 O 键打开 HUD 编辑器。两个快捷键均可在 Minecraft 控制设置中重新绑定。

游戏内库与播放器

你的库保持在左侧，浏览和搜索区保持在右侧。底部的播放器栏提供快捷的播放、进度和音量控制，同时不会遮挡菜单的其他部分。

主菜单界面

简洁、可移动的 HUD

HUD 设计为小巧且半透明：它让你能看到当前曲目，同时不遮挡游戏画面。按 O 键，将其拖到你想要的位置，然后按 Esc 键保存位置。

游戏内 HUD 编辑器

需求

你需要 详情
Minecraft 26.1.2 或 26.2
模组加载器 Fabric Loader 0.19.3 或更新版本
依赖 Fabric API
Java Java 25 或更新版本
Spotify Spotify Premium 和你自己的 Spotify Developer 应用客户端 ID

版本支持： Minecraft 26.1.2 和 26.2 是主要发布版本。更早的 Minecraft 版本属于实验性移植，修复速度可能较慢。

快速入门

1. 安装 MeloSync 并创建其配置文件

  1. 在 CurseForge 配置文件中安装 MeloSync 和 Fabric API。
  2. 启动该 Minecraft 配置文件一次，然后返回标题画面或关闭游戏。
  3. MeloSync 会在该配置文件的 config 文件夹内创建其配置文件夹。

打开 你的 CurseForge 实例文件夹/config/melosync/spotify_app.json。

例如，文件夹路径为：C:\Users\你的用户名\curseforge\minecraft\Instances\你的整合包\config\melosync\spotify_app.json

2. 创建并配置你的 Spotify Developer 应用

  1. 打开 Spotify Developer Dashboard 并创建一个应用。
  2. 启用 Web API。
  3. 准确添加此重定向 URI：http://127.0.0.1:12589/callback
  4. 复制应用的 Client ID（客户端 ID）。

3. 将客户端 ID 粘贴到 MeloSync 中

  1. 打开步骤 1 中 MeloSync 配置文件夹里的 spotify_app.json。
  2. 将 Spotify Client ID 粘贴到 client_id 字段中。
  3. 保存文件。

仅使用客户端 ID。不要粘贴你的客户端密钥（Client Secret）。

4. 登录并播放

  1. 使用同一个 CurseForge 配置文件启动 Minecraft。
  2. 按 P 键并选择 MeloSync 的登录选项。
  3. 在浏览器中批准 Spotify 权限。
  4. 先在任意 Spotify Connect 设备上开始播放一首歌曲。
  5. 返回 Minecraft 并使用 MeloSync 控制该设备。

控制键

默认按键 功能
P 打开 MeloSync
O 打开 HUD 编辑器
Esc 保存 HUD 位置并关闭编辑器

两个快捷键均可在 Minecraft 的控制菜单中 MeloSync 部分下更改。

播放列表与专辑说明

  • 专辑会直接在菜单中加载其曲目。
  • 播放列表和已保存的专辑会保留在库面板中。
  • 某些 Spotify 播放列表可能会限制曲目列表的访问。发生这种情况时，MeloSync 会显示一条清晰的 无法加载此播放列表的歌曲 消息，但会保留 播放播放列表 功能，以便你可以在 Spotify 上启动它。

故障排除

使用播放控制时没有任何反应 在某个设备上打开 Spotify 并先播放一首歌曲。Spotify 需要有一个活跃的播放设备，远程控制才能正常工作。

client_id: 无效 请使用 Spotify Developer Dashboard 提供的 32 字符客户端 ID，而不是客户端密钥。

浏览器报告重定向 URI 不匹配 你在 Spotify Developer Dashboard 和 spotify_app.json 中的重定向 URI 必须完全一致：http://127.0.0.1:12589/callback

权限更改后播放停止工作 删除 你的 CurseForge 实例文件夹/config/melosync/spotify_tokens.json，然后按 P 键打开 MeloSync 并重新登录。

MeloSync 与 Spotify 无关。Spotify 负责账号访问、播放和 Premium 资格。