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
@EpicN1nja11111
There is a hard limit of 16 characters for player overhead and tab list names, this includes the colour codes which take up 2 characters each. You can use the scoreboard teams feature http://minecraft.gamepedia.com/Scoreboard#Teams to add colours to tab list names without removing characters, so long as you aren't already using it.
There are also a variety of plugins that allow you to truncate a players name to remove extra characters off the end and make space for the colour codes. Skript can do it, and I believe Essentials has a command to do it.
@XHawk87
yea, they all have long names like 15-16 chars. How do I fix this? So their names can be seen in colour in the tab list? Is there a way to fix without remove chars off their names? and if not, how do I remove chars off their names?
@EpicN1nja11111
Is there anything special about the players that don't get it? Are they all in the same group or set of groups? Do they all have very long names (15-16 chars)?
Do you have any other plugins that might alter player display or list names, or make use of the scoreboard teams feature? Any such plugins, or the scoreboard, could possibly override name colour changes.
Most of my players get the colour of the display name when they join, but there are a few players that do not receive the colour when they join, they do get all the other permissions though (im using grouppermslite) also, when they type in the chat, their name colour changes, but its just in the tab list where its still white. help?
@tdixon
It is quite possible that PEX's prefix feature is overriding any changes made by RankDisplayNames. Try turning that feature off if you want to use RankDisplayNames instead.
Does this work with PEX? I have added ranks.membership.1Warden To the warden rank (just as example) so that it will show up as [Warden] on the display name, Nothing seems to happen. It could simply be that this does not work with PEX. Maybe im doing something wrong? Correct me if i am please! thanks
Here is a paste bin, look at what im doing http://pastebin.com/pdySsZvf
@JoeyJoe2000
By granting them the permission, as it says in giant bold red letters at the top of the page.
how do i assign my created ranks to players?
@ajbboy123
Yes
So does this support format codes to like %l for bold So I can have my name be Example
@brinaq
Nothing should be getting reset unless your configurations are failing to save.
It may be that your server doesn't have write access to the folder where RankDisplayNames is installed, or there is some error when saving or loading that is preventing it from picking up the recorded settings. Please check your console for errors thrown by RankDisplayNames, and http://pastebin.com them to me if you find any.
Incidentally, you may wish to avoid using the /reload command as it is known to cause issues on CraftBukkit servers: https://forums.bukkit.org/threads/petition-to-remove-the-reload-command.43212/
if I reload or restart the server all the ranks get deleted and i have to /rankcreate every one of them all over again. :(
@lbeast762
You can set the ranks to be whatever you want. That's kind of the point...
Can you please make one of the ranks Owner please?
@laacis2
Currently the ranks are prioritised alphanumerically based on their ID. This is explained in the tutorial under "Choosing your Rank IDs": http://dev.bukkit.org/bukkit-plugins/rankdisplaynames/pages/tutorial/
In my situation unfortunately i have multiple rank color permissions apply to one player, so it will not change color to current rank. Could you make a priority system where higher numbers override in order to determine color? such as /rank create [rank] [priority] [displayname] Thanks.
Other then that works perfectly well
This a very good plugin and I would thoroughly recommend it to anyone looking to add Rank Display Name tags to their Minecraft server. It is very easy to set up if you follow XHawk87's tutorial at: http://dev.bukkit.org/bukkit-plugins/rankdisplaynames/pages/tutorial/
Two things to ensure you set up correctly. 1. Make sure you have granted all permissions correctly using the exact same [ID]s 2. Make ENTIRELY sure you have no other display name changing plugins active on your server at the same time.
As I can see XHawk87 has explained both of these factors countless times in the comments section, but if you just follow the tutorial explicitly, it works perfectly!
Keep up the good work XHawk87 and continue to make brilliant plugins!!
@siep2
Translated as "I do not get it, you can just give the text how you make me admin I *hotttt bijvoorbeel* (Not translatable, please take care with spelling and avoid slang) siep2 enter text here with my name as admin and do the same with mod"
This is all in the Tutorial. Just follow the steps and enter the codes as it describes in there.
ik snap het niet, kan je gewoon de tekst geven hoe je mij admin maakt ik heeet bijvoorbeel siep2 geef de tekst even met mijn naam als admin doen en hetzelfde bij mod
@siep2
Translated as "How do you give someone a rank"
In order to give someone a rank, you must assign them the "ranks.membership.[rank ID]" permission, where [rank ID] is replaced with the ID of the rank you created using: /RankCreate [rank ID] [display name].
E.g. /RankCreate admin &e[Admin] would require the permission "ranks.membership.admin"
In order to do this you need to use a permissions managing plugin. If you are unfamiliar with how to do this, you should read up on Understanding Permission.
All of this is detailed above in big red text, and links are provided to the tutorial. I would appreciate it if you read that before asking any more questions.