Home

Download

You can download the expansion on PlaceholderAPI's eCloud at https://api.extendedclip.com/expansions/playerlist/

Usage:

Placeholder Syntax

• %playerlist_<type>,<subtype>,<yes/no>,<output>,<subtype_value>%

Types:

• all - Matches all players
• online - Matches online players
• offline - Matches offline players

SubTypes:

• normal - Matches all players - Doesn't require a <subtype_value>
• perm - Matches all players that match the permission defined by <subtype_value> - Supports multiple separated by + Ex: perm1+perm2 (they only need one of them)
• world - Matches all player in the world defined by <subtype_value> - Supports multiple separated by + (Ex: world1+world2)
• nearby - Matches all players in a certain radius in blocks defined by <subtype_value>

Yes/No

• yes - Will get the list of players counting you in it
• no - Will get the list of players without counting you in it

Output Types:

• list - Returns a list of players separated by , . You can also change the separator with list-<separator>. Since , is used to separate the differents parts of the placeholder, use \. instead if you want to display a ,.
• amount - Returns amount of players matched
• - Returns the player at the specified index

Examples:

• %playerlist_all,normal,yes,list% - Tanguygab, cj89898, funnycube, clip, Frcsty, GabyTM, ItsMeGlare
• %playerlist_all,normal,yes,0% - Tanguygab
• %playerlist_online,perm,yes,amount,staff.admin% - 3
• %playerlist_online,world,yes,2,buildingworld+spawnworld% - cj89898, funnycube
• %playerlist_online,nearby,yes,list,20% - Tanguygab, cj89898, clip
• %playerlist_online,nearby,no,list--,20% - cj89898-clip

Note: You can also use PlaceholderAPI placeholders in the different parts of the placeholder with {placeholder} or [placeholder]. For example: %playerlist_online,world,{player_is_op},[math_{vault_eco_balance}[precision:0]],{player_world}%