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	Online, Offline, All	Supports the Online and All list types but obviously won't show anything since banned players can't be connected x) 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 with the same result from the placeholder defined in the <subtype_value> without %% as you	Online, Offline, All	The Placeholder subtype may not work with offline players depending on the placeholder! This is not an issue with this expansion but with the author of the placeholder's expansion who doesn't support offline players. I can't do anything about it
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 Note 2: The placeholder subtype completely ignores yes or no. I forgot to add it and am just lazy :D

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
%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_offline,placeholder,yes,list,player_is_op%	_NEZNAMY_, funnycube, Tanguygab

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