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_rank_<RANK>% List of members that are <RANK>
%list_rank_<RANK>_total% Total of members that are <RANK>
%list_rank_<RANK>_online% Online members that are <RANK>
%list_rank_<RANK>_online_total% Total of online members that are <RANK>
%list_rank_<RANK>_offline% Offline members that are <RANK>
%list_rank_<RANK>_offline_total% Total of offline members that are <RANK>
%members% List of party members
%members_total% Total of party members
%members_online% List of online party members
%members_online_total% Total of online party members
%members_offline% List of offline party members
%members_offline_total% Total of offline party members
%motd% MOTD of the party
%name% Name of the party
%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
%custom_<PLACEHOLDER>Custom placeholders

{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} Total of existing parties
%parties_list_rank_<RANK>% {PARTIES_LIST_RANK_<RANK>} List of members that are <RANK>
%parties_list_rank_<RANK>_total% {PARTIES_LIST_RANK_<RANK>_TOTAL} Total 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_total% {PARTIES_LIST_RANK_<RANK>_ONLINE_TOTAL} Total of online members that are <RANK>
%parties_list_rank_<RANK>_offline% {PARTIES_LIST_RANK_<RANK>_OFFLINE} Offline members that are <RANK>
%parties_list_rank_<RANK>_offline_total% {PARTIES_LIST_RANK_<RANK>_OFFLINE_TOTAL} Total of offline members that are <RANK>
%parties_members% {PARTIES_MEMBERS} List of party members
%parties_members_total% {PARTIES_MEMBERS_TOTAL} Total of party members
%parties_members_online% {PARTIES_MEMBERS_ONLINE} List of online party members
%parties_members_online_total% {PARTIES_MEMBERS_ONLINE_TOTAL} Total of online party members
%parties_members_offline% {PARTIES_MEMBERS_OFFLINE} List of offline party members
%parties_members_offline_total% {PARTIES_MEMBERS_OFFLINE_TOTAL} Total of offline party members
%parties_motd% {PARTIES_MOTD} MOTD of the party
%parties_name% {PARTIES_NAME} Name of the party
%parties_out_party% {PARTIES_OUT_PARTY} Out of party message (configurable in messages.yml)
%parties_party% {PARTIES_PARTY} Name of the party
%parties_player_display_name% {PARTIES_PLAYER_NAME} Display name of the player
%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_<PLACEHOLDER>% {PARTIES_CUSTOM_<PLACEHOLDER>} Custom placeholders

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

Advanced placeholders

List parties by specific order

Default PlaceholderAPI EssentialsChat
%list_parties_by_name_<NUMBER>% %parties_list_parties_by_name_<NUMBER>% {PARTIES_LIST_PARTIES_BY_NAME_<NUMBER>}
%list_parties_by_name_<NUMBER>_<PLACEHOLDER>% %parties_list_parties_by_name_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_NAME_<NUMBER>_<PLACEHOLDER>}
%list_parties_by_online_members_<NUMBER>% %parties_list_parties_by_online_members_<NUMBER>% {PARTIES_LIST_PARTIES_BY_ONLINE_MEMBERS_<NUMBER>}
%list_parties_by_online_members_<NUMBER>_<PLACEHOLDER>% %parties_list_parties_by_online_members_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_ONLINE_MEMBERS_<NUMBER>_<PLACEHOLDER>}
%list_parties_by_members_<NUMBER>% %parties_list_parties_by_members_<NUMBER>% {PARTIES_LIST_PARTIES_BY_MEMBERS_<NUMBER>}
%list_parties_by_members_<NUMBER>_<PLACEHOLDER>% %parties_list_parties_by_members_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_MEMBERS_<NUMBER>_<PLACEHOLDER>}
%list_parties_by_kills_<NUMBER>% %parties_list_parties_by_kills_<NUMBER>% {PARTIES_LIST_PARTIES_BY_KILLS_<NUMBER>}
%list_parties_by_kills_<NUMBER>_<PLACEHOLDER>% %parties_list_parties_by_kills_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_KILLS_<NUMBER>_<PLACEHOLDER>}
%list_parties_by_experience_<NUMBER>% %parties_list_parties_by_experience_<NUMBER>% {PARTIES_LIST_PARTIES_BY_EXPERIENCE_<NUMBER>}
%list_parties_by_experience_<NUMBER>_<PLACEHOLDER>% %parties_list_parties_by_experience_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_PARTIES_BY_EXPERIENCE_<NUMBER>_<PLACEHOLDER>}

