Stylish Battle Ranks

---

Stylish Battle Ranks is a client-side Minecraft 1.20.1 mod that adds a style rank system and dynamic battle music that reacts to how well you fight.

The mod tracks your combat actions, awards or removes style points, raises or lowers your rank from D to SSS, displays everything in the HUD, and can change the active music segment in real time based on your current combat rank.

Main Features

• style ranks: D, C, B, A, S, SS, SSS
• style point gain for different combat actions
• penalties for taking damage and making mistakes
• reduced rewards for repeating the same action too often
• HUD with a large animated rank letter and visual effects
• action popups showing what you did and how many points you gained or lost
• battle result popup after combat ends
• dynamic music with rank-based segment transitions
• fullscreen track selection GUI
• search, preview, timeline scrubbing, and metadata display
• support for ogg, flac, and mp3
• track loading from both config folders and resource packs
• support for embedded audio metadata such as title, artist, album, and artwork

How the Music Works

If a track has a metadata file, the mod can use it as a map of rank segments and control points.

This allows the mod to:

• start the track from the segment that matches your current rank
• switch music at control points
• move the track up or down together with your rank
• prevent the track from progressing beyond a rank segment if you have not earned the next rank yet

Because of that, the music feels like part of the combat system instead of just background audio.

Track Selector

The mod includes a fullscreen track selector where you can:

• browse all discovered tracks
• search by name, selector, artist, album, and source
• view the source of each track
• see embedded artwork
• view duration and audio metadata
• preview tracks directly in the menu
• seek through the preview timeline
• inspect rank metadata if it exists
• choose your active battle track without editing config files manually

Resource Pack Support

Stylish Battle Ranks can load music and metadata not only from config folders, but also from resource packs.

This is useful for:

• modpacks
• themed music sets
• custom battle soundtrack packs
• replacing the mod's content without touching local config files

Client-Side First

The mod is designed primarily as a client-side experience.

That means it can be used:

• in singleplayer
• in local worlds
• on vanilla servers

Its core functionality runs on the client and does not require the mod to be installed on the server.

Who It Is For

Stylish Battle Ranks is for players who want to:

• make PvE combat feel more stylish and reactive
• feel progression during a fight in real time
• add a dramatic action-game atmosphere to Minecraft
• use their own music tracks with a rank-based system
• get a combat experience inspired by stylish action games

You can use this mod in any modpack.