Ranker

Table of Contents

Usage and Scalability

Ranker can automatically run commands to give players rewards/permissions based on their performance/stat (pvp, pve, time, and wealth) that satisfy requirements defined by server Ops/Admins. With absolutely no configuration, Ranker works as a light-weight and simple stats tracker. Ranker's features and functions depends on the data in config.yml. Unlock as much or as little features and functions as you wish. Add Vault.jar and Ranker will use your server's economy currency as a stat. Define requirements, rewards, custom messages and commands and ranker works automatically. Set commands to do anything including grant players permissions, powers, items, and/or other rewards. Ops/Admins can control Ranker completely from within the game using commands. Commands can also provide feedback of current values in config.yml. Players and Console can display both online and offline player stats as well as modify them.

Ranker config.yml

Ranker's typical config.yml is organized into the following root sections:

autorank - contains the ranks, requirements, rewards, messages, and commands
stats - contains the appearance of of /ranker stats
chatformat - contains the appearance of each rank title
general - ranker chat mode, debug mode, How Ranker affect operators
mysql - MySQL support for synchronizing player stats to database

Simple Config.yml Example

autorank: 
  world:
    Peon:
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      requirement: money=10
    Citizen:
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      requirement: money=20
stats:
  line2: ' &3{RANK} &2{PLAYER}'
chatformat:
  Peon: '&a{RANK} {PLAYER}&3: &9'
  Citizen: '&a{RANK} {PLAYER}&3: &9'
general:
  debug: false
  chat: false
  operator: false
mysql:
  enable: false
  ip: 127.0.0.1
  username: root
  password: password
  port: 3306
  database: minecraft
  table: ranker
  update: 45
  keepalive: true

Extended Config.yml Example

general:
  chat: false
  debug: false
  operator: false
mysql:
  enable: false
  ip: 127.0.0.1
  username: root
  password: password
  port: 3306
  database: minecraft
  table: ranker
  update: 45
  keepalive: true
autorank:
  world:
    Peon:
      rankupmessage1: '&8--------------------------------------------'
      rankupmessage2: ' You earned Peon rank!'
      rankupmessage3: '&8--------------------------------------------'
      rankdownmessage1: '&8--------------------------------------------'
      rankdownmessage2: ' You ranked down to Peon rank!'
      rankdownmessage3: '&8--------------------------------------------'
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankupcommand2: server:/perm reload
      rankupcommand3: server:/give {PLAYER} wood 100
      rankupcommand4: server:/give {PLAYER} dirt 100
      rankdowncommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankdowncommand2: server:/perm reload
      rankdowncommand3: server:/give {PLAYER} wood 1
      rankdowncommand4: server:/give {PLAYER} dirt 1
      rewardinfo: '100 stacks of wood, dirt, and some new commands!'
      requirement: money=0
    Citizen:
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankupcommand2: server:/perm reload
      rankupcommand3: server:/give {PLAYER} wood 100
      rankupcommand4: server:/give {PLAYER} stone 100
      rankupmessage1: '&8--------------------------------------------'
      rankupmessage2: ' You earned Citizen rank!'
      rankupmessage3: '&8--------------------------------------------'
      rankdownmessage1: '&8--------------------------------------------'
      rankdownmessage2: ' You ranked down to Citizen rank!'
      rankdownmessage3: '&8--------------------------------------------'
      rankdowncommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankdowncommand2: server:/perm reload
      rankdowncommand3: server:/give {PLAYER} wood 1
      rankdowncommand4: server:/give {PLAYER} dirt 1
      requirement: money=1000
    Recruit:
      requirement: money=2000
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankupcommand2: server:/perm reload
      rankupcommand3: server:/give {PLAYER} wood 100
      rankupcommand4: server:/give {PLAYER} stone 100
      rankupcommand5: server:/give {PLAYER} stonesword 1
      rankupmessage1: '&8--------------------------------------------'
      rankupmessage2: ' You earned Recruit rank!'
      rankupmessage3: '&8--------------------------------------------'
      rankdownmessage1: '&8--------------------------------------------'
      rankdownmessage2: ' You ranked down to Recruit rank!'
      rankdownmessage3: '&8--------------------------------------------'
      rankdowncommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankdowncommand2: server:/perm reload
      rankdowncommand3: server:/give {PLAYER} wood 1
      rankdowncommand4: server:/give {PLAYER} dirt 1
  world_the_end:
    Peon:
      rankupmessage1: '&8--------------------------------------------'
      rankupmessage2: ' You earned Peon rank!'
      rankupmessage3: '&8--------------------------------------------'
      rankdownmessage1: '&8--------------------------------------------'
      rankdownmessage2: ' You ranked down to Peon rank!'
      rankdownmessage3: '&8--------------------------------------------'
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankupcommand2: server:/perm reload
      rankupcommand3: server:/give {PLAYER} wood 100
      rankupcommand4: server:/give {PLAYER} dirt 100
      rankdowncommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankdowncommand2: server:/perm reload
      rankdowncommand3: server:/give {PLAYER} wood 1
      rankdowncommand4: server:/give {PLAYER} dirt 1
      rewardinfo: '100 stacks of wood, dirt, and some new commands!'
      requirement: money=0
    Citizen:
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankupcommand2: server:/perm reload
      rankupcommand3: server:/give {PLAYER} wood 100
      rankupcommand4: server:/give {PLAYER} stone 100
      rankupmessage1: '&8--------------------------------------------'
      rankupmessage2: ' You earned Citizen rank!'
      rankupmessage3: '&8--------------------------------------------'
      rankdownmessage1: '&8--------------------------------------------'
      rankdownmessage2: ' You ranked down to Citizen rank!'
      rankdownmessage3: '&8--------------------------------------------'
      rankdowncommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankdowncommand2: server:/perm reload
      rankdowncommand3: server:/give {PLAYER} wood 1
      rankdowncommand4: server:/give {PLAYER} dirt 1
      requirement: money=1000
    King:
      requirement: money=2000
      rankupcommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankupcommand2: server:/perm reload
      rankupcommand3: server:/give {PLAYER} wood 100
      rankupcommand4: server:/give {PLAYER} stone 100
      rankupcommand5: server:/give {PLAYER} stonesword 1
      rankupmessage1: '&8--------------------------------------------'
      rankupmessage2: ' You earned King rank!'
      rankupmessage3: '&8--------------------------------------------'
      rankdownmessage1: '&8--------------------------------------------'
      rankdownmessage2: ' You ranked down to King rank!'
      rankdownmessage3: '&8--------------------------------------------'
      rankdowncommand1: server:/perm player setgroup {PLAYER} {RANK}
      rankdowncommand2: server:/perm reload
      rankdowncommand3: server:/give {PLAYER} wood 50
      rankdowncommand4: server:/give {PLAYER} dirt 50
