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
After the builds from 6th december, prefixedplayerlist doesn't seem to color the TAB list anymore
@JeterLP
When it is needed, i.e. with the official Minecraft mod API. The plugin still works fine and there are no known bugs. The only thing missing are some planned features that I'd like to make, but find myself lazy to implement. I've been through reinstall some time ago and I'd have to re-download everything (eclipse, libraries, API SDK) again and find my old source codes. And I find that unnecessary since we have been promised the official API :)
Does this work with Essentials?
@Jobsti84
Good idea. It might make managing names easier.
@QweSteR2221
It still works. I'm sorry to say that, but since the mod API is announced, I'll wait with an update for the API. Everything will probably break at that time anyway.
upd?
Great thanks....
Not tested yet, but support for &l &o &n... would be nice. (Did this work on the Playerlist?)
And an idea: a tag like %name% for the prefixgroups, so we could do this: custom: admin: '&4someTAG-&5%name%-&4sometext'
@doggyroc Yeah, it actually still works with 1.3.
@Jobsti84 Well finally that's a reason to update. I've currently done nothing from the last version, so it might take a while (and I will be on a vacation for about 20 days), but that's definetly something I want support.
Hey, works great with 1.3.
But we want a little Update: prefixAdventure ;)
Yay! 1.3!
@DJ411 It is probably the same bug as the one mentioned on the top of this page.
The autocomplete feature of chat is affected by the prefix/color you use. It's only a small problem with pure prefixes, but colors 'disable' the autocomplete. There's nothing I can do since it is client-side. Hopefully it can be fixed once there is the mod API.
Sorry about that, but there's nothing I can do. The best thing to solve this is to not use colors and use some easy prefixes (like M-<playername>). Then you just type M-pl and press tab - and you have M-playername autocompleted. In all other cases you have to just get on with not using either PPL or autocomplete. The "f" in the end is the color tag that fixes ping color.
is it me or when i use tab to complete user names it puts an f at the end of each name? any one else getting this...
@ArttuJarvinen As I said in my last post - It uses superperms, so it works with everything that uses them. Plus, there's the PEX bonus
@Koiraman What's your config? I can't help you if you aren't specific.
@MirageCreative I'm afraid that making letters colored is impossible. Primary goal of PPL is to allow prefixes for player groups distinction, not to make fancy names.
Hi, how do I make only some specific letters of my name colored? My name is PenguiN_x and I want it to be &6P&8enguiN_x on tab and /nick doesn't work/change the color on tab in 2.9.2.
Does it work with GroupManager?
I see on playerlist: [Rankname]Player and not: &cPlayer
Im Using PermissionsEx.
@fjutte It uses superperms, so it works with everything that uses it. Plus, there's the PEX bonus :)
@polo3400 What errors, please?
Please update! This works but it is creating errors! It is perfect but it need to be 1.2.5!
Does this work with PermissionsBukkit ?
@np98765 I'm planning to add that feature, but I neither have time nor enthusiasm to do so.
@KrisKristoffer See Additional notes, the first paragraph. And use the code block to display your config next time.
@QweSteR2221: No, have you found a bug?
@mazius123 As @djaddi said, that's not a bug. Relog is enouth. You can also reload the plugin. I might add a command to "refresh" the list manually.
@xReyko You do that by assigning permissions. Please, read either the Example setup or comments in the default config file.