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
Hi Amunak, Is PrefixedPlayerlist compatible with MC 1.1 (Bukkit #1818)? Thanks.
@felipepcjr
You can just make anything you want to ignore an empty string:
You should add an option to ignore defaults on the list.
Are you still updating this? There's no 1.0 version.
@Inspector94
Sure. In config, the option is not actually to use or not use PEX, but to take prefixes from PEX. Disable that and define prefixes in the config. Then assign the permissions for defined prefixes (it doesn't matter if you use bPerms or PEX as your permission system) and it should work.
This config should be fine for you:
Assign prefixedplayerlist.prefix.admin to your admin group. They should get the prefix [A].
it doesn't work with Essentials which judging by the popularity of essentials is a huge problem..
Is there a way to have it use pex but not the prefix defined in pex? I have pex, and herochat which i would like to have it say [Admin] but for the player list i want it [A] as well as my other groups.
@nedercraft
eh edited what?
edited, had stupid stupid typo :(..
@deleted_7536780
Honestly, I don't know how to handle that. Is everything else working as expected?
@Amunak
Thanks, when i stop my server i get this.
23:39:54 [SEVERE] Error occurred while disabling PrefixedPlayerlist v1.0.6 (Is it up to date?): Player list names can only be a maximum of 16 characters long java.lang.IllegalArgumentException: Player list names can only be a maximum of 16 characters long at org.bukkit.craftbukkit.entity.CraftPlayer.setPlayerListName(CraftPlayer.java:149) at amunak.prefixedplayerlist.PrefixedPlayerlist.onDisable(PrefixedPlayerlist.java:51) at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:176) at org.bukkit.plugin.java.JavaPluginLoader.disablePlugin(JavaPluginLoader.java:978) at org.bukkit.plugin.SimplePluginManager.disablePlugin(SimplePluginManager.java:296) at org.bukkit.plugin.SimplePluginManager.disablePlugins(SimplePluginManager.java:289) at org.bukkit.craftbukkit.CraftServer.disablePlugins(CraftServer.java:166) at net.minecraft.server.MinecraftServer.stop(MinecraftServer.java:325) at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:404) at net.minecraft.server.ThreadServerApplication.run(SourceFile:417)
@deleted_7536780
I assume you are using PEX for prefixes. You could use then prefixes in config. But well, I suppose I can add this option.
Also... Do you have idea how the null get there?
I'll implement showing colors only in the next minor version.
Edit: Done! :)
@Amunak can we have an option so it just shows the Color not the entire prefix? xD
i get
@RustyDagger
it's not the best idea to delet the prefix stuff because it loads defaults then. Better just set them to '' (empty string).
I've had some problems with PEX not registering, but it should work in most cases. What's your version of PEX? What version of PrefixedPlayerlist do you have?
Does my plugin output any error? (Does it say it can't hook into PEX?)
And about the suffixes... You mean you could use those too?
There's a problem with too complicated prefixes/suffixes that they are too long and I then have to shorten your nick.
I cleared out all the prefix stuff in the config and set it to use the prefix from PEX and nothing happend it did not work. my name is just white when it should be (O)RustyDagger
With colors and all ofc brackets are red O is light blue so is my name Also my format will not look right because i need the suffix any way because i have a < before my name. and a > after my name.
all in all pretty fail this would be better done by a full chat plugin.
EDIT seems the plugin is not finding PEX thus causing my issue... the PEXSetRank Plugin was having the same issue maybe this is a pex problem or you need to update so that it works.
@deleted_7536780
Just lower your maxplayers count ;)
How can i get my Player List to be like yours, one colum not like 3 colums..
@Tauryuu
Of course.
Actually, creative is now prefix for survival, because there is a bug in the CB.
I didn't thought it could be usefull, but I'll implement it in v. 1.0.3
Edit: Did it already... The file isn't accepted yet, but you can download it under the big "download" on the top of this page. It's my dropbox folder.
Can you add prefixes for Survival too? :)