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_, ajgeiss0702, 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_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}%

Use in other plugins

You can use the placeholders in other plugins to make for examples, list of players, in menus!

ListPlayers GUI - TrMenu

That's one of the things I did with the TrMenu plugin, I created a ListPlayers GUI menu which supports multiple pages and which you can use to show 3 lists at the same time! You can edit them in the menu file even though it's kinda hard to read x)
Here's an image of the menu:

If you want to download it, you can join TrMenu's Discord and head over to the #share channel where I usually update the menu

More

If you have more examples of what you can do with my expansion in other plugins, let me know and I can link it here!