👨‍🎓Talents

Talents are special abilities that players can unlock and activate to enhance their skills. They add an extra layer of customization and progression to the AdvancedSkills system.

How Talents Work

Talents are tied to specific skills and are unlocked as players level up those skills. Once unlocked, players can activate talents to gain temporary bonuses or trigger special effects.

Talents utilize the powerful Abilities engine to create diverse and interactive effects.

Creating Talents

To create a talent, you'll need to add a new YAML configuration in the talents folder. Let's break down the configuration of a talent using the "Graceful Landing" example:

# Graceful Landing talent
name: "Graceful Landing"
description: "Reduce fall damage by up to 50%, cooldown 15s"
icon:
  type: LEATHER_BOOTS

# Fixed mana cost
mana: 5

abilities:
  FALL_DAMAGE:
    cooldown: 15
    effects:
      - DECREASE_DAMAGE:<random number>15-50</random>
      - PARTICLE:BLOCK_DUST:30:0.3
      - PLAY_SOUND:BLOCK_GRASS_STEP:1:0.8

Let's explain each part of this configuration:

1. name: The display name of the talent.

2. description: A brief explanation of what the talent does.

3. icon: The item used to represent the talent in menus.

   • type: The Minecraft material type. Refer to the Material List for options.
4. mana: The mana cost to activate the talent. This can be a fixed number or a formula.

5. abilities: This section defines the talent's behavior using the Abilities engine.

   • FALL_DAMAGE: This is the trigger that activates the talent.
   • cooldown: The time (in seconds) before the talent can be used again.

   • effects: A list of effects that occur when the talent is triggered.

     • DECREASE_DAMAGE: Reduces the fall damage by a random amount between 15% and 50%.

     • PARTICLE: Spawns dust particles when the talent activates.

     • PLAY_SOUND: Plays a sound effect when the talent activates.