PrimeTier Tagger

Official tier display mod for PrimeTiers

---

Features

• HUD Tier Display – Displays player tiers directly above nametags.
• PrimeTiers Integration – Fetches and displays live player rankings from PrimeTiers along With Mc Tiers and Sub Tiers.
• Automatic Gamemode Detection – Automatically detects the current gamemode and displays relevant rankings.
• Player Search – View player tiers, peaks, regions, points, global rankings, and skin information.
• Multi-Gamemode Support – Supports Sword, Crystal, Netherite, Potion, Mace, UHC, Axe, SMP, and more.
• Highest Tier Detection – Automatically displays a player's highest available tier.
• Display Modes – Choose between selected gamemode, adaptive highest, or absolute highest rankings.
• Custom Layouts – Configure displayed gamemodes and their positions.
• Custom Styling – Customize icons, colors, and visual presets.
• Region Support – Displays player region information alongside rankings.
• Smart Caching – Reduces API requests with an optimized caching system.
• Real-Time Updates – Keeps ranking information up to date automatically.
• Resource Pack Compatible – Icons and textures can be customized through resource packs.
• Lightweight & Optimized – Designed for minimal performance impact.
• Configurable – Extensive customization options available through the configuration screen.

ShowCase

Requirements

• Minecraft 1.21.11
• Fabric Loader 0.16.0+
• Fabric API
• Java 21+
• Internet connection (required for PrimeTiers data retrieval)

NOTE: This mod depends Ukulib to work!

Installation

1. Download the latest release from the Releases page.
2. Install the required dependencies:
   • Fabric API
   • UkuLib
3. Place the .jar file in your .minecraft/mods folder.
4. Launch Minecraft with Fabric Loader.
5. Join a server and enjoy PrimeTiers integration.

Configuration

The mod creates a config file at .minecraft/config/primetier-tagger.toml:

enabled = true
gameMode = "sword"
showRetired = true
highestMode = "NOT_FOUND"
showIcons = true
playerList = true
retiredColor = -6105345
provider = "PRIMETIERS"

[tierColors]
HT1 = -1525190
HT3 = -483494
HT2 = -3877913
LT1 = -2772139
HT5 = -7372120
HT4 = -8293222
LT3 = -3769534
LT2 = -6248526
LT5 = -10134663
LT4 = -10134663

Minecraft version support

• Currently supported versions: 1.21+ through 1.21.11

Future version support: once Mojang switches to the new versioning system next year, the last 4 minor releases will be supported. During the transition phase (until 26.4), 1.21.1 and 1.21.11 will remain supported.

API Integration

• This mod integrates with the PrimeTiers API to fetch real-time player rankings, tiers, regions, and gamemode statistics.

• Data is retrieved automatically and cached locally to reduce API requests while keeping information up to date.

License

Copyright © 2026 PrimeTiers

All Rights Reserved.

This software is proprietary and closed-source. You may download and use this mod for personal use only.

You may not:

• Redistribute this mod
• Modify or decompile this mod for redistribution
• Reupload this mod to other websites
• Use any assets or source code without permission

For permissions or inquiries, contact the PrimeTiers Team.

Contact & Support

• Promotions, Partnerships & Sponsorships – Join the PrimeTiers Discord: https://discord.gg/kWRHVzq3k2
• Mod Development & Minecraft Services – https://discord.gg/XyGUN6SEGq
• Website Development, APIs & Custom Projects – https://discord.gg/c8cECQKSC3

Credits

• PrimeTiers Team – PrimeTiers integration, API, ranking system, and tier data
• Tiers Mod – Inspiration for HUD display, player lookup features, and gamemode icon systems
• UkuLib by uku – Utility library used by this mod
• Fabric API – Fabric modding framework
• All Contributors – Testing, feedback, and development support

---