PlayerList
Ever wanted a simple way to list all of the players on your server in their ranks? With PlayerList you can do just that, and more!
Features
PlayerList comes with two important features:
- Changing the color of player names in the Tab list to their ranks defined in the config
- Showing players in their ranks defined in the config
Downloads
Setup
The first section of the config is pretty self explanatory but comes with its comments to help you anyway. Still, here's all you need to know about setting it up and using it:
The first thing you need to do is get Vault. Why? This plugin uses vault to get the groups of players, since bukkit has no direct method of doing so.
After you install vault, you need to set up your config. The plugin will work without doing so but as long as you haven't defined the ranks in the config, you won't get very far. Here's how to set up the first half:
PlayerList: global-players: one-player: '&bThere is &a%players &bplayer online:' more-players: '&bThere are &a%players &bplayers online:' change-tablist: true use-displayname: true show-on-same-line: true
So what does all this mean? Well, I'm pretty sure you can guess what the first section says. It basically defines the message to display how many players are online. In this message you can use any color code and refer to the amount of players online using the %players tag. You don't need the tag for the one-player section as you can just as easily type "There is 1 player online:" but it's there for convenience.
Next is change-tablist. Setting this to true will change the colors of everyone's name to whatever their rank is in the ranks section. Setting this to false will keep the tablist untouched.
Then there's use-displayname. In bukkit, there are two ways to get the name of a player. DisplayName is the name of the player as it appears on the screen. So if you have any prefixes defined or other nickname settings enabled, it will get the nickname. Setting this to false will return the exact full name of the player.
show-on-same-line. This shows the player list of that specific rank on the same line as the rank. Setting this to false will show the player list on the next line.
Okay, that wasn't so bad. Here's where things get a little more interesting though:
ranks: Administration: color: '&f' admin: '&4' moderator: '&3' Default: color: '&f' default: '&7'
Okay. Let me break this down into sections:
Administration:
This is the name of the rank that will appear when someone types /list. It can be called anything as long as it doesn't have a space in it, but for the sake of even downloading the plugin I'm sure you'd call it something relevant.
color: '&f'
This is that color of the name of the rank that appears in the chat. So in this example, when players type /list, they'll get:
Administration (#):
And this will be white. the # will be the number of players online in that group.
admin: '&4' moderator: '&3'
This is the trickiest part to understand. Lets break it down and forget about the color codes for now. Basically, this says "All players in the admin and moderator groups will be shown in the Administrator section".
Lets say player "Foo" is an admin and "Bar" is a moderator, and that they're both online. This is what players would see when they type /list:
Administration (#): Foo, Bar
So what about the color codes next to the rank names? Simple. If you have use-displayname set to false, it will change the color of players names to whatever you put in the color code section. So in the above example, since Foo is a member of the admin group and Bar is a member of the moderator group, Foo's name will be dark red and Bar's name will be dark aqua.
ranks: Administration: color: '&f' admin: '&4' moderator: '&3' Default: color: '&f' default: '&7'
So this is much easier to understand now. You can also put players in other groups so they will show up there too, which is pretty pointless in the long run. But possible.
Additionally, the ranks shown when /list is run will be shown in order of the config. So the Administration section will be displayed first, then the Default. As well as this, if there is nobody online who belongs in one of these groups, that group is skipped and the next one is checked, so you don't get empty lists ingame.
Here's a screenshot of the setup I have running for ba55ment.org, a sever I co-own:
And here's the config for that setup:
PlayerList: global-players: one-player: '&bThere is &a%players &bplayer online:' more-players: '&bThere are &a%players &bplayers online:' change-tablist: true use-displayname: true show-on-same-line: true ranks: Admin: color: '&f' admin: '&4' Moderator: color: '&f' moderator: '&3' Architect: color: '&f' architect: '&a' Trusted: color: '&f' trusted: '&6' Supporter: color: '&f' ddefault: '&7' dtrusted: '&6' darchitect: '&a' dmoderator: '&3' Default: color: '&f' default: '&7'
As you can see we have a donator rank for each other rank on the server. We changed the name to supporter in this config though.
Now, this is on Essentials :P
How do I get my builders to use /list ?
I can't get my builders to use /list cause they do not have permissions
@ThisUsernameIsMine
Hi! How did you get the names on the /list command i cant get my name on there.. I would be very helpful if you could tell me how to get the names on there! :) Have a great Day!
@Xephi59
Oh derp you're right xD thanks
@Dprox
Have you any error in the console or the plugin does not work with your craftbukkit version?
That works fine with the 1.4.2R0.2 for me :O
Great plugin! You should update it!!
@PatoTheBest
Permission Node :
playerlist.list
You can reload playerlist too with the command :
/playerlist reload
and the node is : playerlist.reload
@PatoTheBest
Using Vault , also most of them '
It's just a plugin to sort player by groups and display a great list ;) also no really need a permissions.node system :/
Xephi
Permissions?!?!?!
@wumpyc
I have the same problem and correct this , i try to pull request the author with my fix :)
http://pastebin.com/7C5TNmZx
Nothing changes. Even if i restarted..
For a fast help give the permissions: PlayerList.*
I can't get permissions to work for my non-op ranks. I have both bPermissions and Vault, but adding the node bk871 suggested still results in a 'You do not have permission!' error.
Also, when doing /list as Op it doesn't list my name in the list, it only tells that 1 player is online.
edit: Ok, i got myself listed now, but the colo(u)rs don't work out. This stuff is more complicated than i though =P
Thanks for the plugin though! ;)
any way you could just take player ranks and colors and stuff from groupmanager so we dont have to do it again?
Epic plugin! Please keep this updated :)
A few suggestions...
- Add to the info above that groups require playerlist.<permission>
- Add playerlist.* to all permission checks to allow the usage of the node.
- Add a secondary check for a permission node, so if someone has (for example) voted.today, they could be given a special color in the list.
- Add an option to use the player's nick name in addition to the option of using their entire display name.
BK
Okay thanks :) I suscribe also :p Good luck :)
Xephi
@Xephi59
I'll look into it! :)
Hi guys , that seems a great plugin , just a question : What about vanished players ? :D
Thanks for answer Great Job !
Xephi