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:

SubTypes	Description	Valid Lists	Note
normal	Matches all players	Online, Offline, All	Doesn't require a <subtype_value>
perm	Matches all players that match the permission defined by the <subtype_value>	Online	Supports multiple permissions separated by a + Ex: perm1+perm2 (players only need one of them)
world	Matches all players in the world defined by the <subtype_value>	Online	Supports multiple worlds separated by a + (Ex: world1+world2)
nearby	Matches all players in a certain radius in blocks from you defined by the <subtype_value>	Online
whitelisted	Matches all players in the whitelist.	Online, Offline, All	Doesn't require a <subtype_value>
banned	Matches all players banned from the server	Offline, All	The Online list type can be supported but is useless since you can't be banned and online, and the All list types will act the same way as the Offline type. Doesn't require a <subtype_value>
cansee	Matches all players you can see	Online	This feature checks players which aren't hidden from you in game by other plugins such as vanish plugins. Doesn't require a <subtype_value>
placeholder	Matches all players which the placeholder defined in the <subtype_value> without %% returns the specified output	Online, Offline, All	You have to specify the placeholder without %%,
version	Matches all players with the version specified in the <subtype_value>	Online	To specify versions, you have to use the Version Numbers defined here. Supports multiple versions seperated by a + and range of versions with - (both can be mixed!) Ex: ver1-ver3+ver5

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 Note 1: The cansee subtype will use yes to display players you can see, and no to display those you can't see

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:

Placeholders	Outputs
%playerlist_all,normal,yes,list%	cj89898, clip, drek_27, funnycube, Frcsty, GabyTM, ItsMeGlare, Julien_1800, Tanguygab
%playerlist_all,normal,yes,8%	Tanguygab
%playerlist_online,perm,yes,amount,staff.admin%	4
%playerlist_online,world,yes,2,buildingworld+spawnworld%	cj89898, funnycube
%playerlist_online,nearby,yes,list,20%	cj89898, clip, Tanguygab
%playerlist_online,nearby,no,list--,20%	cj89898-clip
%playerlist_all,whitelisted,yes,list%	_NEZNAMY_, andrei1058, Arasple, BlitzGamer_88, DrWurzeli, Magnus, Tanguygab, ajgeiss0702
%playerlist_offline,banned,yes,list,20%	Athermix, DebuffPvP, Raptor_130
%playerlist_online,cansee,yes,list%	Frcsty, GabyTM
%playerlist_online,cansee,yes,list%	cj89898, clip, funnycube, ItsMeGlare
%playerlist_online,version,yes,list,47%	drek_27, Julien_1800
%playerlist_all,placeholder,yes,list,player_is_op

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}%