stats:
  line1: '&8--------------------------------------------'
  line2: ' &3{RANK} &2{PLAYER}'
  line3: '&6 {PVP} &aplayers killed!'
  line4: ' &6{PVE} &amonsters/animals killed.'
  line5: ' &6{TIME} &aminutes played.'
  line6: ' &6${MONEY} &ain wealth.'
  line7: '&8--------------------------------------------'
chatformat:
  Peon: '&a{RANK} {PLAYER}&3: &9'

Ranker Commands allows Complete Control over config.yml

The following are 2 examples of defining requirement(s) for the Peon rank

description: (player must have atleast $1000 AND a pvp score of 4)
command: /ranker worldName.Peon.requirement money=1000+pvp=4
description: (player must have atleast $1000 AND a pvp score of 4) OR (have playtime of atleast 120 minutes) OR (have killed atleast 50 monsters) OR (have killed atleast 30 players)
command: /ranker worldName.Peon.requirement money=1000+pvp=4;time=120;pve=50;pvp=30

More on how to Modify config.yml by Commands

Command parameter corresponds directly to the format within the config.yml file. The following demonstrates a sequence of changes to the config.yml with each command used. Also Note Below: Ranker displays the current value of the config node if no value parameters are included!

permission node: ranker.* (default: op)
command: /ranker autorank.world.Peon.rankupcommand1 server:/give {PLAYER} wood 100

autorank:
  world:
    Peon:
      rankupcommand1: server:/give {PLAYER} wood 100

command: /ranker autorank.world.Peon.rankupmessage2 ' You earned Peon rank!'

autorank:
  world:
    Peon:
      rankupcommand1: server:/give {PLAYER} wood 100
      rankupmessage2: ' You earned Peon rank!'

command: /ranker autorank.world.Peon.requirement time=0

autorank:
  world:
    Peon:
      rankupcommand1: server:/give {PLAYER} wood 100
      rankupmessage2: ' You earned Peon rank!'
      requirement: time=0

command: /ranker autorank.world.Peon.requirement
displays: (existing) time=0
command: /ranker autorank.world.Peon.requirement remove

autorank:
  world:
    Peon:
      rankupcommand1: server:/give {PLAYER} wood 100
      rankupmessage2: ' You earned Peon rank!'

Commands

/ranker list 
    description: list all ranks, requirements, and rewards within a world.
/ranker stats
    description: show stats
/ranker stats <player>
    description: show stats of <player>
/ranker autorank.<worldName>.<rankName>.<options> <values>
    description: edit autorank data in config.yml
/ranker chatformat.<rankName> <values>
    description: edit chatformat in config.yml
/ranker stats.line<1-8> <values>
    description: edit stats format in config.yml
