G1axTierlistPlaceholderExpansion

PlaceholderAPI expansion that displays MCTiers tier rankings as colored prefixes in Minecraft.

Features

• All MCTiers gamemodes — Vanilla, Sword, UHC, Pot, NethOP, SMP, Axe, Mace
• Accurate tier colors — Matching MCTiers official hex codes
• Retired player support — Shows retired status with distinct light blue color
• Peak tier tracking — Display a player's highest achieved tier
• Region, points & overall ranking
• Custom icons — Resource pack Unicode character support per tier
• Async & cached — Non-blocking API calls with configurable cache
• Fully configurable — Colors, icons, and cache duration from config.yml
• Hot-reload — /g1axtier reload without restart

Placeholders

Replace <gamemode> with: vanilla, sword, uhc, pot, nethop, smp, axe, mace

Placeholder	Description
%g1ax_tier_<gamemode>%	Colored tier name (shows RETIRED if retired)
%g1ax_tier_<gamemode>_raw%	Plain tier name
%g1ax_tier_<gamemode>_color%	Hex color code
%g1ax_tier_<gamemode>_icon%	Custom icon character
%g1ax_tier_<gamemode>_formatted%	Bracketed colored [HT3]
%g1ax_retired_<gamemode>%	true / false
%g1ax_peak_<gamemode>%	Colored peak tier
%g1ax_peak_<gamemode>_raw%	Plain peak tier
%g1ax_peak_<gamemode>_color%	Peak tier hex
%g1ax_region%	Player region (EU, NA, etc.)
%g1ax_points%	MCTiers points
%g1ax_overall%	Overall ranking (#1, #5)

Tier Colors

Tier	Hex
HT1	#E8BA3A
LT1	#D5B355
HT2	#C4D3E7
LT2	#A0A7B2
HT3	#F89F5A
LT3	#C67842
HT4	#B1749A
LT4	#655879
HT5	#8F82A8
LT5	#655879
Retired	#A2D6FF

All colors configurable in config.yml.

Requirements

• Paper/Spigot 1.20+
• PlaceholderAPI

Installation

1. Download the JAR from releases
2. Drop into plugins/
3. Restart server
4. Edit plugins/G1axTierlistPlaceholderExpansion/config.yml if needed

API

Uses MCTiers API v2

Support

• 🌐 anupambuilds.store/contact
• 💬 DM on Discord