Content generated with AI — it may contain mistakes.

ExyliaClans/ReferenceUpdated in v1.4.0

Placeholders

Every ExyliaClans placeholder for scoreboards, TAB, chat and holograms: the player's clan, DTR, the online roster, leaderboards and the relational colours.

Page 18 of 292 min read

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#

PlaceholderShowsExample
%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#

PlaceholderShowsExample
%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
PlaceholderShowsExample
%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#

PlaceholderShowsExample
%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#

PlaceholderShowsExample
%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.

PlaceholderShowsExample
%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.

PlaceholderShowsExample
%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.

PlaceholderShowsExample
%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:

yaml
relational-placeholders:
  color-member: "&a"
  color-ally: "&b"
  color-enemy: "&c"
  color-none: "&7"

Clan wars and global#

PlaceholderShowsExample
%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
PlaceholderShowsExample
%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 value

Formats: comma, compact (or short), percent, upper, lower, yesno, time, fixed1, fixed2.

A placeholder nobody answers stays on screen

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