AutoRanker

AutoRanker automatically executes commands on players when the players have met certain requirements in their LogBlock history, in terms of number of blocks created and blocks destroyed, and time spent online.

The intended use case for this plugin is to have players automatically promoted through different ranks as the amount of their work on the server accumulates. Note that this use requires a separate plugin to facilitate ranking commands, such as bPermissions.

Currently the plugin checks if a player meets the requirements of each rank when they log in. If there is interest among server admins, I could make it check periodically for each player that is logged in.

Usage Configuration

The config file is plugins/AutoRanker/config.yml.

Provide a list of ranks in the configuration file. For each rank, provide the set of requirements for achieving that rank, such as the following:

  • created: blocks placed
  • destroyed: blocks destroyed
  • daysonline: days since the player's first login
  • hoursonline: hours the player has spent logged in
  • haspermission: a prerequisite permission, such as for a base group
  • hasnotpermission: a postrequisite permission, to indicate that a player already has this rank or otherwise shouldn't be eligible for it
    • If your groups inherit group.… permissions, this should be the permission that is to be granted for this rank. Otherwise it can be left blank.

For each rank, also provide the commands that should be executed when the requirements are met, in which {PLAYER} is replaced by the name of the player who has met the requirements.

Example configuration

Below is an example configuration with two ranks, builder and architect, using bPermissions to manage the player groups.

ranks:
  builder:
    requirements:
      daysonline: 2
      hoursonline: 2
      created: 1000
      destroyed: 2000
      haspermission: group.default
      hasnotpermission: group.builder
    commands:
      - exec u:{PLAYER} a:setgroup v:builder
      - say {PLAYER} has achieved Builder rank.
  architect:
    requirements:
      daysonline: 60
      hoursonline: 24
      created: 10000
      destroyed: 20000
      haspermission: group.builder
      hasnotpermission: group.architect
    commands:
      - exec u:{PLAYER} a:setgroup v:architect
      - say {PLAYER} has achieved Architect rank.

Commands & Permissions

  • command: /autorank reload
  • permission: autorank.reload (default: op)
  • Reload the ranks from the config file.

Alternatives

  • Autorank - rank based on amount of time played
  • Ranker - rank based on amount of time played, money held, players killed, monsters killed

Requirements

LogBlock is required.

To use the hours online and days online rank requirements, you must have in your LogBlock configuration logPlayerInfo set to true, e.g.:

logging:
  logPlayerInfo: true

Statistics

plugin usage statistics

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of clehner clehner May 12, 2013 at 06:13 UTC - 0 likes

    @Piero123: Go

    I bet it does.

    @MinerMtfull: Go

    Copy the example config file on this page to plugins/AutoRanker/config.yml Then edit it with the ranks you would like to have. The plugin will grant players promotions according to the requirements that you specify in the config. You do not have to promote people - the plugin does that. Server chat is not used by the plugin except for "/autorank reload" which will cause it to reload the ranks from the config file.

  • Avatar of MinerMtfull MinerMtfull May 12, 2013 at 01:27 UTC - 0 likes

    I don't get how i create the ranks!! Do i do it in the server chat or in the CraftBukkit server files? Also do i have to promote people myself or does the plugin do it for me?

  • Avatar of Piero123 Piero123 Apr 16, 2013 at 00:17 UTC - 0 likes

    Does the plugin works with minecraft 1.5.1?

  • Avatar of clehner clehner Apr 12, 2013 at 15:32 UTC - 0 likes

    @blazen988: If a player meets the requirements of a rank, the plugin will execute the commands. If a command takes money from a player that they don't have, it is up to the economy plugin what happens to their balance, but the other commands will still run, so the player will still get the promotion.

  • Avatar of blazen988 blazen988 Apr 12, 2013 at 15:09 UTC - 0 likes

    Hey if i set a command to take a certain amount of money from a player in the commands section of the config then will it not rank them up if they don't have the money or will it still rank them up?

  • Avatar of Diabloste Diabloste Apr 11, 2013 at 15:25 UTC - 0 likes

    @clehner: Go

    Thank you! I'll try it again, I had some problems beforehand and if I get them again I'll post here.

  • Avatar of clehner clehner Apr 11, 2013 at 02:04 UTC - 0 likes

    @Diabloste: Go

    The daysonline requirement is for days since firstlogin. The hoursonline is for onlinetime.

  • Avatar of Diabloste Diabloste Apr 09, 2013 at 17:49 UTC - 0 likes

    Hi clehner, just a quick question.

    Does this look for time played (onlinetime in mysql) or their first day of playing (firstlogin in mysql)?

  • Avatar of clehner clehner Apr 04, 2013 at 16:25 UTC - 0 likes

    @Draglo: Go

    Yes. To find an example, check previous comments.

  • Avatar of Draglo Draglo Apr 04, 2013 at 14:24 UTC - 0 likes

    Hello
    I have a question.
    Is it possible to use PermissionsEx to do this?
    If so please reply with a Simple 'yes'
    Thanks
    - Draglo

Facts

Date created
Jan 15, 2013
Category
Last update
Mar 28, 2013
Development stage
Beta
License
MIT License
Curse link
AutoRanker
Downloads
2,355
Recent files

Authors