🪜Placeholders

Available placeholders

Placeholder	Description
%simpleclans_name%	Displays the clan members name, returns name.
%simpleclans_clean_name%	Displays the clan members name in all Lowercase, returns name.
%simpleclans_is_muted%	Has the clan member muted the clan chat? Related to /. mute. Returns yes or no.
%simpleclans_is_mutedally%	Has the clan member muted ally chat? Related to /ally mute. Returns yes or no.
%simpleclans_in_clan%	Is the player in a clan? Returns yes or no.
%simpleclans_join_date%	Displays the date the clan member joined the clan. Returns Month, Day, Year, Hour.
%simpleclans_lastseen%	Displays when a clan member was last logged into server Returns Month, Day, Year, Hour, or if active returns Online.
%simpleclans_lastseendays%	Displays when a clan member was last logged into server, returns number or Today if active the same day.
%simpleclans_inactive_days%	Displays how many days a clan member has not been active, returns number
%simpleclans_is_member%	Is the clan member a standard member of the clan? Returns yes or no.
%simpleclans_is_trusted%	Is this clan member a trusted member of the clan? Returns yes or no.
%simpleclans_is_leader%	Is the clan member the leader of the clan? Returns yes or no.
%simpleclans_is_invite_enabled%	Is the clan member can be invited to other clans? Returns yes or no.
%simpleclans_rank%	Displays the clan members current Rank, returns name of the rank.
%simpleclans_has_rank%	Does the clan member have any rank? Returns: yes or no.
%simpleclans_rank_displayname%	Displays the clan members current Rank displayname, related to /clan rank setdisplayname, returns custom display name of the rank
%simpleclans_neutral_kills%	Total kills of players in clans that are not a ally or rival clan, returns number.
%simpleclans_rival_kills%	Total kills of players that are in a Rival clan, returns number.
%simpleclans_civilian_kills%	Total kills of players that are not in a clan, returns number.
%simpleclans_ally_kills%	Total kills of players that are in a allied clan, returns number.
%simpleclans_total_kills%	Total kills in all, civilians, rivals, allies and neutrals, returns number.
%simpleclans_weighted_kills%	Displays the clan members weighted kill points, this is based off set points for each type of kill, see Config for settings, returns number.
%simpleclans_deaths%	Total times the clan member has died, returns number.
%simpleclans_kdr%	Kill Death Ratio, the balance between clan members Kills and Deaths, returns number.
%simpleclans_is_bb_enabled%	Bulletin board toggle. Related to /clan toggle command. Returns yes or no.
%simpleclans_is_tag_enabled%	Clan tag toggle. Related to /clan toggle command. Returns `yes` or no.
%simpleclans_is_friendlyfire_on%	Has the clan member got Friendly Fire Enabled. Related to /clan ff. Returns yes or no.
%simpleclans_tag%	Returns the clans Tag in lowercase and unformatted.
%simpleclans_tag_label%	Returns the clan Tag with correct mayus, color and at the end &c relates to /clan modtag
%simpleclans_clanchat_player_color%	Gives other plugins Clan chat colors as set in config. Returns &c format Link: Clan Chat
%simpleclans_allychat_player_color%	Gives other plugins Ally chat colors as set in config. Returns &c format Link: Ally Chat
%simpleclans_clan_total_neutral%	Total kills of players in clans that are not a ally or rival clan, by all clan members, returns number.
%simpleclans_clan_total_civilian%	Total kills of players that are not in a clan, by all clan members, returns number.
%simpleclans_clan_total_rival%	Total kills of players that are in a Rival clan, by all clan members, returns number.
%simpleclans_clan_total_ally%	Total kills of players that are in a Allied clan, by all clan members, returns number.
%simpleclans_clan_total_kills%	Total kills in all, civilians, rivals, allies and neutrals, by all clan members, returns number.
%simpleclans_clan_total_deaths%	Total times all clan members have died, combined, returns number.
%simpleclans_clan_total_kdr%	Kill Death Ratio, the balance between clan members Kills and Deaths, combined, returns number.
%simpleclans_clan_average_wk%	Displays the clan members weighted kill points, this is based off set points for each type of kill, combined, see Config for settings, returns number. Link: Kill Weights
%simpleclans_clan_leader_size%	Displays how many leaders the clan has, returns number.
%simpleclans_clan_balance%	Displays the current balance of the clan using the economy system, returns number.
%simpleclans_clan_balance_formatted%	Displays the formatted by economy plugin clan's balance
%simpleclans_clan_allow_withdraw%	Can clan members withdraw currency from the clan bank. Related to ranks. Returns yes or no. Link: Ranks with Permissions
%simpleclans_clan_allow_deposit%	Can clan members deposit currency from the clan bank. Related to ranks. Returns yes or no. Link: Ranks with Permissions
%simpleclans_clan_size%	Displays the amount of current clan members in the clan, returns number.
%simpleclans_clan_name%	Displays the clan name, returns name.
%simpleclans_clan_color_tag%	Returns the clan Tag with correct mayus, color and at the end &c relates to /clan modtag
%simpleclans_clan_tag%	Returns the clans Tag in lowercase and unformatted.
%simpleclans_clan_founded%	Displays the date the clan was created. Related to settings.date-time-pattern config option. Returns Month, Day, Year, Hour.
%simpleclans_clan_friendly_fire%	Has the clan member got Friendly Fire Enabled, relates to /clan globalff, returns yes/no.
%simpleclans_clan_is_unrivable%	Displays if the clan can be rivalled, Related to settings.unrivable-clans config option. Returns yes or no. Link: General Settings
%simpleclans_clan_is_anyonline%	Displays if any members of the clan are online. Returns yes or no.
%simpleclans_clan_is_verified%	Displays if the clan has Verified Status. Returns yes or no. Link: Verified Clan
%simpleclans_clan_inactivedays%	Displays how many days no clan members have been active, returns number.
%simpleclans_clan_onlinemembers_count%	Displays how many clan members are currently online, returns number.
%simpleclans_clan_allies_count%	Displays how many other clans the clan is allied with, returns number.
%simpleclans_clan_rivals_count%	Displays how many other clans the clan is rivalled with, returns number.
%simpleclans_clan_is_permanent%	Displays if the clan is permanent and protected from auto delete. Returns yes or no. Link: Permanent clan

Top Clans Placeholders

The top clans is a group of placeholders that helps you create leaderboards. You can put _topclans_#_ in any existing clan placeholder to get the value for the clan in a specific rank position. Ex.: %simpleclans_topclans_1_clan_name% - this will return the name of the Clan in the first position.

Top Players Placeholders

This one is another group of placeholders to create leaderboards. As the name suggests, it's about players and not clans, but they work similarly. Adding _topplayers_#_ to existing player placeholders will get the value for the Player in the specified rank. Ex.: %simpleclans_topplayers_2_tag_label% - this will return the tag label for the Player in the second position.

Relational placeholders

Relational placeholders return values based on the relation between 2 players. One example is the tab, there is the player viewing it and the players listed there Currently the only relational placeholder available on SimpleClans is: %rel_simpleclans_color% This returns a color based on rivalries/alliances. Allies: aqua Rivals: red Same clan: green

The colors above can be changed in PlaceholderAPI's config.

Example

belowname-objective:

enabled: true

clan: "%rel_simpleclans_color%%simpleclans_tag%"

This will add the clans tag below the players name, to members of your clan the tag will show green, to members of allied clans the tag will show aqua, to members of rivalled clans tag will show red, same for when your clan members see allies and rivals.

HolographicDisplays

If you intend to use these placeholders with HolographicDisplays, remember to download the extension.