# ==============================================================
# Identificador y visualización básica
# ==============================================================
id: "soul_storm"
display-name: "%rarity_color%Soul Storm" # Nombre formateado con el color de su rareza
rarity: "legendary"                     # Rareza definida en rarities.yml (ej: common, rare, legendary)
max-level: 3                            # Nivel máximo alcanzable del encantamiento
enabled: true                           # Si el encantamiento se encuentra activo en el servidor

# ==============================================================
# Objetivos y Ranuras de Activación
# Consulta targets.yml para la lista de categorías (sword, bow, armor, etc.)
# ==============================================================
targets:
  - sword

# Lista de IDs de otros encantamientos incompatibles con este
conflicts:
  - "fire_aspect"

# ==============================================================
# Métodos de obtención en supervivencia
# ==============================================================
availability:
  enchanting-table: true # ¿Puede obtenerse en la mesa de encantamientos?
  villager-trade: true   # ¿Puede ofrecerse en aldeanos libreros?
  loot-chest: true       # ¿Aparece en cofres de mazmorras y estructuras?

# ==============================================================
# Descripción mostrada en el libro y en el lore del ítem
# Soporta MiniMessage y placeholders definidos abajo
# ==============================================================
description:
  - "<gray>Al golpear a un enemigo, desata una ráfaga de fuerza"
  - "<gray>otorgando <green>Fuerza %strength_level%</green> durante <green>%duration%s</green>."
  - "<dark_gray>Probabilidad de activación: <yellow>%chance%%</yellow>"

# ==============================================================
# Placeholders dinámicos escalables por nivel (%level%)
# Soporta fórmulas matemáticas evaluadas en tiempo de ejecución
# ==============================================================
placeholders:
  chance: "20 + (%level% * 10)"           # Nivel 1: 30%, Nivel 2: 40%, Nivel 3: 50%
  duration: "3 + (%level% * 2)"           # Nivel 1: 5s, Nivel 2: 7s, Nivel 3: 9s
  strength_level: "%level%"               # Nivel numérico del efecto

# ==============================================================
# Efectos impulsados por el motor ZenCore
# ==============================================================
effects:
  # Efecto 1: Aplica el efecto de poción de Fuerza al atacante
  # Documentación: /docs/effects/potion_effect
  - id: potion_effect
    args:
      target: "ATTACKER"                 # Objetivo del efecto (ATTACKER, VICTIM, SELF)
      effect: "STRENGTH"                 # Nombre de la poción en Bukkit PotionEffectType
      duration: "%duration% * 20"        # Duración en ticks (1 segundo = 20 ticks)
      amplifier: "%level% - 1"           # Amplificador (0 = Nivel I, 1 = Nivel II)
      chance: "%chance%"                 # Probabilidad evaluada con la fórmula de placeholders
      cooldown: 12                       # Tiempo de espera en segundos entre activaciones
      cooldown_group: "soul_storm_cd"    # Grupo de cooldown para evitar acumulación
    # Disparador: Se activa cuando el jugador ataca cuerpo a cuerpo con la espada
    # Documentación: /docs/triggers/melee_attack
    triggers:
      - melee_attack
    # Condiciones: Solo se activa si la víctima está viva y es un jugador o monstruo
    # Documentación: /docs/conditions/victim_is_alive
    conditions:
      - id: victim_is_alive
      - id: is_sneaking
        args:
          inverted: true                 # Solo si el jugador NO está agachado

  # Efecto 2: Reproduce un sonido y partículas visuales
  # Documentación: /docs/effects/sound y /docs/effects/particle
  - id: sound
    args:
      sound: "ENTITY_WARDEN_HEARTBEAT"
      volume: 1.0
      pitch: 1.2
    triggers:
      - melee_attack
    conditions:
      - id: victim_is_alive

  - id: particle
    args:
      particle: "SOUL_FIRE_FLAME"
      count: 20
      speed: 0.1
      offset_x: 0.5
      offset_y: 1.0
      offset_z: 0.5
    triggers:
      - melee_attack

id: "phoenix_aegis"
display-name: "<gradient:#ff4500:#ffd700>Phoenix Aegis</gradient>"
rarity: "mythic"
max-level: 2
enabled: true

targets:
  - chestplate

availability:
  enchanting-table: false # Solo obtenible en cofres especiales o crafteo
  villager-trade: false
  loot-chest: true

description:
  - "<gray>Al recibir daño teniendo menos del <red>30%</red> de vida,"
  - "<gray>desata un estallido ígneo que cura tus heridas y empuja enemigos."

placeholders:
  heal_amount: "%level% * 4" # 2 corazones en nivel 1, 4 corazones en nivel 2

effects:
  # Efecto de Curación instantánea
  # Documentación: /docs/effects/heal
  - id: heal
    args:
      target: "SELF"
      amount: "%heal_amount%"
      cooldown: 45
      cooldown_group: "phoenix_cd"
    triggers:
      - take_damage # Documentación: /docs/triggers/take_damage
    conditions:
      - id: health_below # Documentación: /docs/conditions/health_below
        args:
          percentage: 30

  # Efecto de Rayo visual (sin fuego en bloques)
  # Documentación: /docs/effects/strike_lightning
  - id: strike_lightning
    args:
      effect_only: true
    triggers:
      - take_damage
    conditions:
      - id: health_below
        args:
          percentage: 30