PayRank
This plug-in allows users to self-promote themselves to a provided static set of "ranks" using money or experience. Administrators can also promote/demote and specifically assign any of the defined ranks to a user at any time without taking player money or experience.
A "rank" is defined as a group and you can have as many of them as you like. Each "rank" allows you to define the price, experience cost, display name of the rank and the required group it will be using.
PayRank also provides simple chat coloring and formatting that can be configured to each rank.
See Configuration for further details.
Uses Metrics for sending completely anonymous data to http://mcstats.org for usage tracking.
Main - Installation - Configuration
CraftBukkit 1.4.7
The current version of PayRank appears to work fine on CB 1.4.7. No updates are needed. If you find a specific problem, please report it.
An update with new features will be made available as time permits.
Dependencies
Please note the following:
- PayRank requires plug-in Vault for managing both permissions and economy.
Commands
This is a list of the available commands that can be used:
Command | Description |
/payRank help | Displays help depending on other permissions. |
/payRank purchase | Increments the player to the next rank, if they can afford it. |
/payRank list | List all available ranks and their prices. |
/payRank promote <player> | Promote the user to the next rank regardless of cost. |
/payRank demote <player> | Decreases the player to the previous rank. No refunds ! |
/payRank give <player> <rank> | Give the user the exact rank regardless of level and cost. |
/payRank remove <player> | Removes the current rank from the user entirely. |
/payRank current [player] | Displays the current rank assigned to yourself or if given, the player. |
/payRank reload | Reloads all the configuration files for the plug-in. |
Permissions
This is a list of the available permissions:
Permission | Description |
payrank.list | Ability to list all available ranks. |
payrank.purchase | Ability to purchase a rank. |
payrank.promote | Ability to promote other players to the next rank regardless of cost. |
payrank.demote | Ability to demote other players to their previous rank. |
payrank.give | Ability to give a user the exact rank regardless of level and cost. |
payrank.remove | Ability to remove the current rank from a user leaving them with no rank assigned. |
payrank.current | Ability to see the current rank of yourself. |
payrank.current.others | Ability to see the current rank of others. |
payrank.reload | Ability to reload the plug-in configurations. |
Latest Changes
Version 1.2.3
- Updated to support CB 1.3.2-R1.0
- Appears to support CB 1.4.7-R1.0
Version 1.2.2 - For Bukkit 1.3.2-R0.1 ONLY
- Changed event PlayerChatEvent to AsyncPlayerChatEvent to support other chat plug-ins better (Factions for example)
Version 1.2.1
- Fixed issue with world permissions using bPermissions
- Fixed minor display bug in /payrank list
- Added additional bugging code
- Added usage of Metrics for sending completely anonymous data to http://mcstats.org for usage tracking.
See the Change Log for further details.
Coming Soon (still in planning)
- Multiple rank tree's. Ability to have several tree's in which users can be ranked within.
- Ability to assign multiple groups to a single rank so you can combine groups.
- Self-promote based on time spent in game (optional separate rank tree)
- Self-promote through signs.
- Other suggestions ?
Reporting errors
If submitting an error, please try to provide as much details as you can. Example: (but not limited to)
- Commands run
- Configuration files
- Permission manager used
- Bukkit version
- Detailed steps to reproduce (should it not be just the commands)
Any or all of the above will go a long way in helping me resolve your problem quickly and efficiently. All tickets will be looked at, but those that are written best will take priority.
@shaneparsons2012
All great idea's thanks. I'll add these to my list of things to try and get out for a new build, but things have been insane at work so I've been short on time. Hoping to start working on this again really soon though !
Hey, I have just installed your plugin on my server, it is perfect. I know you can customize the message strings but you cannot customize the colours in resources.json could you possibly add custom string colours to the plugin? So for example I could do ""&6You &ahave &6been %agiven &6the &arank &6of: &c<rank>."." Also is it possible to add a default rank? So for example when someone new joins the server they are automatically ranked as a "[Guest]". In the payranks.json file you could have a option to set default rank. For example ""defaultrank": "true/false"," as when a new player joins and uses the /payrank purchase command they end up been in 2 permission groups for some unknown reason.
Thanks so much if you can pull this off! Please PM me back soon. Regards Shane.
@ziga808
Okay, please PM me pasties of both the PayRank config and your ColorMe config files. I can try and test locally, but without these I can't go much further.
I use old version of ColorMe now and it works with PayRank but when i update to the current ColorMe version the tag i had for example : [Newb] is gone-not shown,just like it was with factions.
@ziga808
Okay that plug-in doesn't surprise me that it'll conflict. Did it work before? Can you send me your configurations for PayRank and ColorMe and describe what specifically isn't working. I can look into it, but not sure if the two can continue to play nicely, but we'll see.
Okay PayRanks are now working with factions but are not working with new ColorMe version http://dev.bukkit.org/server-mods/colorme/files/9-v3-5/
possible to fix?
@smilne74
Thanks alot but you could just upload it to www.gamefront.com and post link in a comment beacuse it can't wait.Faster to get the PRO plugin better it is xD
@ziga808
Good catch, thanks.
Uploaded a quick fix for that issue. Seems to be working correctly on Bukkit-1.3.2-R0.1 and Factions 1.6.9.1.
Not sure when it'll be approved, last one took almost 24 hours, but check back soon for it to show up.
PayRanks are not working with Factions plugin http://dev.bukkit.org/server-mods/factions/files/43-1-6-9-1/
Please make it work with factions beacuse i think faction is really important plugin too.
@dragonfire967
You are correct, the player is only kept in one rank at a time and are removed from the previous rank when moved into another one.
That said though, sadly PayRank currently only supports a single tree of ranks available to someone. I have been meaning to add this feature to allow for multiple trees, but haven't found the time yet to do so :(
Hey smilne, question. When someone purchases a rank, does it remove the previous rank they held, or do they have both? I'm wanting a system where there are like 4 trees (mining,economical, political, industrial) with multiple ranks within each tree, but I don't want someone to be in two trees at the same time. If it is setup to prevent that, then I'll give your plugin a go, and see if it is compatible with my server (We are running Tekkit)
@Curtis4321
Thank you for the report. It seems you're using the BETA build of Bukkit.
I want to ensure everyone that this plugin does support the latest RB and that this issue is related only to a current BETA build of Bukkit,
That said, the issue is being caused because they changed the java package location of the GSON library. This makes it impossible to maintain version for older Bukkit builds along with the new versions.
Plug-in developers who use the GSON library will now be needed to maintain two separate versions of their plug-ins in order to support people using previous version of Bukkit.
Once they move from BETA to a full RB, I will create the 1.3.2 RB version for this plug-in and will have to maintain the two versions going forward for a while.
Thanks for bringing this up though, it is certainly something developers will need to be careful of.
--
I'll try and get a patch out in the next day or so for everyone to run against the 1.3.2-R0.1 BETA build.
Update to latest dev build if u can since they changed some gson stuff
Great Plugin Thanks :D
@smilne74
Yes i would like that too! :P
Alright I figured it out.
With bPermissions, u can set the priority of the meta data. That fixed everything,
THANK YOU FOR A GREAT PLUGIN!!!!
Okay when I enable the suffix and prefix's with this plugin (set to true), it seems to overide the herochat functionality.
example:
[G][rank1] username: this is my normal message formatting.
/payrank purchase
<[rank2] username> this is now how my chat is formatted after first rank-up.
Any ideas how to fix this? I would rather have:
[channel name][rank#]username:
instead of
<[rank#]username>
I hope this makes sense. Cause this is also messing up my message coloring. :/
When using this with Bpermissions and essentials economy, the rank up happens, but the server does not update the user's prefix. When I look at that players data in users.yml (bpermissions) it gives the user Both groups "default" and the "rank" they chose. Any ideas what is going on?
Example: new user = default (permissions group)
Player does /payrank purchase
Player levels up, but still has default permissions group prefix and suffix's.
Any ideas what is going on?
I've been looking for a plugin like this for a long ass time. Thanks a lot it works like charm :)
@hometownhawk
At the moment your only option is to assign them to a player manually using /payrank give. This allows you to by-pass the sequential ranking and give them the rank directly.
Currently players can't jump ahead though. I could consider allowing that though through optional disabling. If you want, I can make a quick update/patch to include it. Let me know.