Placeholder for custom player lists
A placeholder that allows you to create custom player lists.
Meaning
Allows you to create custom player lists like in PlayerList expansion, but with possibility to do all in placeholder without necessity to use configuration (and also sometimes PlayerList filters are laggy, but here are not).
Format
%CEP_list_(optional) <connection_method>_(optional) <limit>_<output_separator>_<list_type>_<list_sorting>_<list_output>_(optional) <list_conditions>%<connection_method> – the method for the list working, may be SYNC or ASYNC, in case of "ASYNC" use format "ASYNC:<key>", you can just specify the "key" to get the data by it, or the full placeholder to save the data to this "key" (again: TO OBTAIN THE ASYNC VALUE YOU DO NOT NEED TO SPECIFY ALL OPTIONS, JUST A CONNECTION METHOD AND THE ASYNC KEY) (see more in the hint); (OPTIONAL)
<limit> – the limit of the returning list, for example "10" will return only ten values (with "NONE" list sorting it will be faster because it will instantly end the calculations when limit is reached, while with some another sorting it will first obtain all list suitable for conditions, then sort it, and then crop); (OPTIONAL)
<output_separator> – the separator which will be used in output to separate the list objects, it also may contain many different characters as well, and control characters like \n, \t etc, see more in examples; (MANDATORY)
<list_type> – the list type, may be ALL, OFFLINE or ONLINE, it will define which players will be included to the list: only online, only offline or both of them, see more in examples; (MANDATORY)
<list_sorting> – the sorting way of the list, may be AZ, ZA, NONE or SORT:<placeholder> (optional)<value1>,<value2>,<valueN> (optional)DESC, "AZ" will sort by the <list_output> in order from A letter to Z, "ZA" will do it vice versa, "NONE" will not have any custom sorting (just minecraft behavior), "SORT:<placeholder> (optional)<value1>,<value2>,<valueN> (optional)DESC" will sort not by <list_output>, but by placeholder which you will specify, numerical placeholders will be sorted by their numerical values (but you can also specify the list of values through the comma), and text placeholders will be sorted by the list of values through the comma (first players with first value, then with second, etc), you can invert "SORT" type of sorting by specifying the "DESC", that is descending, see more in examples; (MANDATORY)
<list_output> – the format how to output the list, you can specify any symbols and placeholders, all will be parsed for each player and output, see more in examples; (MANDATORY)
<list_conditions> – the conditions of the list, you can specify any conditions the same as here, you can also use "AND", "OR" and their combinations with brackets for priority defining, see more in examples. (OPTIONAL)
All placeholders which you want to make as the part of the list structure, like in conditions, sorting, output etc, should being started with "$" and ended with "@" symbols!
You can escape these characters where you do not want to use placeholders with "\" symbol!
"ASYNC" <connection_method> allows you to return data asynchronously, you will get nothing from the common returning placeholder, it will just save the data to the specified key, only on the next time (for example, after one or more ticks/seconds delay), using the partial returning placeholder (that is, only <connection_method>) you will get the data by the specified key. "SYNC" <connection_method> works as usual, but it will load the server performance more in case of big amount of processing players!
Use "ᵕ" symbol instead of underscores in <list_conditions> and <list_output>!
Use "␠" symbol instead of spaces in <list_conditions> and <list_output> if amount of spaces nearby are above 1!
Where is useful
Wherever you need to create and use player lists quickly and easily, without necessity to go to the configuration and without worries about filters lagging.
Examples
%CEP_list_ | _ALL_SORT:$vault_eco_balance_fixed@ DESC_$player_name@ = $vault_eco_balance_formatted@\$_$servervariables_value_otherplayer_$player_name@:haveWorld@==false% # Get all players sorting them by their balance in descending, outputting in format like "<player> = <balance>$" with " | " separation, if the players are accomplishing the condition about they are should not have ServerVariables plugin "haveWorld" variable set to true%CEP_list_\n → _ONLINE_ZA_$player_name@_($vault_eco_balance_fixed@>=500 AND $vault_eco_balance_fixed@<60000) OR $player_name@startsWithH% # Get all online players sorting them in the in reverse order by nicknames, outputting nicknames with "\n(new line) → " separation, if the players are accomplishing the condition about their balance should be higher or equals than 500 AND lower than 60000 OR nickname should start with H%CEP_list_ASYNC:testAsync_10_,_ALL_NONE_$player_name@ = $vault_eco_balance_fixed@\$ = $vault_group@_$vault_eco_balance_fixed@>=5000 AND $vault_hasgroup_vip@==yes% # Get all players asynchronously with "testAsync" key, limiting to 10 entries, without sorting, outputting in format like "<player> = <balance>$ = <group>" with "," separation, if the players are accomplishing the condition about their balance should be higher or equals than 5000 AND their group should inherit vip%CEP_list_ASYNC:testAsync% # Obtain the value of the placeholder aboveNeed entity lists? Use placeholder for entities in radius.
Last updated