RankDisplayNames
By popular demand, RankDisplayNames is a means to add ranks to chat display names for players based on their group or permissions. This was designed as an add-on to the GroupPermsLite light-weight group permission management plugin, but should work with any permission management plugin.
The idea is simple, you create your group permission structure as you like it, then you create your Rank display names complete with colour codes (if you want them), and then add the "ranks.membership.[whatever the rank ID is]" permission to each group you want to have a display prefix. Any player you add to that group, or assign that permission will have that rank. Simple, easy, no fuss, just set it up and get on with running your server.
Important note: This is an ADD-ON for a group permission management plugin, as such it DOES NOT handle adding players to Ranks. For that you must have installed and know how to use a permissions plugin to grant players the ranks.membership.[rank ID] permission for that rank
If you are not familiar with Bukkit permissions, you can read up on them here: Understanding Permissions and in the FAQ
If you have any trouble, you can find detailed instructions in the Tutorial
Features
- Simple and easy to manage ranks
- Clear and concise command descriptions
- Ability to create, edit and delete ranks while the server is running
- Advanced users can manage ranks offline using the config YAML
- Ranks tie in with the Bukkit permissions system, so can be assigned to players or groups using permissions
- Supports colour codes for ranks using the % sign as well as §
- Players holding to a rank will have it prefixed to their chat display name
- Detects rank changes for players within a second and updates their display names accordingly
- Sets player list names to match rank colour
- If the TagAPI is installed, also sets player overhead name colour to match the rank
- Supports LanguageAPI for international and multi-language servers (see Translations)
Possible Future Features
- Full customisation for display names, including suffixes and possibly string mutations
- Separate customisation for list tab names, including the option not to interfere with either name for compatibility with other plugins
Commands
Command | Permission | Description |
---|---|---|
/RankCreate [rank ID] [display name] | ranks.commands.rankcreate (default op) | Creates a new rank with the given ID and display name. Display names can contain colour codes and spaces, IDs cannot |
/RankDelete [rank ID] | ranks.commands.rankdelete (default op) | Deletes an existing rank |
/RankEdit [rank ID] [display name] | ranks.commands.rankedit (default op) | Changes the display name for an existing rank. Display names may contain colour codes and spaces |
/RankList | ranks.commands.ranklist (default op) | Displays all ranks with their permissions and display names in order of precedence |
/RankReload | ranks.commands.rankreload (default op) | Reloads ranks from the config.yml, allowing you to load in changes to it without restarting the server |
Permissions
- ranks.admin (default none) - Grants all ranks.commands permissions
- ranks.membership.[rank ID] (default none) - [rank ID] should be replaced with the rank ID, grants membership to a rank
Installation
- Unzip RankDisplayNames.zip into your plugins directory
- (Optional) If you want overhead display name colours, download and install TagAPI
- (Optional) If you want to provide support for other languages, download and install LanguageAPI
- Restart your server
Tutorial
Compatibility and Troubleshooting
This plugin will not be compatible with any other plugin that changes player display names, list names or overhead names. If you can, turn those features off, or disable those other plugins before enabling RankDisplayNames.
This plugin uses Java 7
If you get the followed error on starting up the server with this plugin installed "Unsupported major.minor version 51.0". This means you are using an out of date version of Java. If you don't know how to upgrade, please contact your server hosting provider and ask them for help in upgrading to Java 7, or contact Oracle customer support. Mac OS X users require JDK 7 instead of JRE 7.
Donations
If you'd like to contribute towards the continued development, support and maintenance of this project, please consider joining me on Patreon, and making a one-time or recurring pledge.
Help
If you need help you can leave a comment below and I will get back to you as soon as I can. You can also join my IRC chatroom using the following link. Please note, I am not always at my keyboard! http://webchat.esper.net/?channels=XHawk87&prompt=1
Hey its me again.... I was wondering how do u give somone a rank and it appears when they talk infront of there user i followed the tutorial and still i cant..
@Warmedpie7
Using any permissions managing plugin. If you are using GroupPermsLite, you can type:
/GroupGrantPerms MyRankGroup ranks.membership.myrank
/GroupAddPlayer MyRankGroup Warmedpie7
How do i add perms to a rank i made?
@Ricky1NL
As it states in the big red text above, RankDisplayNames is an add-on for a permissions managing plugin, you need to use a permissions managing plugin to grant the player the permission for that rank. All information you need are displayed on this page, and you can also click the big "Click here for tutorial" link for step-by-step instructions.
hi i have the plugin its great but houw do you get it i have make ranks but houw do you join a rank pls help. sry for my bad englishe
@XHawk87
Thank you so much for answering.
I talked to the player, and he said that he is NOT getting disconnected, so that's good. Also, the exception is listed only as a "warn." Nevertheless, I'll share the paste here for you to have a look.
/version gives:
Thanks for looking into this. :-)
I blanked out the player's name and IP address for his privacy.
http:pastebin.com/sj5bNggU
Paul
@adopted3
The 16-char limit for the player list tab (at the top of the screen when holding Tab), includes the colour code for their rank, but not the full rank. It does truncate names longer than 14 character (+2 for the colour code), and this has been working correctly since 1.5.2. There must be something else at work here.
Please send the full stack trace of the exception from your server logs in a http://pastebin.com link. Also, please give details about which server version you are using. If you are not sure, use the /version command.
RankDisplayNames is generating an exception when one of our players types in chat: "Player list names can only be a maximum of 16 characters long"
It seems that he disconnects too whenever he joins the server and says "Hi." :-(
His name is exactly 16 characters long, and the rank in front of his name is [Trial-Mod] with a color code.
Does the 16 char limit include the Rank tag?
Either way, is there any way around this? I'd sure be happy if the plugin just truncated the name or something.
@XHawk87
Yeah, XHawk87, it would be great if we could get nicknames going. Thanks for considering it.
@xXEmmaLieXx
I was thinking of redesigning this plugin at some point. I will look into compatibility with a wide-range of other plugins when I do that. It could be a while though as I have a number of other projects that also need my attention.
Hello! So I know that this plugin is incompatible with other plugins but I was wondering if you could make it so it is compatible with Essentials. You can't have nicknames with this plugin and I need to use a nickname plus the rank name. If this is possible please consider it. Overall great plugin!
@reigs1
You need to use a permissions managing plugin to grant yourself the permission node for that group. As it says in bold red letters on this page.
@dhl2002
Please use http://pastebin.com to retain formatting, and also include the configuration file for your permissions managing plugin.
this is all that is in the config owner1: '&4owner' 1owner: '&4owner' 2owner: '&4owner'
How do I join my rank? Its called %cOwner?
@dhl2002
IDs are case sensitive. Make sure it was typed exactly right, including the correct capitalisation. Also, reconnecting may be necessary to make prefixes show up immediately. Otherwise there may be a short delay before it appears.
If you still have trouble, send a http://pastebin.com of your configuration files and i'll see if I can find the problem.
i made the tank then i did /groupaddplayer ranks.membership.1owner dhl2002 but it didn't prefix me
@dhl2002
This only works for prefixes. If you meant suffixes, then no. It wasn't designed for that. Perhaps in a later version it may become more customisable.
hi it all works but is there a way it prefixes the name
@EpicN1nja11111
It is not a bug. RankDisplayNames was created before the scoreboard feature was implemented, so it relies on changing a player's tab list name or overhead name to add characters. Minecraft clients have the 16 character limitation, and there is nothing we can do about that. The scoreboard teams feature gets around that limitation by applying its own special prefix. The TF2 plugin was most likely created or updated later and uses the scoreboard feature.
@XHawk87
Ok thanks, just wanted to confirm, this is a bug with RankDisplayNames right? Because when the players with white names because of 16+ chars issue plays my TF2 gamemode, their name colour in the tab will change to the team colour that they are on (red or blue), but the people that have coloured names do not change to red or blue, im not reporting any bug or something because of this TF2 thing (as that would be for the TF2 guys to fix) but im just using it as an example. Again, thanks