PlaceholderAPI

Overview

mineTeams registers a PlaceholderAPI expansion when PlaceholderAPI is installed. The identifier matches the plugin name: mineTeams.

Requirements

• PlaceholderAPI 2.11.6+

PlaceholderAPI is optional — the plugin works without it, but placeholders return nothing useful.

Profile Placeholders

Require an online player context.

Placeholder	Description	Example
%mineTeams_profile_ranking%	Player ranking points	512
%mineTeams_profile_kills%	Kill count	42
%mineTeams_profile_deaths%	Death count	10
%mineTeams_profile_kda%	KDA string	4.20

Team Placeholders

Require the player to be in a team (except team_tag, which has a no-team fallback message).

Placeholder	Description	Example
%mineTeams_team_tag%	Formatted team tag (or no-team placeholder)	[ABC]
%mineTeams_team_name%	Team name	Warriors
%mineTeams_team_leader%	Leader username	Steve
%mineTeams_team_ranking%	Average member ranking	640
%mineTeams_team_online_members%	Online members count	3
%mineTeams_team_count_of_members%	Total members	8
%mineTeams_team_limit_of_members%	Member slot limit	10

Ranking Placeholders

Position is 1-based (1 = first place).

Placeholder	Description
%mineTeams_ranking_player_<n>%	Formatted top player at position n
%mineTeams_ranking_team_<n>%	Formatted top team at position n

Examples:

%mineTeams_ranking_player_1%
%mineTeams_ranking_player_2%
%mineTeams_ranking_team_1%
%mineTeams_ranking_team_10%

Formats are defined in messages.yml:

Message key	Placeholders
playerRankingPlaceholderFormat	{player}, {prefix}, {suffix}, {points}
teamRankingPlaceholderFormat	{tag}, {points}

{prefix} and {suffix} are resolved via LuckPerms when available.

Fallback Values

Situation	Result
Offline / missing profile data	messages.yml → noDataForPlaceholder
Player not in a team (team_tag)	messages.yml → noTeamTagPlaceholder
Other team placeholders without a team	noDataForPlaceholder
Invalid ranking position	noDataForPlaceholder

Usage Examples

Scoreboard

Team: %mineTeams_team_tag%
Points: %mineTeams_profile_ranking%
K/D: %mineTeams_profile_kda%

Top 3 hologram

#1 %mineTeams_ranking_player_1%
#2 %mineTeams_ranking_player_2%
#3 %mineTeams_ranking_player_3%

Team tab prefix

%mineTeams_team_tag% %player_name%