BharatCore PlaceholderAPI Reference

BharatCore registers native PlaceholderAPI expansions using the %bharatcore_<placeholder>% syntax. These placeholders can be used inside TAB configs, DeluxeMenus, chat formatters, and scoreboards.

---

1. 🎨 Cosmetics & Chat Placeholders

These placeholders retrieve cosmetic choices, equipped tags, and formatted name components.

Placeholder	Output Type	Description & Example Output
%bharatcore_equipped_color%	String	Raw MiniMessage tag of equipped chat color (e.g. <gradient:#ff0000:#ffff00>).
%bharatcore_equipped_color_id%	String	Internal ID of equipped chat color (e.g. crimson_flame or None).
%bharatcore_equipped_namecolor%	String	Equipped name color prefix tag.
%bharatcore_equipped_tag%	String	Formatted chat tag with brackets (e.g. &8[&b#168&8]).
%bharatcore_tag%	String	Raw internal ID of the equipped tag (e.g. veteran).
%bharatcore_colored_name%	String	Player name combined with active nickname and namecolor.
%bharatcore_player_name%	String	Alias for %bharatcore_colored_name%.
%bharatcore_player%	String	Alias for %bharatcore_colored_name%.

---

2. ⚔️ Player Profile & Combat Statistics

Data tracked from player kill/death records and server playtime.

Placeholder	Output Type	Description & Example Output
%bharatcore_kills%	Integer	Total player kills (e.g. 42).
%bharatcore_deaths%	Integer	Total player deaths (e.g. 12).
%bharatcore_kd%	Decimal	Kill/Death ratio rounded to two decimals (e.g. 3.50).
%bharatcore_kdr%	Decimal	Alias for %bharatcore_kd%.
%bharatcore_playtime%	Integer	Total online time in raw seconds (e.g. 86400).
%bharatcore_playtime_formatted%	String	Human-readable playtime (e.g. 24h 15m).
%bharatcore_combat_tagged%	Boolean	Returns true if player is currently tagged in combat.
%bharatcore_combat_time_left%	Integer	Seconds remaining on active combat cooldown.

---

3. 💰 Economy & Tokens Placeholders

Direct hooks into the internal economy and special tokens.

Placeholder	Output Type	Description & Example Output
%bharatcore_money%	Decimal	Raw balance without formatting (e.g. 1500250.50).
%bharatcore_balance%	Decimal	Alias for %bharatcore_money%.
%bharatcore_money_formatted%	String	Formatted economy string with metric abbreviations (e.g. $1.5M).
%bharatcore_balance_formatted%	String	Alias for %bharatcore_money_formatted%.
%bharatcore_shards%	Integer	Formatted count of seasonal event shards.
%bharatcore_shards_raw%	Integer	Raw numerical balance of shards.
%bharatcore_coins%	Integer	Cosmetic coin currency balance.

---

4. 🛡️ Teams & Clans Placeholders

Displays information regarding the player's active team or clan.

Placeholder	Output Type	Description & Example Output
%bharatcore_team_name%	String	Name of the player's clan or team (e.g. ShadowWarriors).
%bharatcore_team_tag%	String	Short formatted tag of the team (e.g. &c[SHD]).
%bharatcore_team_level%	Integer	Current unlocked progression level of the team (e.g. 5).
%bharatcore_team_members_online%	Integer	Number of team members currently online on the network.
%bharatcore_team_bank%	String	Formatted balance stored in team clan bank.

---

5. 🏠 Homes, AFK & Staff States

Placeholders for tablist and custom scoreboards.

Placeholder	Output Type	Description & Example Output
%bharatcore_homes_count%	Integer	Number of homes currently created by the player.
%bharatcore_homes_max%	Integer	Maximum homes allowed for player's permission tier.
%bharatcore_is_afk%	Boolean	Returns true if player is AFK; otherwise false.
%bharatcore_is_vanished%	Boolean	Returns true if player is in staff vanish mode.
%bharatcore_ping%	Integer	Real-time network latency in milliseconds.