Skip to content

Placeholders

Crypto Morin edited this page Jun 26, 2020 · 97 revisions

Kingdoms supports 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.

Short & Fancy Placeholders

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

Short Placeholders

A short placeholder is a number placeholder that is shortened with number prefixes to fit big numbers.
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_resource_points% %kingdoms_fancy_resource_points% 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.

RANK_NODE, RANK_NAME, RANK_COLOR, RANK_SYMBOL, RANK_PRIORITY, RANK_MAX_CLAIMS

Players

Placeholder Description
%kingdoms_chat_channel% Your current chat channel name.
%kingdoms_tax% The amount of money you have to pay to your kingdom.
%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

Placeholder Description
%kingdoms_name% Your kingdom name.
%kingdom_lore% Your kingdom lore that can be set from /k lore
%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_king% Your kingdom king name.
%kingdoms_might% Your kingdom might count.
%kingdoms_home% Your kingdom home location.
%kingdoms_nexus% Your kingdom nexus location.
%kingdoms_lands% Your kingdom land count.
%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.
%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_server_nation_tax% The amount of money your nation has to pay to server for taxes.

Basics

Advanced

Others

Clone this wiki locally