You can list every party of Parties by the selected order, you can get the party number #<NUMBER> and parse any Parties placeholder with <PLACEHOLDER>.
Examples:

%list_parties_by_name_1%                   ===> MyParty
%list_parties_by_name_1_id%                ===> a36182f1-a500-4b56-91d7-308568596455
%list_parties_by_kills_2_kills%            ===> 130
%list_parties_by_kills_2_leader_name%      ===> AlessioDP

List members by rank

Default PlaceholderAPI EssentialsChat
%list_rank_<RANK>_<NUMBER>% %parties_list_rank_<RANK>_<NUMBER>% {PARTIES_LIST_RANK_<RANK>_<NUMBER>}
%list_rank_<RANK>_<NUMBER>_<PLACEHOLDER>% %parties_list_rank_<RANK>_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_RANK_<RANK>_<NUMBER>_<PLACEHOLDER>}
%list_rank_<RANK>_online_<NUMBER>% %parties_list_rank_<RANK>_online_<NUMBER>% {PARTIES_LIST_RANK_<RANK>_ONLINE_<NUMBER>}
%list_rank_<RANK>_online_<NUMBER>_<PLACEHOLDER>% %parties_list_rank_<RANK>_online_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_RANK_<RANK>_ONLINE_<NUMBER>_<PLACEHOLDER>}
%list_rank_<RANK>_offline_<NUMBER>% %parties_list_rank_<RANK>_offline_<NUMBER>% {PARTIES_LIST_RANK_<RANK>_OFFLINE_<NUMBER>}
%list_rank_<RANK>_offline_<NUMBER>_<PLACEHOLDER>% %parties_list_rank_<RANK>_offline_<NUMBER>_<PLACEHOLDER>% {PARTIES_LIST_RANK_<RANK>_OFFLINE_<NUMBER>_<PLACEHOLDER>}

You can list every party member of rank <RANK>, get the number #<NUMBER> and parse any (PlaceholdersAPI too) placeholder with <PLACEHOLDER>.
Examples:

%list_rank_leader_1%                       ===> AlessioDP
%list_rank_member_1%                       ===> AlessioDP2
%list_rank_member_1_online_player_id%      ===> 2757cac1-0636-4465-8527-5df6c46b6f40
%list_rank_member_2_online_player_world%   ===> world (example of PlaceholderAPI placeholder)

List members

Default PlaceholderAPI EssentialsChat
%members_<NUMBER>% %parties_members_<NUMBER>_<PLACEHOLDER>% %PARTIES_MEMBERS_<NUMBER>_<PLACEHOLDER>%
%members_<NUMBER>_<PLACEHOLDER>% %parties_members_<NUMBER>_<PLACEHOLDER>% %PARTIES_MEMBERS_<NUMBER>_<PLACEHOLDER>%
%members_online_<NUMBER>% %parties_members_online_<NUMBER>_<PLACEHOLDER>% %PARTIES_MEMBERS_ONLINE_<NUMBER>_<PLACEHOLDER>%
%members_online_<NUMBER>_<PLACEHOLDER>% %parties_members_online_<NUMBER>_<PLACEHOLDER>% %PARTIES_MEMBERS_ONLINE_<NUMBER>_<PLACEHOLDER>%
%members_offline_<NUMBER>% %parties_members_offline_<NUMBER>_<PLACEHOLDER>% %PARTIES_MEMBERS_OFFLINE_<NUMBER>_<PLACEHOLDER>%
%members_offline_<NUMBER>_<PLACEHOLDER>% %parties_members_offline_<NUMBER>_<PLACEHOLDER>% %PARTIES_MEMBERS_OFFLINE_<NUMBER>_<PLACEHOLDER>%

You can get the party member number #<NUMBER> and parse any (PlaceholdersAPI too) placeholder with <PLACEHOLDER>.
Examples:

%members_1%                         ===> AlessioDP
%members_2%                         ===> AlessioDP2
%members_online_1_player_id%        ===> 2757cac1-0636-4465-8527-5df6c46b6f40
%members_offline_1%                 ===> AlessioDP2

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