PrefixedPlayerlist
Prefixed Playerlist takes prefixes (colors, text or colored text) from its config or PermissionsEx and displays them in the scoreboard / player list (invoked by TAB ingame). You don't need any additional plugins (PEX is optional).
Features
- Define prefix for server OPs
- Players in different game modes can be distinguished
- There are commands to reload configuration, reload the playerlist and get information about the plugin
- There is a default prefix if you want to prefix all names
- The plugin takes advance of Bukkit Permissions
- PermissionsEx prefix support
Commands
Every command can start with /ppl or /playerlist. You can use native command /help PrefixedPlayerlist for your own convenience.
- /ppl or /ppl help points you to look at /help PrefixedPlayerlist
- /ppl version shows basic information about the plugin
- /ppl reload softly reloads plugin configuration (without re-reading plugin jar file)
- /ppl checkupdate manually checks for updates
- /ppl refresh refreshes the player table
Permissions
Note that there are not-that-much permissions starting with prefixedplayerlist.prefix.* that are used to assign prefixes and nothing else. They are explained elsewhere - take a look at example setup.
- prefixedplayerlist.* Gives full control over all commands of PrefixedPlayerlist
- prefixedplayerlist.reload Allows you to reload the plugin (/ppl reload)
- prefixedplayerlist.checkupdate Allows you to check for new versions manually (/ppl checkupdate)
- prefixedplayerlist.refresh Allows you to refresh the player list (/ppl refresh)
How prefixes stack
- If you use PrefixedPlayerlist config to define prefixes
- prefixCreative + prefixOp + prefixDefault + prefixCustom + PlayerName
- When you use PermissionsEx to define prefixes
- prefixCreative + prefixOp + prefixDefault + PEXprefix + PlayerName
Additional notes
Important notes and information:
- Keep in mind that max. length of player name is 16 characters. This is a client-side limit.
- Each color takes 2 characters (see below).
- PPL inserts one color (two characters) at the end of each name to keep ping color unchanged
- When playername is too long, it gets stripped to 13 characters, and … (triple-dot glyph, ellipsis) is added at the end (along with the color reset for ping).
- The length of a prefix is limited to 10 characters by the plugin,
- although it is wise to keep the overall length of prefix (count with op, gamemode, etc.) under 4 characters. You don't want to see MyNicePrefix:A… (with A being the only part of players name visible)
- You can define colors using the control characters § (paragraph), or & (and).
- Colors are defined by the control character and number from 0 to 9 or letter a-f. The text following this control sequence is affected.
- You can use formatting characters if you want (things like bold, underline, etc. See MP wiki page for details)
- Colors are defined by the control character and number from 0 to 9 or letter a-f. The text following this control sequence is affected.
- Every player may have only one custom prefix. Priority has the group first defined in the config. Therefore it is a great idea to start with prefix for administrator, then moderator, then some special player groups, etc.
- Why? Your admin will probably inherit the "prefix permission" of moderators, and you want to have him prefix of admin, not mod.
- If you decide not to use some of the predefined prefixes (gamemodes, op), you can either leave the apostrophes blank or remove the whole definition
- When you op or deop someone, the change can be seen only after relog (or after plugin reload), not immediately.
- There is now a refresh command for the table, just use /ppl refresh
- Plugin checks if it is up to date every time it is enabled. Your server IP and plugin version are logged at that time. It's just for me to keep approximate number of users.
- This can be disabled in config by setting options.checkVersion to false
- You can check for updates manually using /ppl checkupdate
- I really appreciate feedback, so feel free to leave a comment! :)
Known Bugs
There are no known bugs at the moment.
Todo & Feature Requests
- Base the plugin around custom, easily formattable strings
- Add hiding in the list
- Add more commands (to hide, change the name, etc.)
- Allow coloring the ping
Mark self with different colorimpossible, waiting for official mod API
@noelcjf
Nchat probably interferes with PPL and overwrites the tab list. Maybe write the plugin author, because that's not something I can actually deal with.
@doggyroc
This is weird; I'll look into it. Though if you use PEX, maybe you want to use PEX prefixes (easier to set up - can be done through commands ingame)
You need to add a tickets section but untill then ill post kind of my ticket here: http://dev.bukkit.org/paste/4956/
grr i cant since to get it to work i using pex and Nchat together but the problem is when i set it and i go in game it works fine but when i type hi the color gone in tab list wth
Is there any command to reload config?
@getaim this seems more like that other plugin interferes with PPL. It might be some chat plugin or something like that. Can you tell me what plugin could cause that?
You have to make it realtime or autoreload every minute or so. I dont want to reload the plugin every second to make a player with to much characters cut. My players who have long names are still white, just for a short moment when i reload your plugin they get cut and colored, when they make 1 chat entry they turn back white :(
@imilkywayz
There is actually very similar plugin originally meant for iChat, if you prefer that (the original reason I made this plugin was because we use herochat on our server and it wouldn't make sense to have iChat there to only color the TAB table :)).
Thanks a lot man, I was looking for this exactly. :D Great plugin the only problem is the config.. I wish it would hook into ichat so i wouldn't need to add all the ranks and the colors. But this is fine :D
@Amunak
No problem, I am happy with this plugin like it is now: working :D
Dont hurry.. its only a minor missing feature
@DHLF
Thanks for the info. I'm actually planning to implement commands, but I don't have much time ATM. Anyway, I'll try to make it into the next version.
@Amunak
PPL v1.1.0 works smoothly using CB1.1-R4 (#1938) and PeX 1.19 but I am missing a pplreload command.
As users can be promoted ingame to other groups this change will not be shown using the TAB key.
The user colour stays the same as before promoting, only after a reconnect of the user this is correctly displayed.
(Yes, I've read your notes about the special OPs and the necessary re-logs)
The server command reload fix this but some plugins dont "like" being reloaded this way..
My idea: those pplreload command could force only PPL to reload the given values in PeX.
@Flenix1 It has the lowest priority as for load, so for events. That means that it changes it last, and the change should be visible always. Maybe try disabling this funcion in essentials (it should be possible).
@Jobsti2 Updated now for 1.2. Though I'm not sure if it actually works on 1.1 (the old version should). Use the download from my dropbox folder, if the file here doesn't get updated in time :)
Update for R6/1.2 would be nice.
Thanks!
Whats the priority set as on this (if at all?)
Essentials sets its nicknames into the tab view too - I think that might be stopping this from adding colours and prefixes
Getting errors for session.minecraft.net O.o
@ThisUsernameIsMine
16 is the max characters regular clients can receive. Beyond that, they crash. Each color is 2 characters.
@Amunak
Sorry for the late reply (busy life etc.) but 14 characters is indeed the magic number if i must believe the below in-game screenshot:
There also aren't many plugins around that are able to achieve this (for the latest RB).
I wish you best of luck and thanks for the explanation! :-)
@ThisUsernameIsMine Thanks.
You actually made me to think about this. Now it is simple - if the name is longer then 16 characters, it's stripped to 14 and two dots are added to the end. That actually is not ideal, because the color is not reset (and the ping gets colored). I'll change this in the next version.
The new behaviour will be the same as the ichatplayerlist has - if the nick with prefix is longer than 14 characters, it gets stripped to 14, and two dots and color reset is added. I might also make this (and the two dots) optional/configurable, so some space can be saved.
Hello there :)
What is the maximum player name-length that PPL will show? The iChatPlayerList plugin i'm currently using shows the first 12 chars. Names existing of more than 12 chars will have two leading dots on the 13th and 14th position of the name, the remaining characters aren't displayed (cause color-codes use space too).
Nice plugin btw!
@allbad1
Yes, it is. Yo don't have to ask - PPL is very small and lightweight, and there's only a tiny chance it will break because of a bukkit update. And if it would, I'd release patch in a few days, because we use it on our server and I would notice it :)