Placeholders

Kingdoms supports its own placeholders without needing a placeholder plugin. It supports PlaceholderAPI & MVdWPlaceholderAPI. You don't need to download the expansion from Papi ecloud, they're internally implemented into the plugin. The plugin's internal placeholder system is much more optimized than any other placeholder plugin, so it's technically better if you don't install these plugins when you don't need to use them.

Some of these placeholders have a default value in special cases which is accessed from config.yml -> default-placeholders
For example %kingdoms_name% will return the default value of the player is not in a kingdom. Or %kingdoms_territory% will return the default value if the land is not owned by any kingdom.

Short & Fancy Placeholders

Kingdoms has a very unique feature for showing number placeholders. These features can also be used via PlaceholderAPI.

Short Placeholders

A short placeholder is a number placeholder that is shortened with number suffixes for big numbers to fit in small messages.
To display a number placeholder as a short placeholder, you have to use short after %kingdoms_ So the proper format would be %kingdoms_short_<placeholder>%

Fancy Placeholders

A fancy placeholder is a number placeholder that is formatted with the currency format ###.00.
To display a number placeholder as a fancy placeholder, you have to use fancy after %kingdoms_ So the proper format would be %kingdoms_fancy_<placeholder>%

Examples:

Short Placeholder	Fancy Placeholder	Value	Short Output	Fancy Output
%kingdoms_short_members%	%kingdoms_fancy_members%	130	130	130
%kingdoms_short_bank%	%kingdoms_fancy_bank%	12330.34	12.3K	12,330.34
%kingdoms_short_nation_kingdoms%	%kingdoms_fancy_nation_kingdoms%	42345234	42.3M	42,345,234

---

Placeholders

If you don't have a kingdom, all the text (string) placeholder will output an empty text (no spaces) and all the number placeholders will give 0 with a few exceptions.

Players

Placeholder	Description
%kingdoms_chat_channel%	Your current chat channel name.
%kingdoms_joined%	The time that you joined your kingdom.
%kingdoms_resource_points%	Your kingdom's resource points.
%kingdoms_last_donation_time%	Last time you donated resource points to your kingdom. This is changed by the option in config.yml -> resource-points -> last-donation-duration
%kingdoms_last_donation_amount%	The total donations you made during your last donation time.
%kingdoms_total_donations%	Your total resource points donations to your kingdom.
%kingdoms_tax%	The amount of money you have to pay to your kingdom.
%kingdoms_territory%	The kingdom name of the current player land, otherwise the default value.
%kingdoms_claims%	Amount of claims the kingdom has. This number can be higher than %kingdoms_claims% in various situations.
%kingdoms_max_claims%	Maximum amount of claims a kingdom can have.
%kingdoms_power%	Your power amount.
%kingdoms_rank_node%	Your kingdom's rank node.
%kingdoms_rank_name%	Your kingdom's rank name.
%kingdoms_rank_color%	Your kingdom's rank color.
%kingdoms_rank_symbol%	Your kingdom's rank symbol.
%kingdoms_rank_priority%	Your kingdom's rank priority. 0 is king and the maximum number is the member rank.
%kingdoms_rank_max_claims%	Maximum amount of lands your rank can claim in your kingdom.
%kingdoms_nation_rank_node%	Your nation's rank node.
%kingdoms_nation_rank_name%	Your nation's rank name.
%kingdoms_nation_rank_color%	Your nation's rank color.
%kingdoms_nation_rank_symbol%	Your nation's rank symbol.
%kingdoms_nation_rank_priority%	Your nation's rank priority. 0 is king and the maximum number is the member rank.
%kingdoms_map_width%	Your /k map width which is customizable.
%kingdoms_map_height%	Your /k map height which is customizable.

---

Kingdoms

