Bukkit

This plugin adds a rank system to Minecraft which adjusts damage given / damage taken per rank.

It also adds ranks for mobs, custom drops and custom recipes.

The damage adjustments as well as all ranks can be configured in the config.yml.

A recommended version of this file will be generated on the first plugin load.

## Commands:

- /rank: Show your own rank
   - Permission: ranksystem.rank.display
- /rank list: List all players with a rank
   - Permission: ranksystem.rank.list
- /rank set: Set rank for a player
   - Permission: ranksystem.rank.set
- /rank up: Rank up
   - Permission: ranksystem.level.up
- /effects: Lists all effects you can currently use
   - Permission: ranksystem.effects.list
- /effects [effect] [on|off]: Turns an effect on or off
   - Permission: ranksystem.effects.toggle
- /items: Lists some plugin items
   - Permission: ranksystem.items.list
- /items get [Player name] [Item] [amount]: Give a player a plugin item
   - Permission: ranksystem.items.get
- /spawn [entity] [level]: Spawn a living entity through the plugin
   - Permission: ranksystem.spawn.spawn

- Permission for all plugin comands: ranksystem.*

- Permission for all /rank * commands: ranksystem.rank.*

- Permission for all /effects * commands: ranksystem.effects.*

- Permission for all /items * commands: ranksystem.items.*

- Permission for all /spawn * commands: ranksystem.spawn.*

## What is the purpose of this plugin?

This plugin adds a system where hostile mobs drop Essence Crystals, which can be consumed to increase a players QI.
These can also be used to upgrade vanilla items.

e.g.:
----------------------------------------------
|ESSENCE|ESSENCE|ESSENCE|
|ESSENCE| SWORD   |ESSENCE|
|ESSENCE|ESSENCE|ESSENCE|
----------------------------------------------
Gives a lesser/normal essence sword.

----------------------------------------------
|                 |ESSENCE|                |
|ESSENCE| SWORD |ESSENCE|
|                 |ESSENCE|                |
----------------------------------------------

Gives a greater essence sword.

Using the `/rank up` command these QI points can be spend to elevate your rank.
Each rank has some modifiers.

These are:

- Damage given
- Damage taken
- Max health
- Potion effects

There are 10 ranks per default. These are defined in the config.yml file inside the plugin folder.
This file will be created on the first plugin load and can be modified after.

## Config example

In this example we see the definition of rank 5.
To reache this rank, you have to be rank 4 and you need 30 QI points.
Whith this rank you will deal 8 more damage (damage-given: 8) and receive 8 less damage (damage-taken: 8).
You will also have 30 max health (max-health: 30) which is 10 more than default, giving you 15 hearts.

The effects can be adjusted per rank.
A player will see a list of all effects of their rank which are greater than 0, by typing the /effects command.
Effects can be toggled on/off by clicking on the chat message or by accessing the respective command as listed in the /help command.

config.yml

levels:
   5:
     level: 30
     modifiers:
     damage-given: 8
     damage-taken: 8
     max-health: 30
    effects:
      night-vision: 1
      speed: 0
      haste: 0
      jump-boost: 0
      fire-resistance: 0
      water-breathing: 2
      luck: 0
      slow-falling: 1
      conduit-power: 2
      dolphins-grace: 2