Aurora Tiers

Aurora Tiers Tags

Aurora Tiers Tags is a client-side Fabric mod that shows a player's Aurora Tiers rank directly next to their name. Ranks range from HT1 down to LT5. Each rank is displayed with the Aurora Tiers icon and its own tier colour, for example: [icon] LT3 | PlayerName

Instead of looking up rankings on the website or asking around in chat, you see at a glance how a player is ranked, in chat, in the player list and above their head.

The mod runs completely on your side. It works on any server, needs nothing installed on the server, and does not give you any gameplay advantage.

What is Aurora Tiers?

Aurora Tiers is a Minecraft PvP ranking community. Players are tested and placed into tiers, from HT1 (highest) to LT5 (lowest), and the rankings are kept in the Aurora Tiers database.

This mod brings those rankings into the game. You can recognise ranked players while you play, spectate, queue for fights or just chat, without extra tools, overlays or tabbing out to a website.

Where ranks are shown

• Chat: the rank appears in front of the sender's name in chat messages
• Player list (Tab): the rank is added in front of every ranked player's name
• Nametags: the rank appears in front of the name above other players' heads

Players without a rank are displayed exactly as before and are not changed in any way.

Chat support covers normal vanilla chat as well as the common chat formats of server plugins, where the name is followed by a ">", a "»" or a ":". If a message cannot be matched to a ranked player, it is shown unchanged.

Tier colours

Every tier has its own colour, taken from the Aurora Tiers website, and the tier text is shown in bold so it stands out next to the name.

Order from highest to lowest:
HT1, LT1, HT2, LT2, HT3, LT3, HT4, LT4, HT5, LT5

HT1 is gold, LT1 is orange, HT2 and LT2 are blue and slate, HT3 and LT3 are bronze tones, and HT4 to LT5 use cooler blue and teal shades. HT4 and LT4 are slightly brightened so they stay readable on the dark nametag background.

How it works

When the game starts, the mod downloads the current Aurora Tiers rankings and keeps them in memory. Every lookup afterwards is instant. The download runs in a separate background thread, so it never causes lag or freezes, even with a large number of ranked players.

The rankings are refreshed automatically every 5 minutes. If you want the newest data right now, use /auroratiers reload.

Players are matched by their Minecraft UUID. This means a rank always belongs to the right account, even after a name change. On servers without UUID support, such as offline-mode servers, the mod falls back to matching by username (not case sensitive).

If the rankings cannot be loaded, for example because you are offline, the mod simply shows no ranks and tries again at the next refresh. It will not crash your game or break your chat.

Privacy and safety

• Only public ranking data is read: UUID, username and tier
• The mod only downloads data. It does not send any player data, chat messages, server addresses or game data anywhere
• It only changes how names are displayed on your own screen
• It does not modify other players' data and does not interact with the server
• It does not need an account, a login or any setup

Compatibility

• Client-side only. Do not install it on the server, it is not needed there
• Works on vanilla servers, Paper and Spigot servers, networks and offline-mode servers
• Compatible with servers that use their own chat or tab list plugins, because the rank is only added on your screen
• Fully standalone, no other mod except Fabric API is required

Installation

1. Install Fabric Loader for Minecraft 1.21.4
2. Download Fabric API and put it into your mods folder
3. Download Aurora Tiers Tags and put it into the same mods folder
4. Start the game, ranks appear automatically

The config file is created on the first start. You do not have to change anything for the mod to work.

Configuration

Settings are stored in config/auroratiers.json, which is created on the first start:

• showInTab shows ranks in the player list (true / false)
• showAboveHead shows ranks above player heads (true / false)
• showInChat shows ranks in chat (true / false)
• showIcon shows or hides the Aurora Tiers icon in front of the tier (true / false)
• refreshMinutes how often the rankings are refreshed, in minutes (default 5, minimum 1)

Changes apply after /auroratiers reload or after restarting the game.

Commands

/auroratiers reload reloads the config file and downloads the rankings again

Requirements

• Minecraft 1.21.4
• Fabric Loader 0.16.0 or newer
• Fabric API
• Java 21

Supported rankings

Currently the Vanilla game mode rankings are displayed. Other game modes may be added in future updates.

FAQ

Why do I not see any ranks?
Only players who are ranked on Aurora Tiers get a tag. Make sure you are online and that Fabric API is installed. You can force a fresh download with /auroratiers reload and check your game log for lines starting with "Aurora Tiers".

Can I get banned for using this mod?
The mod only changes how text is displayed on your own screen. It does not read or send game data, does not modify packets and gives no gameplay advantage. As with any mod, the rules of the server you play on always apply.

Does it work with other mods?
Yes. It only touches the displayed names in chat, the player list and nametags. If another mod changes the same things, the rank is simply added in front.

Can I hide the icon or turn off single places?
Yes, every place and the icon can be turned off separately in config/auroratiers.json.