/ranker save-all
    description: saves all player's stats to server before a /reload
/ranker general.chat <true|false>
    description: turn Ranker chat mode on/off.
/ranker general.debug <true|false>
    description: turn Ranker debug mode on/off.
/ranker general.operator <true|false>
    description: include/exclude operators from calling Ranker's messages/commands, (false prevents operators from getting downranked)
/ranker reset <player> rank
    description: reset player rankName
/ranker reset <player> <pvp|pve|time> <value>
    description: reset player stats to specified value.
/ranker give <player> <pvp|pve|time> <value>
    description: add value to specified player stats.
/ranker import autorank
    description: imports autorank player's time into Ranker playerData

Permissions

  ranker.*:
        description: Allow use of op commands.
        default: op
      children:     
        ranker.stats.self: true
        ranker.stats.other: true
        ranker.list: true
        ranker.save.all: true
  ranker.stats.self:
        description: Show my stats.
  ranker.stats.other:
        description: Show other player's stats.
  ranker.list:
        description: List the ranks, requirements, and rewards within a world.
  ranker.command.rankup:
        description: Call rank commands when rank up to that rank.
  ranker.command.rankdown:
        description: Call rank commands when rank down to that rank
  ranker.message.rankup:
        description: Call rank messages when rank up to that rank.
  ranker.message.rankdown:
        description: Call rank messages when rank down to that rank.
  ranker.rankup:
        description: Change your rank when you rank up. Setting this to false will disable both message and command.
  ranker.rankdown:
        description: Change your rank when you rank down. Setting this to false will disable both message and command.
  ranker.save.all:
        description: Allow player to save all player's stats to server.

Player and Server Command Example

command: /ranker autorank.world.Peon.rankupcommand1 server:/give {PLAYER} wood 100
description: console server will send the command
command: /ranker autorank.world.Peon.rankupcommand2 player:/me just ranked!
description: the player will send the command

Mechanics with Permissions

permission node: ranker.command.rankup (default: op)
description: Call rank commands when rank up to that rank.

permission node: ranker.command.rankdown (default: op)
description: Call rank commands when rank down to that rank

permission node: ranker.message.rankup (default: op)
description: Call rank messages when rank up to that rank.

permission node: ranker.message.rankdown (default: op)
description: Call rank messages when rank down to that rank.

Like this plugin? Donate to support development and Thanks!

Comments

_ForgeUser11696838
- Join Date: 6/19/2013
- Posts: 12
- Member Details
#233 _ForgeUser11696838

View User Profile

Send Message

Posted Jan 3, 2015
Add the ability to /rank reload and save the userdata automatically before a reload? Would be appreciated! Great plugin!

Rollback Post to Revision RollBack
_ForgeUser16523395
- Join Date: 7/26/2014
- Posts: 61
- Member Details
#232 _ForgeUser16523395

View User Profile

Send Message

Posted Aug 16, 2014
Can this be hooked into OnTime so my players don't have to lose their current ontimes?

Rollback Post to Revision RollBack
_ForgeUser7346918
- Join Date: 8/8/2011
- Posts: 60
- Member Details
#231 _ForgeUser7346918

View User Profile

Send Message

Posted Jun 12, 2014
Is there a way to make this work GLOBALLY with all worlds? Right now I have every world in my config and it's getting HUGE. All of my worlds have the same ranks.

HELP

Rollback Post to Revision RollBack
_ForgeUser10413818
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#230 _ForgeUser10413818

View User Profile

Send Message

Posted Mar 21, 2014
@peace1498

You will rank up depending on what you set your requirements as. (pvp, pve, time, and money)

@eo2day

I just set it up on my test server and it is working great. (server version 1.7.2)

@ProPluggins

I don't have it on my main server at the moment. But I have been thinking about it for awhile now.

Last edited by _ForgeUser10413818: Mar 21, 2014

Rollback Post to Revision RollBack
_ForgeUser10413818
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#229 _ForgeUser10413818

View User Profile

Send Message

Posted Mar 21, 2014
@ProPluggins

Sorry just seen this post. Been real busy. I will load this up on my test server and see if it is working still. Haven't used it in some time now. Will post my results.. :)

Rollback Post to Revision RollBack
_ForgeUser7181624
- Join Date: 7/10/2011
- Posts: 47
- Member Details
#228 _ForgeUser7181624

View User Profile

Send Message

Posted Mar 21, 2014
is there a way to rank up with a command like /rankup ? or when you reach the goal you automatically get the rank?

Rollback Post to Revision RollBack
_ForgeUser13137034
- Join Date: 2/1/2014
- Posts: 1
- Member Details
#227 _ForgeUser13137034

View User Profile

Send Message

Posted Feb 2, 2014
@quadshield

can i join ur server :3 my ign is gostcut

