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
Great plugin, only issue is that there is no way to disable the nametags. (In the tablist.)
EDIT: A per rank nametag config could be useful to some.
@Charlie0014
Yes, it should work with any permissions managing plugin.
Does this work with PermissionsBukkit?
@XHawk87 New version fixed it.
Thank you :D
@jor3
I have rebuilt it under the latest Bukkit API published by Spigot. The file is awaiting approval but you should still be able to download it: http://dev.bukkit.org/bukkit-plugins/rankdisplaynames/files/3-rank-display-names-v1-0-0/
If you can't, let me know and I can arrange for an alternative download link. Also, please let me know if this solves your problem.
@XHawk87
According to the update post for spigot 1.9 :
So they are not gonna change it.
I am not experienced at all with plugin creation, so I don't know if you can easily fix it?
Or is there something I can do?
The plugin itself is working fine, but the error message showing up every second makes the console unusable.
@Croc0008
The command depends on which permissions plugin you are using. RankDisplayNames can't work on its own, it is just an add-on for a permissions plugin. You can find the commands to grant permissions on the plugin page for whichever permissions plugin that you want to use.
If you choose to use GroupPermsLite, it shows you exactly what commands to type in the Tutorial under Setting up Permissions.
I created the rank Owner. Can you send me the command how to give the rank to a player? I don't understand the tutorial :c
@adopted3
The Bukkit.getOnlinePlayers() method was switched to return a collection rather than an array back in June 2014, but they also added code to make it backwards compatible for plugins that used the old return type. It may be worth reporting this to the Spigot team, as it would appear they have broken that compatibility fix. Since this is likely to affect more plugins than just mine, its probably better if there is a fix for the route cause of the problem and not individually in each affected plugin.
Hello XHawk87 friend,
Amazinging, RankDisplayNames 0.2 still works in Minecraft v1.9. However, there is an exception that repeats every 3 seconds, because of a call to org.bukkit.Bukkit.getOnlinePlayers() (no such method anymore).
Is it possible to make a release that corrects this? Pretty please. :)
Let us know, and thank you.
@WilliamLeL
You have to use a permissions plugin to assign the 'ranks.membership.YOUR_RANK_ID_HERE' rank. Please see the tutorial.
i have made an owner rank how do i use the rank
How do i assign a rank i made to other players? I do not know how to do that. Otherwise a really good plugin.
@demonqueen1982
GroupPermsLite was designed to be simpler and easier to use. Yet Another Permission Plugin is also a good one, created with similar aims in mind.
Display names can be quite tricky, as the API for changing it is simply exposed for any plugin to use, and they tend to overwrite eachothers' changes. It is a good idea to ensure there are no other plugins that could be overriding, such as Essentials nickname feature or PEx's rank feature.
@demonqueen1982
We have the following plugin permissionsEX. It seems to be a really difficult program and trying to find something that maybe a little easier. We came in to this knowing nothing about it so for us it is grrrr lol any help would be greatly appreciated. I have Skype!
@XHawk87
Yes! We have been trying to fix this issue for a week now lol. We thought maybe it was a plugin that we needed and could not find. We have yet to fix the issue.
@demonqueen1982
Hi demonqueen1982, have you tried following the Tutorial?
Make sure you also have a permissions-managing plugin installed. The example in the tutorial uses http://dev.bukkit.org/bukkit-plugins/grouppermslite/, however any permissions plugin should work.
Can anyone tell me how to get rank to display in front of their names in chat EXP: [Staffrank][Donorrank][Regularrank] Name : <chat>
I am strating up my own server and very new to all of the different plugins and commands.
@BOSSPVPER
Ensure you have followed the tutorial precisely at every step, and try relogging afterwards to make the name appear.