Placeholder	Description
%kingdoms_name%	Your kingdom name.
%kingdoms_lore%	Your kingdom lore that can be set and removed using /k lore
%kingdoms_tag%	Your kingdom tag that can be set and removed using /k tag
%kingdoms_members%	Your kingdom members count.
%kingdoms_max_members%	Your kingdom max members count.
%kingdoms_online_members%	Your kingdom online members count.
%kingdoms_offline_members%	Your kingdom offline members count.
%kingdoms_flag%	Kingdom flag URL for Dynmap.
%kingdoms_color%	Kingdom HTML hex color code.
%kingdoms_king%	Your kingdom king name.
%kingdoms_might%	Your kingdom might count.
%kingdoms_since%	The date your kingdom was created in year-month-day format.
%kingdoms_home%	Your kingdom home location.
%kingdoms_nexus%	Your kingdom nexus location.
%kingdoms_lands%	Your kingdom land count.
%kingdoms_kingdom_power%	Your kingdom's total power.
%kingdoms_max_lands%	Kingdom max land count.
%kingdoms_shield_since%	Time that you activated your kingdom shield.
%kingdoms_shield_time%	Your kingdom shield duration.
%kingdoms_shield_time_left%	Kingdom shield time left.
%kingdoms_bank%	Kingdom bank money.
%kingdoms_ranks%	Kingdom rank count.
%kingdoms_pacifist%	true if pacifism mode is enabled for this kingdom, otherwise false.
%kingdoms_max_lands_modifier%	Extra lands that are given to the kingdom by admins from the /k admin maxLandModifier command.
%kingdoms_server_kingdom_tax%	The amount of money your kingdom has to pay to server for taxes.
%kingdoms_nation_tax%	The amount of money your kingdom has to pay to your nation for taxes.
%kingdoms_kingdom_tax%	The amount of money your kingdom has to pay for taxes. This is the same as %kingdoms_server_kingdom_tax% if the kingdom is not in a nation, or %kingdoms_nation_tax% if the kingdom is in a nation.

---

Nations

Placeholder	Description
%kingdoms_nation%	Your kingdom's nation name.
%kingdoms_nation_kingdoms%	The amount of kingdoms that are in your nation.
%kingdoms_nation_spawn%	Your kingdom's nation spawn location.
%kingdoms_nation_bank%	Kingdom bank money balance.
%kingdoms_nation_since%	The date your nation was created in year-month-day format.
%kingdoms_nation_resource_points%	Nation resource points.
%kingdoms_nation_might%	Nation might rank.
%kingdoms_nation_capital%	Nation's capital kingdom name.
%kingdoms_nation_tax%	Nation's tax for kingdoms.
%kingdoms_server_nation_tax%	The amount of money your nation has to pay to server for taxes.
%kingdoms_nation_shield_since%	Time that you activated your nation shield.
%kingdoms_nation_shield_time%	Your nation shield duration.
%kingdoms_nation_shield_time_left%	Nation shield time left.

---

Relational Placeholders

Not many plugins support relational placeholders. They can only be used in other plugins if you have PlaceholderAPI plugin installed, however like normal placeholders, they'll work internally in Kingdoms plugin without PAPI installed. Relational placeholders are placeholders that require two players. This will check the kingdom relation between them to make new special placeholders.
If you're using these placeholders from PlaceholderAPI you need to add rel_ at the beginning, so the format would be %rel_<placeholder>%

Placeholder	Description
%kingdoms_relation_name%	The relation name defined in relations.yml between your kingdoms.
%kingdoms_relation_color%	The relation color defined in relations.yml between your kingdoms.

---

Server-wide Placeholders

These placeholders can be used with no context. They don't require a player, kingdom, nation and etc.

Placeholder

Description

%kingdoms_top_<number>_<placeholder>

The placeholder used to retrieve one of the kingdoms that corresponds to what /k top returns. <number> starts from 1 and <placeholder> is simply the placeholder's name as you'd normally use excluding percents and kingdoms prefix. For example, %kingdoms_top_5_name% would show %kingdoms_name% as if it was used for the 5th kingdom. Use this placeholder sparingly as it can impact performance when used a lot.