PrisonRankup
PrisonRankup
The highest-rated and most practical rankup plugin designed specifically for the ever-popular Prison server is finally here. This plugin features a unique database built into the config to house each individual player’s rank to prevent losing ranks, glitching out of the system, and allowing multiple groups to be compatible with popular permissions plugins, including PermissionsEX and GroupManager. Accessing player’s information has never been easier, as one can simply type “/rankup get (name)” to retrieve the player’s display name, rank, and current balance. In order for the balance feature to work, as well as the plugin itself, Vault is required.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Commands:
/rankup - Ranks the sender up to the next available rank (prisonrankup.rankup)
/rankup set (player) (rank) - Sets the given player to the given rank (prisonrankup.set)
/rankup stats (rank) - Receive statistics of a rank given (prisonrankup.stats)
/rankup create (rank) (price) - Create a rank in-game (prisonrankup.stats)
/rankup get (player) - Retrieve a player profile (prisonrankup.get)
/rankup reload - Reloads the config.yml (prisonrankup.reload)
/rankup update - Update PrisonRankup (prisonrankup.update)
/ranks - Shows you available ranks (prisonrankup.ranks)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Default Configuration File:
# Welcome to configuring PrisonRankup, I will be here to guide you through this config setup # First let me introduce myself, I am Mazen. I consider myself an expert in configuring Plugins and YAML configs and an advanced Java developer # First thing I want you to do is to set the prefix (What comes before the message) for the plugin to use. Keep the speech marks please to avoid errors. Prefix: '&a[&bPrison&6-&bRankup&a]' #Do not touch this! version: 3.0 # Next thing I want you to do is set the message you want it to be when somebody ranks up. Keep the speech marks here as well. # The %player% will be replaced with the players name, and the %rank% will be replaced with the rank they ranked up to. Rankup BC Message: '&3%player% &6has ranked up to &3%rank%' # Now, the most important part of this plugin is the rankup ladder groups: #Heres an example of the format of how it should be: # rank name:price #DO NOT REMOVE THE # FROM THE ABOVE! - A:30 - B:100 - C:300 #Here, I will be asking you to put the first rank on the ladder in this example A First Rank: 'A' # As well as the last rank to assure that we can message the player that he is at the end of the ladder Last Rank: 'C' # This message is the message we will send to the player if he is the highest rank. Highest Rank MSG: '&6 You are already the highest rank!' # This next one is if you want to use a timed requirement for your rankup system, set it to true if yes. Default is false; Timed Requirement: false # Now we're if you set it to true you will have to set a certain time that you want to be done for the rank requirement Time Interval: 0.0 # Here you will write what the time is based on, seconds, minutes or hours. Spelling does matter! Time type: Seconds # If you want, I added an option where you can choose if you want to make it so that the interval is added to every Rankup Sequence Interval on all ranks: false # Now you're almost there! Theres just one last part, If you're switching from Rankup and/or majority of Rankup plugins set this to true. If not, set it to false. # What this does is check if the player has a rank that is listed in groups (Every minute) and if so, makes a profile with that rank. Transfer ranks to profile: false # Set the next item to false if you do not want to use the updater update: true # Set this to true if you wish to enable debug mode debug: false # This is the format of the ranks which will appear when a player does /ranks #Variables are: %price%, %rank% ranks-format: '&5[&3%rank%&5]&6: %price%' # Here, is the message the player will recieve when he doesn't have enough money to rankup #Varaibles are the same as the ones shown above not-enough-money: '&6You need &2$%price% &6 to rankup to &2%rank%'
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Switching
Are you switching from another Rankup plugin? Simple! Set the “Transfer ranks to profile” option to “true” in the config.yml!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1.8 Compatibility
1.8 compatibilities with UUIDs have been implemented in version 2.0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Using the Sign Integration
You can make signs that work for PrisonRankup like this (You require the permission prisonrankup.sign):
Then, once you place it you will get something like this:
And congratulations! Now you have a sign that be used to Rankup!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Plugin Updater
As of Version 1.3 I have integrated an updater to the plugin, just do /rankup update to Update the plugin. You may disable this feature by setting updater to false in the config.yml
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
PrisonRankup Connects to Mojangs Servers
As of the UUID Update, PrisonRankup connects to 'sessionserver.mojang.org' as well as 'api.mojang.com' to fetch UUIDs and names.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Found a bug? Report it!
Have a bug you ran into? You want something added to the plugin? Click here!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Source (for educational purposes only)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
JavaDocs
PrisonRankup now has JavaDocs for v3.0+! You can check it out here!
Mine won't link with groupmanager whenever I do /rankup I'll get to rank b but it won't switch me to my groupmanager rank b can someone help?
@mazentheamazin
Oh i already looked and it looks straight forward, and i'm waiting for you to upload it :P
Edit:
It appears that you already have it uploaded, but I'm not seeing the PrisonRankup classTurns out I didn't downloaded v1.5How do you edit /ranks? because for me it says current ranks: "Nothing Here"
@mazentheamazin
whenis the 1.7.2-R0.4
@Bimmr
I will upload a tutorial of how to use the API very soon, however if you wish to look at the API to learn your self, reference it by doing PrisonRankup. And your IDE should show you some methods that are in the API.
Any idea when your uploading the version w/ API?
@MystTheReaper
Nvm it is just negative in the scoreboard :3 lol
@HoppyR6
Don't give players this permission: essentials.eco.loan, and if you don't give them that, then try negating it in your permissions file, like: -essentials.eco.loan, also ensure that the min-money is set to 0 and you've reloaded your essentials config / restarted your server.
@HoppyR6
I think in the essentials config file (Or what ever economy plugin you use) there's an option that lets you change if a player is allowed a negative balance. If that doesn't work then I honestly don't know.
@peace1498
I set it to 0 but it still goes to - balance :/
@HoppyR6
If you're using essentials or any other economy plugins check the config for min balance, ik this is in Essentials so ye, just check to see in the config
@SkeletonGamez
Not according to the config example above..
When i rankup i end up with negative balance?!?!?!?!?!
@MystTheReaper
There is...
Update please :(
How do I format the group list? No example is really given :/
My config >> http://pastebin.com/6efV9Mqm
@SkeletonGamez
Not sure but there's not supposed to be a double space between the rank and the price
Here Is My Config: http://pastebin.com/8rMaiJDQ
What did I do wrong? (it says "An Internal Error Has Occurred While Preforming This Command!")
@mazentheamazin
Hey I'm just wonder it if you would like a tester for your plugin.
@Shooty_
Its also the save default config, there's no need to put it in the if statement when you can just put it above, but like I said its not much but it bugged me lol