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
hoe geef je iemand een rang
@hweigel
Yes, if you are using any other chat-related plugins that modify player display names it will likely interfere with RankDisplayNames. If possible, you should disable any other chat-related plugins, or those specific features of those plugins, to ensure maximum compatibility.
i made a group using group perms and made the same on on ranks display but niether of them are showing me my rank. I have myself nicked ServerOwner, should i unnick myself?
@waffles87ace
That error message has nothing to do with RankDisplayNames at all. It means you are trying to modify the permissions or players of a group that does not exist. Create the group or make sure you are typing it correctly. You should read the plugin page and command help for GroupPermsLite.
No, I cannot set the id. When I use GroupsPermsLite, it says, unknown group. See for yourself. 198.24.180.210:25728
@waffles87ace
The only glitches come up when used alongside other plugins that attempt to do the same things. It is not possible to use more than one display name altering plugin at a time, unless those two plugins were designed to work together. Those features in other plugins will need to be turned off to avoid conflicts.
Also, the TagAPI is not compatible with the scoreboard teams prefix feature. You will need to turn off team prefixes if you want to use the TagAPI.
This is reallllly glitchy.
thanks for the quick response. I will try and see if I can get your plugins to work.
@XHawk87:
Hi again, and sorry for the trouble I'm still having the same problem which is only the color name changes. I did what you have said, took off all of my plugins leaving the TagApi, RankDisplayNames, and PermissionsEx, edited the PermEx to disable the group prefix's from it. and still nothing happens only the color of the name changes.
here's my YML RankDisplayNames: http://pastebin.com/vQFeFJc9 PermissionsEx: http://pastebin.com/xNn4gZEe
@bossbalugz
You haven't set up the "ranks.membership.1Admin" permission for the Admin group in PEX.
Also be aware that the PEX #prefix also modifies player display names, so using it will conflict with RankDisplayNames. Essentials is also able to modify player display names, so may also conflict with it unless you disable those features in their configuration files. Generally you should only allow one plugin on your server to manage and modify player display names, so it is best to check all of the configuration files to make sure no other plugin is doing this.
help please, Display name it not showing up but only changes its colors
here is my config.yml for rankdisplaynames plugins 1Admin: '%5[Admin]' 2BCStaff: '%1[BCStaff]' 3VIP: '%6[VIP]' 4Trusted: '%2[Trusted]' 5Respected: '%a[Respected]' 6Citizen: '%7[Citizen]' 7Newcomer: '[Newcomer]'
my perm using PEX http://pastebin.com/sKkVZ2yJ
and these are my plugins AuthMe, CompatNoCheatPlus, dynamp, Essentials, mcMMO, NoCheatPlus, PermissionEx, PhatLoots, TagAPI, Worldedit, Worldguard, WG CutomFlags
@kowuaou
I am not sure that I understand you. Ops do not get any of the ranks.membership.[rank id] permissions, nobody gets any of those permissions by default. They must be assigned by a permissions plugin, so being an op cannot have anything to do with it.
The order and priority of ranks, if a player is assigned multiple ranks, is to take the first rank ID alphanumerically. from 0-9 then a-z. If you want to give a certain rank a higher priority than others, then prefix the rank ID with a lower number.
This is all detailed in the tutorial, and on the plugin page. If you want to report a bug, I would ask that you read and understand how the plugin works before attempting to report it. When reporting a bug, you should include details such as: logs of any errors on the console in a http://pastebin.com, the steps you took to reproduce the bug, copies of your config.yml files in a http://pastebin.com. Otherwise I will not be able to help you, nor will it help me identify any problems.
This plugin has flaws with the ops. If you are op and setup as an Operator and have a permission of an Operator RankDisplayName rank it display's the rank colour before the one which it is supposed to be.
@XxPredatorz01xX
It may help if you tell me what you actually did.
@XHawk87
i have done this, but when i talk in chat, it doesn't show the name.
what am i doing wrong?
@GreenGrizzlyBear
You can use any permissions plugin that uses SuperPerms (the built-in bukkit permissions system). I believe GroupManager supports SuperPerms.
Does this support groupmanager? Sorry if its in desc and i missed D:
@puckman1971
That all sounds correct on this end. You can send me a http://pastebin.com of your config.yml for RankDisplayNames to make sure, but the problem may be with PermissionsBukkit. I am not familiar with how that works. Are you sure that the desired players do have that permission?
Hi guys, having some problems getting this working.
I activated the plugin. Created ranks like this 2Admin: '%c[Admin]' in the config file Added ranks.membership.2Admin: true to the config file of the PermissionsBukkit plugin and then restarted the server but nothing happens.
I can do a /ranklist command that shows all 5 ranks I created but when I talk it just shows my username in chat. I want it to display my rank.
Where am I going wrong?
@Natex27
The rank is applied as soon as the ranks.membership.[id] permission is granted.
Hey @XHawk87 looked in the tutorial and it said nothing on how to apply a rank. >:/