Skip to content

Configuration Tutorial

Staartvin edited this page Aug 19, 2013 · 15 revisions

Do you want to know how to configure the configuration files? It's not that hard!


Index

  • Setup
  • SimpleConfig
  • AdvancedConfig
    • Super-advanced AdvancedConfig

Setup

If you have everything setup correctly, you should have 5 files:

  1. An advancedconfig.yml
  2. A data.yml
  3. A simpleconfig.yml
  4. A lang.yml
  5. A playerdata.yml

You do not have to touch the data.yml and playerdata.yml because it will automatically be changed everytime a player ranks up or makes progress. Detailed information about the other three '.yml's are below.

WARNING: PERMISSION NAMES ARE CASE-SENSITIVE!

SimpleConfig.yml

Most servers only need this specific file. It allows for simple ranking when a player has played for a certain amount of time.

Example here

When a player first joins your server, you can set a default group with your permissions plugin. I use PEX as my Permissions plugin and I've set the group 'guest' as the default group. (Do note that Autorank won't default a player to a rank) When a player would join your server and would be put in the guest group, after 1 hour they would be ranked up to member. After 5 days of playtime, they would be VIP if they are still in the member group. If a moderator would player for 5 days, it will not put your moderator as a VIP. You get the point.

AdvancedConfig.yml

This file is to be used only for servers that require more configuration option, such as: command performing, sending message, rewarding money, etc.

Example configuration file here.

In this case, whenever a player is in the guests group and has played for 10 hours or over, he or she will be promoted to the members group and will get a message containing "Congratulations, you are now a member.". Also, the commands 'say &p just got a promotion' and 'broadcast &p has just been promoted to Member!' will be performed. Note that &p will change to the player's name.

Once a player has become a member,

  • played for 5 days or more,
  • has 10 exp,
  • is in 'world_nether',
  • is in gamemode 0 (survival),
  • and has an item with data value 50 (torch),

it will be ranked up to VIP, will get a message ('Congratulations, you are now a vip.') and the following command would be performed: 'say &p has just been promoted to VIP!', 'give &p 1 100' and 'tell &p You have just earned 100 stone!'.

That's all there is to it. It's not super complicated but it offers you, as an admin, a lot of new ways to rank players. If you want to go even further ( yes, it's possible ), you should check out the 'super-advanced' section.

Clone this wiki locally