Placeholders

Parties use own and PlaceholderAPI placeholders. These are divided into 2 categories: inside and outside the plugin.


Inside Parties

Inside Parties configurations, placeholders are called 'tags'.

Every time there is a special tag, there is an explanation too, just scroll your configuration file to catch up every tag 😉.
These are the tags that you can use everywhere:

Tag Description
%color_code% Color code of the party
%color_command% Color command of the party
%color_name% Color name of the party
%desc% Description of the party
%experience_total% Total experience gained
%experience_level% Party level
%experience_level_roman% Party level with roman numbers
%experience_level_experience% Total experience of current level
%experience_levelup_current% Current level experience
%experience_levelup_necessary% Necessary experience to level up
%kills% Kill counter of the party
%id% ID of the party
%leader_name% Leader name
%leader_uuid% Leader uuid
%list_parties_total% Number of existing parties
%list_parties_by_name_<NUMBER>% Get the <NUMBER>th party ordered by name
%list_parties_by_name_<NUMBER>_<PLACEHOLDER>% Get the <NUMBER>th party ordered by name and parse it as <PLACEHOLDER>
%list_parties_by_online_members_<NUMBER>% Get the <NUMBER>th party ordered by online members
%list_parties_by_online_members_<NUMBER>_<PLACEHOLDER>% Get the <NUMBER>th party ordered by online members and parse it as <PLACEHOLDER>
%list_parties_by_members_<NUMBER>% Get the <NUMBER>th party ordered by members
%list_parties_by_members_<NUMBER>_<PLACEHOLDER>% Get the <NUMBER>th party ordered by members and parse it as <PLACEHOLDER>
%list_parties_by_kills_<NUMBER>% Get the <NUMBER>th party ordered by kills
%list_parties_by_kills_<NUMBER>_<PLACEHOLDER>% Get the <NUMBER>th party ordered by kills and parse it as <PLACEHOLDER>
%list_parties_by_experience_<NUMBER>% Get the <NUMBER>th party ordered by experience
%list_parties_by_experience_<NUMBER>_<PLACEHOLDER>% Get the <NUMBER>th party ordered by experience and parse it as <PLACEHOLDER>
%list_players_<NUMBER>% Get the <NUMBER>th member name
%list_players_<NUMBER>_<PLACEHOLDER>% Get the <NUMBER>th member and parse it as <PLACEHOLDER>
%list_players_total% Number of existing players in party
%list_rank_<RANK>% List of members that are <RANK>
%list_rank_<RANK>_number% Number of members that are <RANK>
%list_rank_<RANK>_online% Online members that are <RANK>
%list_rank_<RANK>_online_number% Number of online members that are <RANK>
%motd% MOTD of the party
%name% Name of the party
%online% List of online members
%online_number% Number of the online members
%out_party% Out of party message (configurable in messages.yml)
%party% Name of the party
%player% Player name
%player_id% Player UUID
%player_name% Player name
%player_rank_chat% Formatted rank name of the player
%player_rank_name% Rank name of the player
%sender% Sender name
%server_id% BungeeCord server id (configurable in config.yml)
%server_name% BungeeCord server name (configurable in config.yml)
%tag% Tag of the party
%victim% Victim name

{info} You can use PlaceholderAPI placeholders inside Parties! Just remember that Parties tags are considered first.

Outside Parties

Outside Parties you can use PlaceholderAPI to print Parties tags wherever you want! It supports EssentialsChat too.

