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

1. Install Fabric Loader for Minecraft 1.21.x from https://fabricmc.net/use/
2. Download the latest Fabric API from https://modrinth.com/mod/fabric-api
3. 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/
4. Launch Minecraft with the Fabric profile

Lunar Client

1. 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/
2. Launch Lunar Client with Minecraft 1.21.x
3. 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

1. Ensure the mod is enabled in settings
2. Verify the player is registered on MC Leaderboards (https://mcleaderboards.org)
3. Check your internet connection
4. Try clearing the ratings cache in settings

Mod not loading

1. Verify you have the correct Minecraft version (1.21.x)
2. Ensure Fabric Loader and Fabric API are installed
3. Check the game log for errors
4. Confirm the mod file is in the correct mods folder

Search not working

1. Ensure the player exists on MC Leaderboards
2. Check that you're using the exact Minecraft username
3. Verify your internet connection
4. Clear the ratings cache and try again

Building from Source

Prerequisites

• Java Development Kit (JDK) 21 or higher
• Git

Build Instructions

1. Clone the repository:

   git clone https://github.com/your-repo/mc-leaderboards-tier-tagger.git
   cd mc-leaderboards-tier-tagger
   

2. Build the mod:

   ./gradlew clean build
   

   On Windows:

   .\gradlew.bat clean build
   

3. The compiled JAR will be located in:

   build/libs/mcleaderboardstiertagger-1.0.0+mc1.21.11.jar
   

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:

• MC Leaderboards: https://mcleaderboards.org
• Support Page: https://mcleaderboards.org/support

Credits

• Original TierTagger by uku and netiyiy
• MC Leaderboards integration and modifications by MC Leaderboards Team
• MC Leaderboards: https://mcleaderboards.org

License

This mod is licensed under the Mozilla Public License 2.0 (MPL-2.0).

See the LICENSE file for details.

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.)