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
@blueslime360
You know you really should edit your post instead of double posting.
Here is the page for the permissions.yml: http://wiki.bukkit.org/Permissions.yml Here is where you should ask general Bukkit questions: http://forums.bukkit.org/
ranks.admin grants permission to use all of the admin commands in RankDisplayName for if you want to give a non-op that ability. You use a permissions plugin to do this. If you are not familiar with how to do this, once again, that is a general Bukkit question and you should ask the Bukkit community using the link above.
and again can i use this permission ranks.admin
well where can i find how to do it properly?
@blueslime360
Its saying you have not edited the permission.yml file correctly. Be sure to read the documentation for it and use proper YAML formatting. That means no tabs, keep the correct number of spaces for indentation at all stages throughout etc. This is general Bukkit stuff, the best places to get help are the forum and the #bukkit IRC channel.
hey i need help in what kind of permission to put cuase this comes out
Server permissions file permissions.yml is not valid YAML. java.lang.ClassCastException: java.lang.String cannot be cast to java.util.Map at org.bukkit.craftbukkit.v1_5_R3.CraftServer.loadCustomPermissions(CraftServer.java:626) at org.bukkit.craftbukkit.v1_5_R3.CraftServer.enablePlugins(CraftServer.java:270) at net.minecraft.server.v1_5_R3.MinecraftServer.j(MinecraftServer.java:304) at net.minecraft.server.v1_5_R3.MinecraftServer.e(MinecraftServer.java:283) at net.minecraft.server.v1_5_R3.MinecraftServer.a(MinecraftServer.java:243) at net.minecraft.server.v1_5_R3.DedicatedServer.init(DedicatedServer.java:151) at net.minecraft.server.v1_5_R3.MinecraftServer.run(MinecraftServer.java:382) at net.minecraft.server.v1_5_R3.ThreadServerApplication.run(SourceFile:573)
@slangen099
I have already answered that question dozens of times below. Why not simply read the answer instead of asking again?
How to add some1 in the rank!!!!!!!!
@darkparatroopa
This is an add-on for a permissions plugin, therefore the only way to assign a player to a rank is to grant them the permission for the rank e.g. for a group with id 'admin' you assign the ranks.membership.admin permission to any players you want to have the admin rank.
If you don't understand Bukkit permissions you can read up on them here: http://wiki.bukkit.org/Understanding_Permissions
The tutorial explains exactly how to add permissions to a player for a rank: http://dev.bukkit.org/server-mods/rankdisplaynames/pages/tutorial/
Hi,
Im a little confused about the perms, how do i access it? Also Im a little confused about how I add myself and others to the ranks? If you can answer these two questions in almost simple English i would definitely reccommend this plugin.Thanks.
Hi XHawk87,
Thanks for this adorable plugin. I am finding such plugin like this because I can't see my prefix in-game. Now, I found it. Thanks again.
@TheTGKing
You cannot do anything else that changes the player display name.
oh i got it to work. but is it possible to still be able to do /nick bc i cant do it now.
what about MultiVerse?
@TheTGKing
Factions changes the display names of players in order to add their teams. This is not compatible with RankDisplayNames.
i have essentials, factions and cuseban. those r the chat ones.
@TheTGKing
It is your responsibility as the server administrator to know what all of the plugins installed on your server are for. You tell me if any of them are chat-related. I am not going to list all known chat-related plugins on BukkitDev, there are hundreds.
like what
@TheTGKing
Do you have any other chat-related plugins running?
yes i did
@TheTGKing
Did you assign the ranks.membership.[rank id] permissions to the desired groups?