BeatBlocks 控制

BeatBlocks 控制

从Minecraft控制Spotify — 通过本地Spicetify桥接的覆盖层、HUD和热键。模组中无需API密钥。

游戏机制

BeatBlocks 控制预览查看大图

BeatBlocks Control

BeatBlocks Control 是一个客户端侧 Fabric 模组，适用于 Minecraft Java 版 1.21 – 1.21.11，让你在游玩时控制 Spotify — 包括叠加层、正在播放 HUD、播放列表和全局快捷键。所有功能均通过你 PC 上的本地 Spicetify 桥接运行。无需 OAuth、无需 API 密钥，也无需在模组内登录。

特性

  • 游戏内音乐控制 — 无需切出游戏即可播放、暂停、跳过和浏览你的音乐库
  • 正在播放 HUD — 在屏幕上显示曲目、艺术家和缓存的专辑封面
  • 增强叠加层 — 播放列表、专辑、喜欢的歌曲和队列
  • 默认叠加层 — 设置、HUD 缩放和 UI 模式选择
  • 全局快捷键 — 可配置的传输和叠加层按键
  • 诊断 — 游戏内显示桥接、扩展和心跳状态
  • 隐私优先 — 模组仅与 127.0.0.1 通信；凭据保留在 Spotify 中

需求

在 Minecraft 中

项目 详情
Minecraft Java 版 每个补丁对应一个 JAR（1.21 到 1.21.11）
Fabric Loader ≥ 0.16.10
Fabric API 匹配你的 MC 版本（参见版本页面）

在你的 PC 上

项目 详情
Spotify 桌面版 游玩时必须保持运行
Spicetify 已安装并应用
beatblocks-api.js 来自 GitHub 仓库 的 Spicetify 扩展

快速设置

  1. 安装 Spicetify 并将其应用到 Spotify
  2. 将 beatblocks-api.js 复制到你的 Spicetify Extensions 文件夹，然后运行：
spicetify config extensions beatblocks-api.js
spicetify apply

应用后重启 Spotify。

  1. 下载与你 Minecraft 精确版本匹配的 JAR，并将其与 Fabric API 一起放入 mods/ 文件夹
  2. 启动 Minecraft，在 Spotify 开始播放，按 Alt+I（默认）打开叠加层

完整指南： GitHub README · 网站

默认控制

在 选项 → 控制 → BeatBlocks 下修改

操作 默认按键
打开叠加层 Alt+I
播放 / 暂停 K
下一曲 L
上一曲 J

你也可以在聊天中使用 /sp 打开叠加层。

工作原理

Minecraft 模组 → localhost:50321 → beatblocks-api.js → Spicetify → Spotify

模组在你的机器上运行一个小型 HTTP 服务器。Spicetify 扩展发送播放状态更新并接收命令。除了正常的 Spotify 流量外，没有内容发送到外部服务器。

选择正确的 JAR

每个 Minecraft 补丁使用一个 JAR — 不要将 1.21.5 的 JAR 用于 1.21.11。

示例：

  • Minecraft 1.21 → beatblocks-control-mc-1.21.jar + Fabric API 0.102.0+1.21
  • Minecraft 1.21.5 → beatblocks-control-mc-1.21.5.jar + Fabric API 0.128.2+1.21.5
  • Minecraft 1.21.11 → beatblocks-control-mc-1.21.11.jar + Fabric API 0.141.4+1.21.11

配置

文件：.minecraft/config/beatblocks/beatblocks.json

设置 默认值 描述
bridgePort 50321 本地 HTTP 端口
apiPollSeconds 4 播放状态轮询间隔
hudScaleMultiplier 1.0 HUD 尺寸
coverPixels 256 最大封面艺术尺寸
selectedMode DEFAULT DEFAULT 或 ENHANCED

路线图

状态 计划
当前 Spicetify 桥接 — 必须打开 Spotify 并安装 Spicetify + 扩展
未来 Spotify Web API 支持，实现更简单的设置（已计划）

链接

许可证

MIT — 自由使用和修改。参见 GitHub 上的 LICENSE。