BeatBlocks Control

Quick rating

BeatBlocks Control

No reviews yet

Control Spotify from Minecraft — overlay, HUD, and hotkeys via a local Spicetify bridge. No API keys in the mod.

Mod Loaders
Fabric
Minecraft
Hosting Partner

Want to reach Minecraft players?

We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!

Get in touch

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.
Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Modrinth logo Modrinth

Compatibility

Supported Environments

Dev Environment
Client Required
Server Unsupported

About

Project Details

Type
Mod
License
MIT License
Authors

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

BeatBlocks Control

BeatBlocks Control is a client-side Fabric mod for Minecraft Java 1.21 – 1.21.11 that lets you control Spotify while you play — overlay, now-playing HUD, playlists, and global hotkeys. Everything runs through a local Spicetify bridge on your PC. No OAuth, no API keys, and no login inside the mod.

Features

  • In-game music control — play, pause, skip, and browse your library without alt-tabbing
  • Now-playing HUD — track, artist, and cached album art on screen
  • Enhanced overlay — playlists, albums, liked songs, and queue
  • Default overlay — settings, HUD scale, and UI mode selection
  • Global hotkeys — configurable transport and overlay keys
  • Diagnostics — bridge, extension, and heartbeat status in-game
  • Privacy-first — the mod only talks to 127.0.0.1; credentials stay in Spotify

Requirements

In Minecraft

Item Details
Minecraft Java One JAR per patch (1.21 through 1.21.11)
Fabric Loader ≥ 0.16.10
Fabric API Match your MC version (see version page)

On your PC

Item Details
Spotify desktop Must stay open while playing
Spicetify Installed and applied
beatblocks-api.js Spicetify extension from the GitHub repo

Quick setup

  1. Install Spicetify and apply it to Spotify
  2. Copy beatblocks-api.js into your Spicetify Extensions folder, then run:
spicetify config extensions beatblocks-api.js
spicetify apply

Restart Spotify after apply.

  1. Download the JAR for your exact Minecraft version and put it in mods/ with Fabric API
  2. Launch Minecraft, start playback in Spotify, press Alt+I (default) to open the overlay

Full guide: GitHub README · Website

Default controls

Change under Options → Controls → BeatBlocks

Action Default key
Open overlay Alt+I
Play / pause K
Next track L
Previous track J

You can also use /sp in chat to open the overlay.

How it works

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

The mod runs a small HTTP server on your machine. The Spicetify extension sends playback updates and receives commands. Nothing is sent to external servers except normal Spotify traffic.

Pick the right JAR

Use one JAR per Minecraft patch — do not use a 1.21.5 JAR on 1.21.11.

Examples:

  • 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

Configuration

File: .minecraft/config/beatblocks/beatblocks.json

Setting Default Description
bridgePort 50321 Local HTTP port
apiPollSeconds 4 Playback poll interval
hudScaleMultiplier 1.0 HUD size
coverPixels 256 Max cover art size
selectedMode DEFAULT DEFAULT or ENHANCED

Roadmap

Status Plan
Now Spicetify bridge — Spotify must be open with Spicetify + extension installed
Future Spotify Web API support for simpler setup (planned)

Links

License

MIT — free to use and modify. See LICENSE on GitHub.

Screenshots

Gallery

  • HUD overlay
    HUD overlay
  • Full app overlay
    Full app overlay
  • BeatBlocks Control
    BeatBlocks Control Control Spotify from inside Minecraft

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
CurseForge
Modrinth
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works