Placeholders
Every ExyliaClans placeholder for scoreboards, TAB, chat and holograms: the player's clan, DTR, the online roster, leaderboards and the relational colours.
Use these in any plugin that reads PlaceholderAPI (scoreboards, TAB, chat formats, holograms). They need PlaceholderAPI installed. Click a row to copy it.
Nothing here resolves to an empty string. A player with no clan answers with the placeholders.none text from messages.yml ({muted}None by default), and an empty roster slot or an unranked clan answers with placeholders.na ({muted}N/A). Change them there and every placeholder follows. Colours are handed out as legacy codes, so a TAB line or hologram shows the colour instead of {muted}.
The player's clan#
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_has_clan% | true if the player is in a clan. | true |
%exyliaclans_clan_name% | The clan's name, or the "none" text when the player has no clan. | Vanguard |
%exyliaclans_clan_display% | The name as /clan style draws it, with colours scoreboards and tab lists understand. The plain name if the clan has no style. | Vanguard |
%exyliaclans_clan_id% | The clan's internal id. | vanguard |
%exyliaclans_clan_members% | Members in the clan. | 12 |
%exyliaclans_clan_online% | Members online, on any linked server. | 5 |
%exyliaclans_clan_max_members% | The member cap, level bonus and extra slots included. | 30 |
%exyliaclans_clan_balance% | The clan bank, formatted. | 1,250 |
%exyliaclans_clan_role% | The viewer's rank name, or the "none" text. | Officer |
%exyliaclans_clan_is_leader% | true if the viewer leads the clan. | true |
%exyliaclans_clan_ff% | true if friendly fire is on. | false |
%exyliaclans_clan_allies% | Number of allied clans. | 2 |
%exyliaclans_clan_mail_unread% | Unread clan mails for the viewer. | 3 |
Stats and levels#
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_clan_kills% | The clan's kills. | 240 |
%exyliaclans_clan_deaths% | The clan's deaths. | 180 |
%exyliaclans_clan_kdr% | The clan's kill/death ratio, two decimals. | 1.33 |
%exyliaclans_clan_playtime% | The clan's total playtime, formatted. | 3d 4h |
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_clan_level% | The clan's level. A player with no clan reads 1. | 4 |
%exyliaclans_clan_exp% | The clan's current EXP. | 1500 |
%exyliaclans_clan_exp_next% | EXP needed for the next level. | 2500 |
Across the alliance#
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_clan_allies_total_members% | Members summed over every allied clan. | 30 |
%exyliaclans_clan_allies_total_online% | Of those, how many are online. | 8 |
%exyliaclans_clan_allies_total_max_members% | Their member caps summed. | 60 |
DTR#
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_clan_dtr% | Current DTR, two decimals. | 3.50 |
%exyliaclans_clan_dtr_max% | The clan's maximum DTR. | 5.00 |
%exyliaclans_clan_dtr_state% | NORMAL, FROZEN, REGENERATING or RAIDABLE. | NORMAL |
%exyliaclans_clan_dtr_color% | The colour configured for the current DTR state. | &a |
%exyliaclans_clan_raidable% | true while the clan is raidable. | false |
For example, a coloured DTR bar: %exyliaclans_clan_dtr_color%%exyliaclans_clan_dtr%/%exyliaclans_clan_dtr_max%. See DTR.
The online roster#
Up to thirty slots each, sorted by rank weight (heaviest first), then by name. Replace <n> with the slot, from 1 to 30. A slot nobody fills shows placeholders.na. Online counts the whole network when servers are linked with Redis. The roster is rebuilt at most once a second, so a scoreboard that asks four times a second costs one rebuild.
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_clan_online_member_<n>% | Name of the n-th online clan member (1 to 30), heaviest rank first. N/A text when the slot is empty. | Steve |
%exyliaclans_clan_online_member_<n>_role% | That member's rank name. | Officer |
%exyliaclans_clan_online_member_<n>_kills% | That member's kills in the clan. | 42 |
%exyliaclans_clan_online_member_<n>_deaths% | That member's deaths in the clan. | 30 |
%exyliaclans_clan_online_member_<n>_kdr% | That member's KDR, two decimals. | 1.40 |
%exyliaclans_clan_online_ally_<n>% | Name of the n-th online allied player (1 to 30). | Alex |
%exyliaclans_clan_online_ally_<n>_role% | That ally's rank name. | Member |
%exyliaclans_clan_online_ally_<n>_kills% | That ally's kills in their clan. | 10 |
%exyliaclans_clan_online_ally_<n>_deaths% | That ally's deaths in their clan. | 8 |
%exyliaclans_clan_online_ally_<n>_kdr% | That ally's KDR, two decimals. | 1.25 |
%exyliaclans_clan_online_ally_<n>_clan% | Which allied clan that player belongs to. | Nova |
Leaderboards#
<stat> is one of online, members, kills, deaths, kdr, playtime or balance. Anything unranked shows placeholders.na.
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_clan_leaderboard_rank_<stat>% | Where the viewer's clan sits in a ranking. <stat> is online, members, kills, deaths, kdr, playtime or balance. | 3 |
%exyliaclans_clan_leaderboard_top_<n>_<stat>% | Name of the clan at position n of a ranking. | Vanguard |
%exyliaclans_clan_leaderboard_top_value_<n>_<stat>% | The value of the clan at position n, formatted. | 1,250 |
Relational#
These need a viewer and a target, so they belong in nametags and TAB sorting, where one player is drawn to another. They use the %rel_...% form.
| Placeholder | Shows | Example |
|---|---|---|
%rel_exyliaclans_player_type% | How the viewer regards the other player: member, ally, enemy or none, worded by messages.yml. | ALLY |
%rel_exyliaclans_player_color% | The colour for that relation, from config.yml. | &b |
%rel_exyliaclans_player_priority% | For sorting: 5 own leader, 4 clanmate, 3 allied leader, 2 ally, 1 rival, 0 stranger. | 4 |
The labels come from messages.yml (relations.member, ally, enemy, none) and follow the language; the colours come from config.yml:
relational-placeholders:
color-member: "&a"
color-ally: "&b"
color-enemy: "&c"
color-none: "&7"Clan wars and global#
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_war_wins% | The viewer's clan war wins. | 4 |
%exyliaclans_war_losses% | Its war losses. | 2 |
%exyliaclans_war_draws% | Its war draws. | 1 |
%exyliaclans_war_in_war% | true while the viewer is in a war. | false |
| Placeholder | Shows | Example |
|---|---|---|
%exyliaclans_total_clans% | Clans on the server. | 24 |
See Clan wars.
Formats and fallbacks#
Every placeholder accepts the shared format and fallback syntax:
%exyliaclans_clan_balance:comma% 1,250,000
%exyliaclans_clan_kills:compact% 12.4k
%exyliaclans_clan_ff:yesno% Yes
%exyliaclans_clan_name|No clan% fallback when there is no valueFormats: comma, compact (or short), percent, upper, lower, yesno, time, fixed1, fixed2.
This is deliberate: a typo shows as %exyliaclans_clan_nmae% instead of a blank, and the console reports the name once. If a line looks wrong, check the console first.
Something missing on this page? Tell us on Discord