PlaceholderAPI EssentialsChat Description
%parties_color_code% {PARTIES_COLOR_CODE} Color code of the party
%parties_color_command% {PARTIES_COLOR_COMMAND} Color command of the party
%parties_color_name% {PARTIES_COLOR_NAME} Color name of the party
%parties_desc% {PARTIES_DESC} Description of the party
%parties_experience_total% {PARTIES_EXPERIENCE_TOTAL} Total experience gained
%parties_experience_level% {PARTIES_EXPERIENCE_LEVEL} Party level
%parties_experience_level_roman% {PARTIES_EXPERIENCE_LEVEL_ROMAN} Party level with roman numbers
%parties_experience_level_experience% {PARTIES_EXPERIENCE_LEVEL_EXPERIENCE} Total experience of current level
%parties_experience_levelup_current% {PARTIES_EXPERIENCE_LEVELUP_CURRENT} Current level experience
%parties_experience_levelup_necessary% {PARTIES_EXPERIENCE_LEVELUP_NECESSARY} Necessary experience to level up
%parties_kills% {PARTIES_KILLS} Kill counter of the party
%parties_id% {PARTIES_ID} ID of the party
%parties_leader_name% {PARTIES_LEADER_NAME} Leader name
%parties_leader_uuid% {PARTIES_LEADER_UUID} Leader uuid
%parties_list_parties_total% {PARTIES_LIST_PARTIES_TOTAL} Number of existing parties
%parties_list_parties_by_name_<NUMBER>% {PARTIES_LIST_PARTIES_BY_NAME_<NUMBER>} Get the <NUMBER>th party ordered by name
%parties_list_parties_by_name_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_NAME_<NUMBER>_<PLACEHOLDER>} Get the <NUMBER>th party ordered by name and parse it as <PLACEHOLDER>
%parties_list_parties_by_online_members_<NUMBER>% {PARTIES_LIST_PARTIES_BY_ONLINE_MEMBERS_<NUMBER>} Get the <NUMBER>th party ordered by online members
%parties_list_parties_by_online_members_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_ONLINE_MEMBERS_<NUMBER>_<PLACEHOLDER>} Get the <NUMBER>th party ordered by online members and parse it as <PLACEHOLDER>
%parties_list_parties_by_members_<NUMBER>% {PARTIES_LIST_PARTIES_BY_MEMBERS_<NUMBER>} Get the <NUMBER>th party ordered by members
%parties_list_parties_by_members_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_MEMBERS_<NUMBER>_<PLACEHOLDER>} Get the <NUMBER>th party ordered by members and parse it as <PLACEHOLDER>
%parties_list_parties_by_kills_<NUMBER>% {PARTIES_LIST_PARTIES_BY_KILLS_<NUMBER>} Get the <NUMBER>th party ordered by kills
%parties_list_parties_by_kills_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_KILLS_<NUMBER>_<PLACEHOLDER>} Get the <NUMBER>th party ordered by kills and parse it as <PLACEHOLDER>
%parties_list_parties_by_experience_<NUMBER>% {PARTIES_LIST_PARTIES_BY_EXPERIENCE_<NUMBER>} Get the <NUMBER>th party ordered by experience
%parties_list_parties_by_experience_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_EXPERIENCE_<NUMBER>_<PLACEHOLDER>} Get the <NUMBER>th party ordered by experience and parse it as <PLACEHOLDER>
%parties_list_players_<NUMBER>% %PARTIES_LIST_PLAYERS_<NUMBER>% Get the <NUMBER>th member name
%parties_list_players_<NUMBER>_<PLACEHOLDER>% %PARTIES_LIST_PLAYERS_<NUMBER>_<PLACEHOLDER>% Get the <NUMBER>th member and parse it as <PLACEHOLDER>
%parties_list_players_total% {PARTIES_LIST_PLAYERS_TOTAL} Number of existing players in party
%parties_list_rank_<RANK>% {PARTIES_LIST_RANK_<RANK>} List of members that are <RANK>
%parties_list_rank_<RANK>_number% {PARTIES_LIST_RANK_<RANK>_NUMBER} Number of members that are <RANK>
%parties_list_rank_<RANK>_online% {PARTIES_LIST_RANK_<RANK>_ONLINE} Online members that are <RANK>
%parties_list_rank_<RANK>_online_number% {PARTIES_LIST_RANK_<RANK>_ONLINE_NUMBER} Number of online members that are <RANK>
%parties_motd% {PARTIES_MOTD} MOTD of the party
%parties_name% {PARTIES_NAME} Name of the party
%parties_online% {PARTIES_ONLINE} List of online members
%parties_online_number% {PARTIES_ONLINE_NUMBER} Number of the online members
%parties_out_party% {PARTIES_OUT_PARTY} Out of party message (configurable in messages.yml)
%parties_party% {PARTIES_PARTY} Name of the party
%parties_player_id% {PARTIES_PLAYER_ID} UUID of the player
%parties_player_name% {PARTIES_PLAYER_NAME} Name of the player
%parties_player_rank_chat% {PARTIES_PLAYER_RANK_CHAT} Formatted rank name of the player
%parties_player_rank_name% {PARTIES_PLAYER_RANK_NAME} Rank name of the player
%parties_server_id% {PARTIES_SERVER_ID} BungeeCord server id (configurable in config.yml)
%parties_server_name% {PARTIES_SERVER_NAME} BungeeCord server name (configurable in config.yml)
%parties_tag% {PARTIES_TAG} Tag of the party
%parties_custom_XXX% {PARTIES_CUSTOM_XXX} Custom placeholders

If you are using MvdW PlaceholderAPI, you need to use {mvdw_parties_TAG}.

Custom placeholders

Thanks to placeholders configuration, you can make every custom placeholder that you want!
If you think that this is useless, this an example of usage:

customs:
  example1: "[%color_code%%party%] "

This will be your format: %parties_custom_example1%%username%: %message%.

This will be the output:
Player1 is inside a party: [&cMyParty] Player1: a message
Player2 is outside a party: Player2: another message

© AlessioDP 2015-2021