RankForge PlaceholderAPI Placeholders (%rankforge_*%)

RankForge registers two parallel namespaces with PlaceholderAPI:

• %rankforge_*% — Primary modern identifier
• %tierpvp_*% — Legacy alias preserving backward compatibility

Both namespaces return identical values.

Player Placeholders

Placeholder	Type	Example	Description
%rankforge_points%	Integer	1500	Current points. Recommended for ajLeaderboards.
%rankforge_kills%	Integer	42	Total lifetime kills.
%rankforge_deaths%	Integer	10	Total lifetime deaths.
%rankforge_kd%	Decimal	4.20	Kill/Death ratio (2 decimal places). Equals kill count if deaths = 0.
%rankforge_daily_kills%	Integer	5	Kills recorded today.
%rankforge_rank%	Text	✦ HT1 ✦	Formatted tier name (with colors / gradients).
%rankforge_rank_plain%	Text	HT1	Raw plain text tier name (no color codes).
%rankforge_rank_id%	Text	ht_1	Tier ID configured in config.yml.
%rankforge_next%	Integer / MAX	250	Points remaining to achieve next tier.
%rankforge_next_tier_min%	Integer / MAX	1750	Minimum score of the next tier.
%rankforge_tier_min%	Integer	1000	Minimum score threshold of current tier.

Unranked Players

Placeholder	Output
%rankforge_rank%, %rankforge_rank_plain%	Unranked
%rankforge_rank_id%	none
%rankforge_tier_min%	0

Top Leaderboard Placeholders

Designed for holograms, signs, and global scoreboards:

Placeholder	Description
%rankforge_top_name_<1-10>%	Player name at leaderboard position
%rankforge_top_points_<1-10>%	Points of player at position
%rankforge_top_rank_<1-10>%	Formatted tier of player at position
%rankforge_top_kills_<1-10>%	Total kills of player at position

Empty slots display --- for names, 0 for numeric values, and Unranked for rank.

Testing Placeholders

/papi parse me %rankforge_points%
/papi parse me %rankforge_rank%