Rollback Post to Revision RollBack
_ForgeUser8294077
- Join Date: 1/21/2012
- Posts: 4
- Member Details
#226 _ForgeUser8294077

View User Profile

Send Message

Posted Jan 31, 2014
@NinjaCherry

I am having the same issue, when the requirements are met, ranks are not increased. Not a single automatic ranking plugin is working on 1.7.2 D:

Rollback Post to Revision RollBack
_ForgeUser13117845
- Join Date: 1/29/2014
- Posts: 8
- Member Details
#225 _ForgeUser13117845

View User Profile

Send Message

Posted Jan 31, 2014
i have setup the config yet i get the amount of kills needed pvp=125 is that right? then i doesnt do anything to me when i get those kills.
Does the plugin need a permissions file too?

Rollback Post to Revision RollBack
_ForgeUser7346918
- Join Date: 8/8/2011
- Posts: 60
- Member Details
#224 _ForgeUser7346918

View User Profile

Send Message

Posted Jan 14, 2014
Is there a way to get Ranker to work GLOBALLY? I run 7+ maps and I have them set to rank the same no matter what world players are on. This means I have 21+ sections in the config.yml so players can rank up that are the same.. I tried removing the world: (my map name) lines in the config and it doesn't work.

Any ideas?

Rollback Post to Revision RollBack
_ForgeUser10413818
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#223 _ForgeUser10413818

View User Profile

Send Message

Posted Sep 2, 2013
Does the group have the rank up permission?

Rollback Post to Revision RollBack
_ForgeUser9972686
- Join Date: 11/13/2012
- Posts: 95
- Member Details
#222 _ForgeUser9972686

View User Profile

Send Message

Posted Sep 2, 2013
The permissions are so confusing. Urgh.

I have set it pvp requirement as 2. I get a player to kill me twice and nothing happens.

Rollback Post to Revision RollBack
_ForgeUser10413818
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#221 _ForgeUser10413818

View User Profile

Send Message

Posted Aug 31, 2013
And yes I also had it working on 1.5.2 as well

Rollback Post to Revision RollBack
_ForgeUser10413818
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#220 _ForgeUser10413818

View User Profile

Send Message

Posted Aug 31, 2013
I have it working on version 1.62

Rollback Post to Revision RollBack
_ForgeUser12058705
- Join Date: 8/19/2013
- Posts: 10
- Member Details
#219 _ForgeUser12058705

View User Profile

Send Message

Posted Aug 31, 2013
working on 1.5.2???

Rollback Post to Revision RollBack
_ForgeUser10413818
- Join Date: 1/19/2013
- Posts: 20
- Member Details
#218 _ForgeUser10413818

View User Profile

Send Message

Posted Aug 28, 2013
I also have this plugin working on my server. Its a great plugin.

Rollback Post to Revision RollBack
_ForgeUser553447
- Join Date: 2/28/2008
- Posts: 1
- Member Details
#217 _ForgeUser553447

View User Profile

Send Message

Posted Aug 28, 2013
I just got a minecraft server and I am pretty good with tech and have worked in it all my life but I have to say that the level that you have to be to just setup a server side mod is insane. I just want to install a mode and have it work and not have to type 300 lines of code to make it work correctly. The mods are not even like modes but just a name and a here you go write your own code.

Rollback Post to Revision RollBack
Forge_User_74967307
- Join Date: 10/31/2012
- Posts: 298
- Member Details
#216 Forge_User_74967307

View User Profile

Send Message

Posted Aug 28, 2013
This plugin works fine with 1.6.2, because there are no such a function high-dependable to bukkit, its just executing commands and messages into chat.

Rollback Post to Revision RollBack
_ForgeUser6526721
- Join Date: 3/4/2011
- Posts: 270
- Member Details
#215 _ForgeUser6526721

View User Profile

Send Message

Posted Jul 23, 2013
please update

Rollback Post to Revision RollBack
_ForgeUser7522374
- Join Date: 9/9/2011
- Posts: 22
- Member Details
#214 _ForgeUser7522374

View User Profile

Send Message

Posted May 27, 2013
Update this please? :)

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

46553
Created

Oct 28, 2012
Last Released File

Mar 16, 2013
Total Downloads

19,882
License

GNU Lesser General Public Lice...

v1.3.3
Mar 16, 2013
v1.3.2
Mar 11, 2013
v1.1
Dec 3, 2012

Bukkit

Ranker

Bukkit Plugins

Ranker

Table of Contents

Usage and Scalability

Ranker config.yml

Simple Config.yml Example

Extended Config.yml Example

Ranker Commands allows Complete Control over config.yml

More on how to Modify config.yml by Commands

Commands

Permissions

Player and Server Command Example

Mechanics with Permissions

Like this plugin? Donate to support development and Thanks!

Comments

About This Project

Categories

Members

Recent Files

Bukkit