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
Works fine on 1.7.10 protocol hack but i want the option to change the refresh time or a feature that everytime u came to the hub it refreshes automatically
Doesn´t work on Spigot 1.8. Please update it.
@VizionStudiosMc
Probably... Just try it.
Dose this work on bungee ProxyTablist.
@Nero9000
Unfortunately the nick is limited to like 14 characters or so because of Minecraft limitations. And the colors count towards this limit.
Hello. Your plugin doesn't show full nick in the TAB. I switched : == usePEXPrefix == to == true == and it works fine, but i shows just part of nick. What do i do bad?
@tobster78
I hope it does, I couldn't test it though.
@Amunak Does this plugin still work?
@nadir7379
You don't need it for GM. There's a way to do it without this plugin.
@JoRouss
It cuts your name when it would exceed 16 characters (formatting included). This is a Minecraft issue, and it can't be fixed without a client-side mod. I think that Mojang either already released this limitation in one of the newer snapshots, or it is at least planned.
About the second issue... The plugin assumes that you either are a permanent op, or you aren't an op. Usually you just op a player, and let it be like that. So you can refresh the prefixes yourself or just tell the new OP to relog, and he will be marked correctly. If you switch ops on or off often, this becomes a problem. I could probably fix it, but I'd have to monitor the op event, and because it is such a marginal case, I think it's not necessary.
@nadir7379
You can run this plugin with any permission system. It is just that it can load the prefixes from PEX database. You don't have to (and i guess most people don't) use the PEX connection.
Hello, U said that u only can run this plugin with PEX, Please do something that the plugin will work with Groupmanager too! Thanks.
@Amunak
Great plugin! Exactly what I was looking for!
Only a few problems :
- It sometimes cut my name (JoRouss) (JoRous...) Seems randomly.
- I did set it so Admins from PEX have their name in red, and a player being OP prefix set to "*". However when I log in as OP, my name appears yellow until I do /ppl refresh.
- When I switch from OP to not OP, I have to type /ppl refresh to update the list :(
Thank you very much for helping me :)
@SiNiSa37
So... Does that mean that essentials add the prefix? I don't know what essentials does, but if you turn off my plugin for a while and look at the nicknames, are they with the full PEX prefix or are they just names - as they should be?
I need to know if it's a bug on my part or if the prefix is added by essentials or something.
Maybe try to set this in essentials:
and next time format the config please (using the "cogs" symbol) so it can be shown here properly ;)
There's a bug if someone have a Essentials-nickname. Then you can see the full PEX prefix with nickname but i only want to see the original name with color which i wrote in config.
pls help
pplconfig: true options: checkVersion: false usePEXPrefix: false useColourOnly: true prefixgroups: general: default: '' op: '' creative: '' adventure: '' survival: '' custom: owner: '&4' admin: '&c' builder: '&9' youtuber: '&3' moderator: '&5' vip: '&6' spieler: '&a'
@p82183645
Not without a client mod - the limit is hardcoded in Minecraft to 16 characters.
Title length limit to cancel? There are ways?
@PapaHarni
That's what you can do. You just have to assign correct permissions to these groups.
Use this config (for prefixgroups > custom)
And then to the group Guest give permission prefixedplayerlist.prefix.Guest, to Player give prefixedplayerlist.prefix.Player, etc.
Hello,
Can u add per group prefix pls?
Like this :
Máš super plugin.
@Slind14
I'm not sure what you mean. Is that another plugin that displays the [AFK] there, or do you use PPL for that? What do you mean by double? Is the problem that the [AFK] doesn't show in the TAB player list?