Placeholders 🧩

📄 Introduction

Placeholders let you display dynamic information about teams, players and the plugin's global state in any place that supports PlaceholderAPI — chat, scoreboards, holograms, tab list, custom messages, etc.

ℹ️ Requires PlaceholderAPI to be installed on your server. xTeams registers itself automatically when PlaceholderAPI is detected.

🧩 Supported Placeholders

🌐 Global

⚙️ Placeholder	📄 Description	🔄 Returned Format
%xteams_total_teams%	Total number of registered teams.	Integer (e.g., 3)
%xteams_total_players%	Total number of distinct players that belong to at least one team.	Integer (e.g., 12)
%xteams_all_teams%	Comma-separated list of every registered team's internal name.	String (e.g., red, blue, yellow)

👤 About the player viewing the placeholder

⚙️ Placeholder	📄 Description	🔄 Returned Format
%xteams_team%	Internal name of the player's primary team (highest priority).	String or null
%xteams_team_display%	Display name of the player's primary team.	String or null
%xteams_team_priority%	Priority of the player's primary team.	Integer or null
%xteams_in_any_team%	Whether the player belongs to any team.	Boolean (true / false)
%xteams_in_team_<team>%	Whether the player belongs to a specific team.	Boolean (true / false)
%xteams_team_count%	How many teams the player belongs to.	Integer
%xteams_teams_list%	Comma-separated list of every team the player belongs to, sorted by priority (highest first).	String or none

👥 About another player (by nickname)

⚙️ Placeholder	📄 Description	🔄 Returned Format
%xteams_player_team_<player>%	Internal name of <player>'s primary team.	String or null
%xteams_player_team_display_<player>%	Display name of <player>'s primary team.	String or null
%xteams_player_team_count_<player>%	How many teams <player> belongs to.	Integer
%xteams_player_in_any_team_<player>%	Whether <player> belongs to any team.	Boolean (true / false)
%xteams_player_in_team_<player>:<team>%	Whether <player> belongs to <team>. Note the : separator between player and team.	Boolean (true / false)

🏷️ About a specific team

⚙️ Placeholder	📄 Description	🔄 Returned Format
%xteams_exists_<team>%	Whether <team> exists.	Boolean (true / false)
%xteams_display_<team>%	Display name of <team>.	String or null
%xteams_priority_<team>%	Priority of <team>.	Integer or null
%xteams_size_<team>%	Number of members in <team>.	Integer or null
%xteams_members_<team>%	Comma-separated list of <team>'s members (resolved to nicknames).	String or null

---

❓ How to use these placeholders

Drop the placeholder anywhere PlaceholderAPI processes input. xTeams replaces it with the live value at render time.

• The "player viewing" placeholders depend on a player context — they only resolve when there is one (chat messages, scoreboards bound to a player, etc.). In console contexts they return null.
• The "about another player" and "about a team" placeholders are context-free and work anywhere.

💡 Example configuration

chat-format: "%xteams_team_display% &7| &f%player_name%: %message%"
sidebar-line: "Your team: %xteams_team% (priority %xteams_team_priority%)"
admin-list: "Teams: %xteams_all_teams% — %xteams_total_players% players in total"
ally-check: "Is xDrygo in red? %xteams_player_in_team_xDrygo:red%"

🔗 Compatibility with PlaceholderAPI

If PlaceholderAPI is installed on your server, the plugin integrates with it automatically — no extra configuration is needed. Just add the placeholders wherever you want them and xTeams handles the rest.