Guide to skills and the skills.yml file

Skills are measures of a player's experience or progress in different aspects of the game. As the main feature of AuraSkills, all other features are connected or related to skills. All information about skills is viewed in the skills menu using /skills. Each skill has a set of sources: specific tasks or actions used to gain XP in that skill. Players level up by reaching the XP requirement for the next level, which increases with higher skill levels.

Upon reaching a new skill level, players can be rewarded with:

  • Stat levels

  • Ability unlocks and level-ups

  • Mana Ability unlocks and level-ups

  • Other customizable rewards, including:

    • Commands

    • Permissions

    • Items

    • Money

There are 11 default skills included in the plugin:

  • Farming

  • Foraging

  • Mining

  • Fishing

  • Excavation

  • Archery

  • Defense

  • Fighting

  • Agility

  • Enchanting

  • Alchemy

There are 4 skills present in Beta that were merged or removed in default configs. Servers that migrated from Beta or loaded the legacy preset have these additional skills:

  • Endurance (merged into Agility in default)

  • Healing (merged into Alchemy in default)

  • Forging (merged into Enchanting in default)

  • Sorcery (removed from default)


Skills are configured in the skills.yml file. Each skill has a section named after its full Namespaced ID (prefixed with auraskills/ for all default skills). Below is an example skill section for Farming with comments explaining each option:

auraskills/farming: # The Namespaced ID of the skill
  abilities: # The list of abilities the skill levels up
    - auraskills/bountiful_harvest
    - auraskills/farmer
    - auraskills/scythe_master
    - auraskills/geneticist
    - auraskills/triple_harvest
  mana_ability: auraskills/replenish # The mana ability of the skill (optional)
  options: # Configurable options for the skill, see below for details on each option
    enabled: true
    max_level: 97
    check_cancelled: true
    check_multiplier_permissions: true


The abilities key is a list of the abilities attached to the skill (will level up as the skill levels up). The ability name must be a full Namespaced ID. All other configuration for abilities is done in abilities.yml.

Mana ability

The mana_ability key is the name (full Namespaced ID) of the mana ability of the skill. This is an optional value, as not all skills have mana abilities. All other configuration for mana abilities is done in mana_abilities.yml.


General options

  • enabled - Whether the skill and all its connected features should be enabled. If set to false, players cannot gain XP in the skill, use the abilities or mana abilities, and the skill will be hidden from menus. Disabling a skill will not reset player levels, so re-enabling a skill will retain previously gained levels.

  • max_level - The maximum attainable level of a skill. Lowering this level will not decrease player levels that are already higher than the new max level.

  • check_cancelled - Whether source levelers should ignore cancelled events when giving XP. This should not be changed unless you have a specific compatibility issue that requires it.

  • check_multiplier_permissions - Whether permission-based multipliers (auraskills.multiplier.*) should work. If you do not use permission multipliers, setting this to false may improve performance.

Archery and fighting options

  • spawner_multiplier - Multiplies the given XP by this value for mobs spawned by a mob spawner block. Set to 0 to disable XP from spawners.

Defense options

  • max - The maximum amount of XP to reward for defense.

  • min - The minimum amount of XP required to be rewarded. If the XP is lower than min, no XP will be given.

  • allow_shield_blocking - Whether XP should be given when a player is hit while blocking with a shield.

Alchemy options

  • ignore_custom_potions - If true, potions with custom effects (non-brewable potions) will not work with Alchemy abilities such as Alchemist, Sugar Rush, and Splasher.


The names of skills can be used to directly open the level progression menus for that skill, such as /farming, /archery, etc. This can be disabled by setting enable_skill_commands to false in config.yml.

Skill levels can be manipulated using the following commands:

  • /skills skill setlevel <player> <skill> <level>

  • /skills skill setall <player> <skill> <level>

  • /skills skill reset <player> [skill]

The skills menu is accessed using /skills. The design and format of the menu is configured in menus/skills.yml.


The display names and descriptions of skills can be changed under the skills section of the messages file.

Last updated