PlayerList is a must-have plugin for any Minecraft server owner looking to elevate their players' experience with beautifully designed and fully customizable player lists.
![[IMG]](//proxy.spigotmc.org/f04e491a7be5132fd119780707467deb3b8cc000?url=https%3A%2F%2Fi.imgur.com%2FtB7Cyon.jpg)
FEATURES
![[IMG]](http://proxy.spigotmc.org/f04e491a7be5132fd119780707467deb3b8cc000?url=https%3A%2F%2Fi.imgur.com%2FtB7Cyon.jpg)
- Multiple Player Lists: Multiple player lists can be created according to your preferences, allowing you to add players as desired and organize them as you see fit.
- List Players Only from Specified Worlds.
- Open Commands: You can easily create and configure commands to display format lines.
- Sorting: You can arrange players in lists according to their permissions.
- Custom Names: Display players with personalized names.
- PlaceholderAPI Placeholders: You can include PlaceholderAPI placeholders in any message.
- List Anywhere: With PlaceholderAPI, you can display any player list in other plugins.
- Multiple Languages: PlayerList supports multiple languages: English (en), German (de), Spanish (es), French (fr), Italian (it), Romanian (ro).
For support with this plugin, please visit my discord server.
USAGE
- Certain keywords are optional and can be removed if deemed unnecessary.
- You can include hex colors in any message, like this example: 'Hello, 񡪀{sender}!'.
- The list and format configurations can be defined in multiple places, including the "config.yml" file, the "format_configurations.yml/formats.yml" file, the "list_configurations.yml/lists" file, as well as the "format_configurations/formats" and "list_configurations/lists" directories.
Spoiler: staff list
# Set the maximum number of players to display.
Limit : 10
# Set the criteria for including a player in the list.
Condition : 'isVisible && (perm->playerlist.staff or perm->lp.owner and GameMode-> "SURVIVAL|ADVENTURE" )'
# Choose the worlds to search for players.
Worlds :
- world
- world_the_end
# Choose the worlds to exclude from the player search.
ExcludedWorlds :
- excluded_world1
- excluded_world2
# Set the separator for player names in the output.
Separator : '&c, '
# Set the message to display when no players are found.
Empty : '&4None'
SortingConditions:
- 'priority : -1.2' # Priority assigned only to the following condition.
- 'perm->lp.owner'
- 'health < 5'
SortingFactor : ' %statistic_seconds_played%'
NameCustomization:
custom_name1:
Permission : lp.owner
DisplayName : '&4 {player }'
custom_name2:
Condition : perm->lp.moderator or perm->lp.operator
DisplayName : '&3 {player }'
Code (YAML):
# Set the maximum number of players to display.
Limit : 10
# Set the criteria for including a player in the list.
Condition : 'isVisible && (perm->playerlist.staff or perm->lp.owner and GameMode-> "SURVIVAL|ADVENTURE" )'
# Choose the worlds to search for players.
Worlds :
- world
- world_the_end
# Choose the worlds to exclude from the player search.
ExcludedWorlds :
- excluded_world1
- excluded_world2
# Set the separator for player names in the output.
Separator : '&c, '
# Set the message to display when no players are found.
Empty : '&4None'
SortingConditions:
- 'priority : -1.2' # Priority assigned only to the following condition.
- 'perm->lp.owner'
- 'health < 5'
SortingFactor : ' %statistic_seconds_played%'
NameCustomization:
custom_name1:
Permission : lp.owner
DisplayName : '&4 {player }'
custom_name2:
Condition : perm->lp.moderator or perm->lp.operator
DisplayName : '&3 {player }'
Spoiler: donors list
Permission : playerlist.donors
Separator : '&b, '
Empty : &aNone
NameCustomization:
custom_name:
DisplayName : true
Code (YAML):
Permission : playerlist.donors
Separator : '&b, '
Empty : &aNone
NameCustomization:
custom_name:
DisplayName : true
Spoiler: format
# {sender}: The command sender's name.
# {player}: The other player's name.
# {<list_ID>}: The player list identified by <list_ID>. The list ID can be derived from its file name or from a configuration section keyword.
# For example, if a list configuration is in a file named 'staff.yml', its ID is 'staff'.
# If a list configuration is in a file named 'donors.txt', its ID is 'donors'.
# {<list_ID>_amount}: The size of the player list identified by <list_ID>.
# The permission needed to view this format
Permission : 'playerlist.formats'
# If the command sender doesn't have the above permission when executing the open command, this error message is displayed.
Error : '&4Top secret'
OpenCommand:
Name : list
Aliases : [playerlist, plist ]
# Args: [These, arguments, must, be, included, by, the, player, to, execute, this, command]
WrongArgs : '&4The arguments do not match.'
# If true, this command's executor and tab completer ignore case when comparing arguments.
IgnoreCase : true
# If true, any new color code will be translated after all placeholders are set.
TranslateFormattedColors : false
Format:
- '&8• &7Staff &8(&4{staff_amount}&8)&7 : &c{staff}'
- '&8• &7Donors &8(&1{donors_amount}&8)&7 : &b{donors}'
- '&8• &7Online : &a{online_amount}'
Code (YAML):
# {sender}: The command sender's name.
# {player}: The other player's name.
# {<list_ID>}: The player list identified by <list_ID>. The list ID can be derived from its file name or from a configuration section keyword.
# For example, if a list configuration is in a file named 'staff.yml', its ID is 'staff'.
# If a list configuration is in a file named 'donors.txt', its ID is 'donors'.
# {<list_ID>_amount}: The size of the player list identified by <list_ID>.
# The permission needed to view this format
Permission : 'playerlist.formats'
# If the command sender doesn't have the above permission when executing the open command, this error message is displayed.
Error : '&4Top secret'
OpenCommand:
Name : list
Aliases : [playerlist, plist ]
# Args: [These, arguments, must, be, included, by, the, player, to, execute, this, command]
WrongArgs : '&4The arguments do not match.'
# If true, this command's executor and tab completer ignore case when comparing arguments.
IgnoreCase : true
# If true, any new color code will be translated after all placeholders are set.
TranslateFormattedColors : false
Format:
- '&8• &7Staff &8(&4{staff_amount}&8)&7 : &c{staff}'
- '&8• &7Donors &8(&1{donors_amount}&8)&7 : &b{donors}'
- '&8• &7Online : &a{online_amount}'
Spoiler: condition
COMMANDS
- isViewer: Checks if the viewer is the same as the player.
- isVisible: Checks if the viewer can see the player.
- hasPlayedBefore: Checks if the player has played before.
- isFlying: Checks if the player is flying.
- isSprinting: Checks if the player is sprinting.
- isSneaking: Checks if the player is sneaking.
- isOp: Checks if the player is an operator (OP).
- isGliding: Checks if the player is gliding.
- isDead: Checks if the player is dead.
- isSleeping: Checks if the player is sleeping.
- isSwimming: Checks if the player is swimming.
- isKilledByViewer: Checks if the player was killed by the viewer.
- true|yes: Represents a true condition.
- false|no: Represents a false condition.
- name: Retrieves the player's name.
- displayName: Retrieves the player's display name.
- world: Retrieves the name of the world the player is in.
- health: Retrieves the player's health.
- exp: Retrieves the player's experience points.
- expToLevel: Retrieves the experience points required to reach the next level.
- firstPlayed: Retrieves the timestamp of when the player first joined the server.
- flySpeed: Retrieves the player's flying speed.
- fallDistance: Retrieves the distance the player has fallen.
- foodLevel: Retrieves the player's food level.
- lastDamage: Retrieves the timestamp of when the player was last damaged.
- fireTicks: Retrieves the remaining fire ticks of the player.
- level: Retrieves the player's level.
- saturation: Retrieves the player's saturation level.
- permission|perm: Checks if the player has a specific permission.
- cansee: Checks if the player can see another player.
- isNearby: Checks if the player is within a certain distance from the viewer.
- ! or not: Negates the condition.
- and/&: Combines two or more conditions; returns true if all of its operands are true.
- or/|: Combines two or more conditions; returns true if either of its operands is true.
- ==: Compares objects and uses String.equals() for string comparisons and the Java equal to comparator to compare enums and numbers.
- !=: Compares objects and returns true if they are not equal.
- >: Compares numbers and strings; returns true if the first number is greater than the second number.
- <: Compares numbers and strings; returns true if the first number is less than the second number.
- >=: Compares numbers and strings; returns true if the first number is greater than or equal to the second number.
- <=: Compares numbers and strings; returns true if the first number is less than or equal to the second number.
- ->: Matches a string with a regular expression using String.matches() and is also used for conditions like 'perm -> my.permission', which simply checks if the player has the permission 'my.permission'.
- (): Groups conditions.
- /CustomList hide player - to exclude a player from player listing
- /CustomList unhide player - to include a previously excluded player back into player listing
- /CustomList reload - to reload this plugin
- playerlist.hide - Provides the capability to exclude a player from player listing
- playerlist.reload - Provides the capability to reload this plugin
- %playerlist_ishidden% - If the player is hidden, the response is 'yes'; otherwise, it is 'no'
- %playerlist_<list ID>%
- %playerlist_<list ID>_amount%.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.8, 1.13, 1.16
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
PlayerList is a free Minecraft Java mod. Compatible with Minecraft 1.8, 1.13, 1.16, 1.19. Downloaded 2,118 times (via Spigot). Download it and open it directly in the game.