Blockify Mod
-1976d2?style=flat-square)
Fork of the original Blockify — overlays your Spotify playback on the Minecraft HUD: track title, artist, album art, progress bar, and volume.
Requirements
- Minecraft 26.1.2 with Fabric Loader 0.19.2+ and Fabric API
- Java 25 or newer
- MidnightLib 1.9.3+ (for the in-game config screen)
- A Spotify Premium account (the Web API endpoints used for playback control are Premium-only)
How to use
Press Play/Pause once to open the Spotify authorization page in your browser. Blockify runs a temporary local server on port 8001 to receive the OAuth callback; tokens are stored in config/blockifyTokens.json.
Default key bindings
| Action | Key |
|---|---|
| Play/Pause (or Authorize on first run) | Num 5 |
| Previous Song | Num 4 |
| Next Song | Num 6 |
| Save current track to your library | L |
| Force Update | Num 8 |
| Hide Blockify HUD | Num 9 |
| Increase Volume | Num + |
| Decrease Volume | Num - |
| Toggle In-Game Music | Num 1 |
All bindings can be remapped from the standard Minecraft Controls screen under the Blockify category.
Commands
/sharetrack— sends a link to the currently playing track into chat (visible only to you).
Configuration
Open the in-game config screen via Mod Menu → Blockify. Available options include HUD scale, position, anchor corner, album-art toggle, custom colors for title/artist/time/progress bar/background, background transparency, in-game music volume, and volume step.
Screenshots
Building from source
./gradlew build # build the mod JAR (output in build/libs/)
./gradlew runClient # launch a dev Minecraft client with the modContributing
Contributions are greatly appreciated.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Localisation
Translations are managed through Crowdin — please don't open PRs that hardcode translated strings.
How to Install Blockify (Mod)
Blockify by erruqie is verified for Fabric, Quilt across Minecraft versions 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.2, 1.20.6 (latest release: 1.3.0-alpha, file size: 97 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.2, 1.20.6) and platform (Fabric, Quilt).
- Make sure you have the compatible loader or environment installed for Fabric, Quilt.
- Move the downloaded Blockify file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version
- Migrate from Yarn to Mojang official mappings (Minecraft 26.1.2 ships unobfuscated)
- Update Loom plugin (net.fabricmc.fabric-loom 1.16-SNAPSHOT), Gradle 9.5.1, Java 25
- Replace InGameHud mixin with Fabric HudElementRegistry
- Move all client logic from BlockifyMain into BlockifyClient (no main entrypoint)
- Migrate API: Minecraft, Component, KeyMapping, GuiGraphicsExtractor, FormattedCharSequence, etc.
- Drop RenderUtil (album art now drawn via GuiGraphicsExtractor.blit)
- Bump fabric-api 0.149.0+26.1.2, midnightlib 1.9.3+26.1-fabric, loader 0.19.2
Bug fixes carried in:
- Fix matrix stack leak when HUD hidden (push without matching pop)
- Guard volume controls against null hudInfo[6] before parseInt
- Fix OAuth callback URL parsing (handled '=' in code, multiple params)
- Fix typo </body? -> </body> in auth success page
- Remove infinite recursion on 'Connection reset' in put/post/addTrack
- Properly terminate Spotify polling thread on InterruptedException
- updated to 1.21.3
- album cover may be too dark
- save track by button (
Lby default)
- Updated for 1.20.6
- Updated fabric, midnightlib
- Fixed spam logging
- Removed join message
- Tokens file moved
- auto-hide blockify hud when debug is opened
- updated for 1.19.2
- Implemented a button for toggling in-game music
- Updated for 1.19
- target compatibility reduced to java 16
- fixed crash on 1.18.2
- Added the ability to hide the album art
- Localization files will be downloaded when the mod is launched
- Implemented Volume Step configuration
- Updated localisations
- Implemented Volume Control
- Added Russian localisation
- Implemented '/sharetrack' command
- Fixed updating track information after switching it
- Add config based on MidnightLib (Scale, Anchor, Position X, Position Y, Title Color, Artist Color, Time Color, Progressbar Color, Background Color, Background Transparency)
- Unified version
