# Level Rewards

ExcellentJobs features flexible and customizable rewards system for leveling in jobs, where each job can have it's own reward lists.

With built-in rewards system, you can:

• Give the reward for every X level ups.
• Auto-scale reward(s) using Modifiers.
• Run unlimited amount of commands per reward with PlaceholderAPI support.
• Require certain permission to get the reward.
• Require certain rank(s) to get the reward.
• Display custom info if player doesn't met the requirements.

Job rewards can be viewed by players in a fully customizable GUI. You can edit GUI's layout in the /menu/job_level_rewards.yml config file.

You can configure job level rewards in the settings.yml config file of desired job(s) under the Leveling -> Rewards section.

Here is an example of the default level rewards.

Rewards:
  List:
    every_5_levels:
      Level: 5
      Repeatable: true
      Name: Money
      Description:
      - Small $%mod_money% reward.
      Commands:
      - money give %player_name% %mod_money%
      Required_Permission: 'null'
      Required_Ranks: []
      RequirementInfo: []
    donator_10_levels:
      Level: 10
      Repeatable: true
      Name: Jobs Crate Key
      Description:
      - x1 Jobs Crate Key.
      Commands:
      - crates key give %player_name% jobs 1
      Required_Permission: 'null'
      Required_Ranks:
      - vip
      - gold
      - premium
      RequirementInfo:
      - <lred>You must have VIP, Gold or Premium.</lred>

  Modifiers:
    money:
      Base: 100.0
      Per_Level: 10.0
      Step: 1.0
      Action: ADD

The List section contains rewards definitions. You can add as many rewards as you want. The names doesn't really matter, but keep them unique.

The Modifiers section contains modifier definitions for rewards to auto-scale them with the job levels.

In the example above, there are 2 rewards every_5_levels and donator_10_levels, and 1 modifier money:

• The every_5_levels reward gives (100 + 10 \times jobLevel) money every 5 levels. So $150 at level 5, $200 at level 10, and so on.
• The donator_10_levels reward gives 1 crate key every 10 levels for players with one of the following ranks: vip, gold or premium.
• The money modifier is used to auto-scale the every_5_levels reward by increasing the base amount of given money (100) by 10 per job level.

Reward Settings:

• Level - Player's job level when this reward should be triggered.
• Repeatable - If true, triggers every X levels defined in the Level setting above; If false triggers exactly at defined Level.
• Name - Reward name for players.
• Description - Reward description for players.
• Commands - Commands to run when reward is triggered. Use prefix player: to run command by a player.
• Required_Permission - Player must have certain permission to obtain the reward. Set it to null to disable.
• Required_Ranks - Player must have any of listed ranks to obtain the reward. Keep it empty to disable.
• RequirementInfo - Requirements description for players.

The following placeholders are available to use in Description, Commands and RequirementInfo:

• %player_name% for a player name.
• %mod_name% to display formatted modifier value, where name is name of the modifier: %mod_money%.
• %rawmod_name% to display plain modifier value, where name is name of the modifier: %rawmod_money%.