Masteries

Every time an enchant activates while mining, the player earns mastery experience for that enchant. Mastery levels give permanent bonuses and rewards, so using an enchant a lot makes it better.


Configuration	`masteries.yml`
Menu	`menus/masteries.yml`
Command	`/mastery` (aliases `/masteries`, `/maestrias`)
Module	`masteries`

Configuration

The default section applies to every enchant, including those in custom-enchants/. Anything under enchants.<id> replaces those options for one enchant.

yaml

settings:
  announce-level-up: true
  bonuses-need-enchant: true       # bonuses only count while the pickaxe has the enchant

default:
  enabled: true
  max-level: 10
  exp-per-activation: 1
  required: "50 * 2.2 ^ {level}"   # experience to go from {level} to the next
  bonuses:
    "enchant-chance:{enchant}": "{level} * 0.03"
  rewards:
    levels:
      "5":
        - "[give] tokens 10000"
      "10":
        - "[give] gems 25"
        - "[broadcast] &b{player} &7mastered &f{enchant}&7!"
    every:
      "1":
        - "[give] tokens 1000"

enchants:
  telekinesis:
    enabled: false
  fortune_boosted:
    exp-per-activation: 0.05       # activates often, earns less
    bonuses:
      sell: "{level} * 0.01"
  jackpot:
    max-level: 5
    required: "25 * 3 ^ {level}"
    bonuses:
      "enchant-chance:{enchant}": "{level} * 0.05"
      tokens: "{level} * 0.02"

Option	Does
`enabled`	`false` disables mastery for that enchant
`max-level`	Maximum level
`exp-per-activation`	Experience per activation, accepts decimals
`required`	Formula of `{level}`
`bonuses`	Stat: formula of `{level}`. `{enchant}` in the name is replaced with the id
`rewards.levels` · `rewards.every`	Actions at an exact level or every N levels, with `{player}`, `{enchant}` and `{level}`

"enchant-chance:{enchant}" is the most natural choice: mastering an enchant makes it activate more often. See Stats.

Enchants that act on every block (telekinesis, auto sell, auto smelt, magnetism, eco friendly, efficiency, speed miner) are disabled so they don't level up on their own.

Commands

Command	Permission	Does
`/mastery`	everyone	Menu with the level, progress and bonuses of each mastery
`/mastery set <player> <enchant> <level>`	`pulseprison.masteries.admin`	Sets a level
`/mastery addexp <player> <enchant> <amount>`	`pulseprison.masteries.admin`	Gives experience
`/mastery reload`	`pulseprison.masteries.admin`	Reloads `masteries.yml`

The menu also opens from the pickaxe menu.