Bukkit

Promote! does not have a whole lot of configuration to go through, though it is quite powerful with what it already has. This is what the default config.yml looks like:

ladders:
- default
default:
- Player,0
- Builder,100
- Destroyer,200
- Carrier,300

Do not be discouraged by the strange formatting, it is actually quite simple.

Ladders

A promotion ladder, or just ladder, is a simple list of ranks that the player will move through. In order for a ladder to be loaded, it should be referenced under the corresponding node:

ladders:
- default

There is just one ladder by default, but you can add your own to the list. For example, if you wanted to add a ladder called useless, your ladders node would look like this:

ladders:
- default
- useless

Now that the ladder is referenced, it will be loaded and therefore is usable. However, you need to specify the ranks that this ladder contains as well. For example, the ladder called default contains the following ranks:

default:
- Player,0
- Builder,100
- Destroyer,200
- Carrier,300

If the player is in the group called Player, he can promote himself to the group called Builder for 100. A Builder can promote himself to Destroyer for 200, and so on. Note that the ranks are case-sensitive, and should be called exactly the same thing as they are called in your permissions plugin. The price is separated from the rank by a comma. The price can be decimal; the decimal digits are separated by a period.

If you are adding your own ladder, you will need to specify the ranks of that ladder in their own node. For example:

useless:
- your,0
- ranks,1000
- go,2000
- here,5000

After you have finished editing the configuration, you can load it into the memory with /rankup reload.