README.md

Blockify Mod

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 mod

Contributing

Contributions are greatly appreciated.

1. Fork the project
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Localisation

Translations are managed through Crowdin — please don't open PRs that hardcode translated strings.