Pages

main/Backup

I have not abandoned this project completely; I just rarely get the motivation to work on it. When I do finish it, and stop adding features mid development, I will change the status and remove this sign.

TimedRanks

TimedRanks allows server admins to give players a way to automatically reach a different rank. It will also optionally demote a player if they die.

Features:

  • Two different ranking methods.
  • Optional demotion on death.
  • Will optionally generate a top 5 list of players with the most playtime.
  • Announces to players when another player reaches a new rank.

Requirements:

  • A server running Bukkit.
  • A command usually from plugins like PermissionsEx, or bPermissions, that will promote a player.
  • The Vault plugin. Vault
  • OPTIONAL: MySQL Server

Commands:

Any thing in < > is optional. Anything in [ ] can be expressed as seconds or the format 1w2d3h5m6s
All usage of ( ) < > [ ] is not actually used in commands.

  • /tr <player>
    • Will show the user basic info like total play time and time until next rank
    • If a player name is specified, it will show their information.
  • /trlist
    • Shows the top 5 players organized by total play time.
  • /trset (time) [500] <player> <world>
    • This will set the user's playtime, or the <player's>
  • /trset (rank) (rank in config) <player> <world>
    • This will set the user's, or the <player's> rank to the matching time in the config.
  • /trset (deaths) (number) <player> <world>
    • This will only have an effect if death demotion is enabled.

Rank Methods:

There are two different methods that can be used to control how players have to play in order to rank up.
Only one can be used at any given time. this is controlled by alternativerankmethod in the config.
If set to true then when a user logs in for the day a credit towards their next rank is applied. They can not get another one until the next day. They can log in at 23:59 and play for a minute to reach 0:00 and get two credits within short order, assuming the rankfrequncy is set to 60 seconds or lower. If false it will just rank players based on how long they have been logged in.

Configuration

The config has a global defaults section, where options for how ranks are handled, are set. These will take effect if a world does not superscede these options.

Sample global config.

alternativerankmethod: false
deathdemote: false
demotionsteps: 0

ranks:
    guest: 0
    ranktest: 10w4d15h10m30s
    rankreal: 500
    
promotioncommand: perm set group <group> <player>
demotioncommand: perm set group <group> <player>

A world section just takes those same sections and overrides them for that world, with the exception that if a world is set to false, it will use the same alternativerankmethod in the global options, no matter what it is set to in the world options.

Sample world config.

worlds:
    world:
        enabled: false
        deathdemote: true
        demotionsteps: 2
    world_nether:
        enabled: true
        alternativerankmethod: true
        promotioncommand: perm set group <group> <player> <world>
        deathdemote: false
        ranks:
            LavaFodder: 0d
            GhastHunter: 2w
            PigSticker: 4d
            GhastHunter: 1d

Permissions:

  • timedrank.time.self - Player can use /tr
  • timedrank.time.others - Player can use /tr playername
  • timedrank.set.time.self - Player can use /trset time [500]
  • timedrank.set.time.others - Player can use /trset time [500] playername
  • timedrank.set.rank.self - Player can use /trset rank rankname
  • timedrank.set.rank.others - Player can use /trset rank rankname playername
  • timedrank.set.deaths.self - Player can use /trset deaths 4
  • timedrank.set.deaths.others - Player can use /trset deaths 4 playername
  • timedrank.exempt.death - Player is exempt from being demoted on death.
  • timedrank.exempt.rank - Player is exempt from being automatically ranked
    • Recommended that this is placed on any group that does not want to be included in the automatic ranking.
  • timedrank.message.promotion.groupname - Players with this will see messages when a user is promoted to groupname.
  • timedrank.message.demotion.groupname - Players with this will see messages when a user is demoted to groupname.

IMPORTANT

  • Players will only be considered for promotion if they are in a group that has been set up in the rank ladder.
    • Due to this, it IS recommended that the bottom rank be included with a time of 0, unless you want them to do something else to get to the bottom of the ladder.
    • They must also NOT have the permission timedrank.exempt.rank
  • Even with the above it is recommended that staff members HAVE the permission timedrank.exempt.rank, so as to not be accidentally be ranked down.

Bugs/Feature Requests

Please post all bugs at the github repository TimedRanks