TierTagger Plugin

A Minecraft plugin for displaying player tiers from MCTiers (Non Brazilian Tierslist) and South Tiers API (Brazilian Tierlist) with advanced caching, multilanguage support, and PlaceholderAPI integration

Features

• Dual API Support: Compatible with both MCTiers and South Tiers API
• Caching: Efficient local caching system to reduce API calls
• Multi-language Support: English (en_us) and Portuguese (pt_br) language files
• PlaceholderAPI Integration: Extensive placeholder support for other plugins, like TAB
• Configurable Display: Customizable tier colors with gradient support
• Permission System: Customizable permission settings, useful for LuckPerms
• Realtime Updates: Automatic tier fetching and display on player join

Installation

1. Download the latest release from the releases page
2. Place the JAR file in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/TierTagger/config.yml
5. Do /tt reload to restart the configuration file

Configurations

API Configuration

api:
  provider: MCTIERS  # MCTIERS or SOUTH_TIERS
  default_gamemode: vanilla
  timeout: 10
  cache_duration: 30

Display Configuration

display:
  enabled: true
  format: "{tier} | {player}"
  show_in_tablist: true
  show_in_chat: true

Language Configuration

language: en_us  # en_us or pt_br

Colors Configuration

tier_colors:
  ht1:
    start: "#FF0000" # Start = start color of the gradient
    end: "#A60000" # End = end color of the gradient
  lt1:
    start: "#FF3200"
    end: "#FF5E37"
  ht2:
    start: "#C4FF00"
    end: "#8DB800"
  lt2:
    start: "#0DFF00"
    end: "#08A800"
  ht3:
    start: "#FFE200"
    end: "#CCB500"
  lt3:
    start: "#00FFAB"
    end: "#00BAA9"
  ht4:
    start: "#00B2FF"
    end: "#0074A6"
  lt4:
    start: "#5500FF"
    end: "#3B00B0"
  ht5:
    start: "#D47410"
    end: "#AD6214"
  lt5:
    start: "#916231"
    end: "#704518"

Commands

• /tier <player> - Check a player tier information
• /display - Toggle tier display for yourself
• /tieroff - Toggle tier system globally (Admin only)
• /tierhide - Toggle your tier for everyone
• /tiertagger reload - Reload plugin configuration

Permissions

• tiertagger.reload - Allows reloading plugin configuration
• tiertagger.tiersearch - Allows searching for player tiers
• tiertagger.display - Allows toggling tier display for yourself (you dont see people tier)
• tiertagger.tierhide - Allows toggling your tier display for everyone (they dont see your tier)
• tiertagger.admin - Administrative permissions for TierTagger

PlaceholderAPI Placeholders

General Placeholders

• %tiertagger_tier% - Player best tier
• %tiertagger_tier_formatted% - Player best tier with formatting
• %tiertagger_points% - Player total points
• %tiertagger_overall% - Player overall rank
• %tiertagger_region% - Player region

Gamemode Specific Placeholders

• %tiertagger_vanilla% - Vanilla tier
• %tiertagger_sword% - Sword tier
• %tiertagger_pot% - Pot tier
• %tiertagger_uhc% - UHC tier
• %tiertagger_axe% - Axe tier
• %tiertagger_nethop% - Netherite OP tier
• %tiertagger_mace% - Mace tier
• %tiertagger_smp% - SMP tier
• %tiertagger_crystal% - Crystal tier

Tier Specific Placeholders

• %tiertagger_ht1% - Returns "HT1" if player has High Tier 1
• %tiertagger_lt1% - Returns "LT1" if player has Low Tier 1
• And so on for all other tiers (HT2, LT2, HT3, LT3, HT4, LT4, HT5, LT5)

API Support

MCTiers API

• Uses UUID-based lookups
• Supports all gamemodes (vanilla, sword, pot, uhc, axe, nethop, mace, smp)
• Provides detailed statistics including points, overall rank, and region

South Tiers API

• Uses Cracked-based lookups
• Primarily supports Crystal gamemode only

Requirements

• Java 17 or higher
• Minecraft Server 1.21.1+
• Paper/Spigot server
• PlaceholderAPI (optional)