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
-
View User Profile
-
Send Message
Posted Mar 16, 2013@XHawk87
Ok and what does ranks.membership.[rankID] mean?
-
View User Profile
-
Send Message
Posted Mar 16, 2013@WMPminecraft
In which case, the tutorial above will tell you exactly how to add permissions for RankDisplayNames.
-
View User Profile
-
Send Message
Posted Mar 16, 2013XHawk87 I use the GroupPermsLite plugin and i think u run that correct?
-
View User Profile
-
Send Message
Posted Mar 16, 2013@XHawk87
Ok thx for the help - btw i am new to plugins so i am still trying to find out the basics
-
View User Profile
-
Send Message
Posted Mar 16, 2013@WMPminecraft
Adding players to Ranks is NOT handled by RankDisplayNames. It is handled by your permissions plugin. You assign the rank.membership.[rank ID] permission to the player and they will hold that rank. If you do not know how to do this, you should consult your permissions plugin page, or the in-game /help for that plugin.
-
View User Profile
-
Send Message
Posted Mar 16, 2013@XHawk87
I have got all the necessary plugins its just in-game i am not sure how to give ranks to other players!!!! what is the in-game command
-
View User Profile
-
Send Message
Posted Mar 16, 2013@WMPminecraft
Please read the writing in large bold red font at the top of this page.
Please see the answer to the last 3 questions asked.
Also, please read the tutorial using the giant link above.
-
View User Profile
-
Send Message
Posted Mar 16, 2013How do I make myself an [Owner] ? I have made The rank but I am not sure how to make myself [Owner]. Please help!
-
View User Profile
-
Send Message
Posted Mar 11, 2013@WeiUberstriker
There are no ranks but the ones you create using /RankCreate [rank ID] [display name]
-
View User Profile
-
Send Message
Posted Mar 11, 2013What is the Rank ID for Owner?
-
View User Profile
-
Send Message
Posted Mar 10, 2013@PwnagePasty
You grant them the permission rank.membership.[whatever rank id you gave [Owner]].
-
View User Profile
-
Send Message
Posted Mar 9, 2013How do I add my own rank [Owner] to a single player
In this case PwnagePasty
-
View User Profile
-
Send Message
Posted Mar 9, 2013@igorvanloo
This is an add-on for a permissions plugin, it uses permissions to give ranks to players. You must assign the rank.membership.[rank name] permission to players in order to assign them to that rank.
-
View User Profile
-
Send Message
Posted Mar 9, 2013I think you misunderstood me, I don't want to add permission's yet I want to get a Player to get my rank. Where do I give the player the rank.membership.Developer, I am confused? Ty for replying so fast btw!
-
View User Profile
-
Send Message
Posted Mar 9, 2013@igorvanloo
You can use any permissions plugin to add the permission for the rank to a player or group. If you don't have one, you can try: GroupPermsLite, the group permissions manager this add-on was created for.
See the Tutorial above for details.
-
View User Profile
-
Send Message
Posted Mar 9, 2013Ok I have made my ranks but where do I add my rank.membership.Developer or whatever to the player? And how what type of format? Ty!
-
View User Profile
-
Send Message
Posted Feb 24, 2013@NeonStreaks
If your rank ID for [Co-Owner] is for example "coowner", then you give your friend the "ranks.membership.coowner" permission and they will have that rank visible.
This plugin is designed as an add-on for a group permission management plugin, so it works best if you have established groups in your permissions plugin first. This way you can give a group the "ranks.membership.[Whatever Rank ID you want]" permission, and everyone in that group gets that rank automatically.
-
View User Profile
-
Send Message
Posted Feb 24, 2013I have a question, I have made all my ranks needed in my serer, but I don't know how to add someone to the rank. For example, I wanted to add my friend as [Co-Owner] but I have no idea how.
-
View User Profile
-
Send Message
Posted Feb 23, 2013@Onster1974
Its not complicated, it just doesn't work like that. This is an add-on for a group permissions manager. The idea is to set up your groups and then use this to give display ranks to each group.
-
View User Profile
-
Send Message
Posted Feb 23, 2013How do you rank? This is kind of complicated, because there is no /rank or anything