MC Leaderboards Tier Tagger
A Minecraft Fabric mod that displays player ratings from MC Leaderboards above their nametags in-game.
Overview
MC Leaderboards Tier Tagger integrates with the MC Leaderboards API to show real-time player ratings directly in Minecraft. When you see another player in-game, their rating for your selected gamemode will appear above their name, color-coded by skill level.
Features
- Real-time rating display on player nametags
- Support for all MC Leaderboards gamemodes (Overall, Vanilla, SMP, Sword, Pot, UHC, Axe, Netherite OP, Mace)
- Customizable gamemode icons
- Tab list integration
- Player search functionality
- Automatic rating caching (5 minutes)
- Rating-based color system
- Peak rating display
Requirements
- Minecraft 1.21.x
- Fabric Loader 0.17 or higher
- Fabric API
- Java 21 or higher
Installation
Standard Fabric Client
- Install Fabric Loader for Minecraft 1.21.x from https://fabricmc.net/use/
- Download the latest Fabric API from https://modrinth.com/mod/fabric-api
- Place both
fabric-api.jar and mcleaderboardstiertagger-1.0.0+mc1.21.11.jar in your mods folder:
- Windows:
%appdata%\.minecraft\mods\
- macOS:
~/Library/Application Support/minecraft/mods/
- Linux:
~/.minecraft/mods/
- Launch Minecraft with the Fabric profile
Lunar Client
- Place
mcleaderboardstiertagger-1.0.0+mc1.21.11.jar in your Lunar Client mods folder:
- Windows:
%userprofile%\.lunarclient\offline\multiver\mods\
- macOS:
~/Library/Application Support/lunarclient/offline/multiver/mods/
- Linux:
~/.lunarclient/offline/multiver/mods/
- Launch Lunar Client with Minecraft 1.21.x
- Ensure Fabric mods are enabled in Lunar Client settings
Usage
In-Game Display
Once installed, player ratings will automatically appear above their nametags. The format is:
[Icon] [Rating] PlayerName
Example: ★ 1650 PlayerName
Configuration
Open the mod settings through the Minecraft controls menu or by pressing the configured keybind (default: unbound).
Available Settings:
- Enabled - Toggle rating display on/off
- Gamemode - Select which gamemode rating to display
- Show Highest Rating - Fallback behavior when a player has no rating in the selected gamemode
- Never: Only show selected gamemode
- When Not Found: Show highest rating if selected gamemode not available
- Always: Always show highest rating regardless of selection
- Show Gamemode Icons - Toggle gamemode icons on/off
- Show Ratings in Player List - Display ratings in the tab list
- Clear Ratings Cache - Force refresh all cached player data
- Search Player - Look up a specific player's ratings
Commands
/tiertagger <player>
Displays all available ratings for the specified player.
Keybindings
- Cycle between gamemodes - Quickly switch which gamemode rating is displayed (default: unbound)
Configure keybindings in Minecraft Options > Controls > MC Leaderboards Tier Tagger
Rating Colors
Ratings are color-coded based on skill level:
- 2000+ - Gold
- 1800-1999 - Pink
- 1600-1799 - Light Blue
- 1400-1599 - Light Green
- 1200-1399 - White
- 1000-1199 - Light Gray
- Below 1000 - Gray
API Integration
This mod uses the MC Leaderboards public API:
Endpoint: https://mcleaderboards.org/api/players/username/{username}
Caching: Player data is cached for 5 minutes to reduce API load. Use "Clear Ratings Cache" in settings to force refresh.
Troubleshooting
Ratings not appearing
- Ensure the mod is enabled in settings
- Verify the player is registered on MC Leaderboards (https://mcleaderboards.org)
- Check your internet connection
- Try clearing the ratings cache in settings
Mod not loading
- Verify you have the correct Minecraft version (1.21.x)
- Ensure Fabric Loader and Fabric API are installed
- Check the game log for errors
- Confirm the mod file is in the correct mods folder
Search not working
- Ensure the player exists on MC Leaderboards
- Check that you're using the exact Minecraft username
- Verify your internet connection
- Clear the ratings cache and try again
Configuration File
The mod stores its configuration in:
- Windows:
%appdata%\.minecraft\config\tier-tagger.json
- macOS:
~/Library/Application Support/minecraft/config/tier-tagger.json
- Linux:
~/.minecraft/config/tier-tagger.json
You can manually edit this file to change settings, though using the in-game menu is recommended.
Privacy
This mod makes API requests to MC Leaderboards servers to fetch player ratings. Only Minecraft usernames are transmitted. No personal information or gameplay data is collected or stored by the mod.
Support
For issues, questions, or feature requests:
Credits
- Original TierTagger by uku and netiyiy
- MC Leaderboards integration and modifications by MC Leaderboards Team
- MC Leaderboards: https://mcleaderboards.org
Changelog
Version 1.0.0+mc1.21.11
- Initial release for MC Leaderboards
- Integrated with MC Leaderboards API
- Rating-based display system
- Support for all MC Leaderboards gamemodes
- Dynamic rating color system
- Username-based player lookup
- Automatic rating caching
- Compatible with all Minecraft 1.21.x versions (1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, etc.)
