Habilidades

Cada habilidade possui seu próprio arquivo de configuração na pasta abilities/. Este guia explica como configurar e criar habilidades.

Localização

As habilidades ficam em: plugins/ySkills/abilities/

Tipos de Habilidades

O ySkills possui 3 tipos de habilidades:

PASSIVE - Efeito passivo constante
ACTIVE - Ativada manualmente (shift + clique direito)
CHANCE - Ativada por chance ao realizar ações

Estrutura de uma Habilidade

Habilidade ACTIVE

Exemplo: super_breaker.yml (Mining)

# Nome exibido nos menus
display-name: '&cSuper Breaker'

# Descrição da habilidade
description: 'Ativa modo de mineracao rapida por tempo limitado'

# Tipo: ACTIVE, PASSIVE, CHANCE
type: 'ACTIVE'

# Duração do efeito (apenas ACTIVE)
duration: 10

# Cooldown entre usos (apenas ACTIVE)
cooldown: 120

# Nível máximo da habilidade
max-level: 10

# Trigger: BLOCK_BREAK, MOB_KILL, RIGHT_CLICK_AIR, RIGHT_CLICK_BLOCK, etc.
trigger: 'RIGHT_CLICK_BLOCK'

# Efeito da habilidade
effect: 'SUPER_BREAKER'

# Configurações específicas do efeito
effect-config:
  haste-level-base: 1
  haste-level-per-level: 0.2
  triple-drop-chance: 10

# Ferramentas necessárias para ativar
tools:
  - 'WOODEN_PICKAXE'
  - 'STONE_PICKAXE'
  - 'IRON_PICKAXE'
  - 'GOLDEN_PICKAXE'
  - 'DIAMOND_PICKAXE'
  - 'NETHERITE_PICKAXE'

# Mensagens
messages:
  activate: '&a&lSUPER BREAKER ATIVADO! &7Mineracao turbo por {duration}s!'
  deactivate: '&c&lSUPER BREAKER DESATIVADO!'

Habilidade PASSIVE

Exemplo: skill_shot.yml (Archery)

display-name: '&bTiro Preciso'
description: 'Aumenta o dano base das flechas'
type: 'PASSIVE'

# Valor base do bônus
base-value: 5

# Valor adicional por nível
value-per-level: 3

max-level: 10

trigger: 'PLAYER_ATTACK'
effect: 'DAMAGE_BOOST'

effect-config:
  # Tipo de dano: PERCENT ou FLAT
  damage-type: 'PERCENT'

tools:
  - 'BOW'
  - 'CROSSBOW'

messages:
  activate: ''
  deactivate: ''

Habilidade CHANCE

Exemplo: treasure_hunter.yml (Fishing)

display-name: '&6Treasure Hunter'
description: 'Chance de encontrar tesouros raros ao pescar'
type: 'CHANCE'

# Chance base (%)
base-chance: 2

# Chance adicional por nível (%)
chance-per-level: 1

max-level: 10

trigger: 'FISHING'
effect: 'TREASURE_HUNTER'

effect-config:
  # Tesouros por raridade e nível mínimo
  treasures:
    common:
      min-level: 1
      items:
        - 'IRON_INGOT:1-3'
        - 'GOLD_INGOT:1-2'
        - 'NAME_TAG:1'
    
    uncommon:
      min-level: 3
      items:
        - 'DIAMOND:1'
        - 'GOLDEN_APPLE:1'
    
    rare:
      min-level: 5
      items:
        - 'DIAMOND:1-3'
        - 'ENCHANTED_GOLDEN_APPLE:1'
    
    legendary:
      min-level: 8
      items:
        - 'NETHERITE_INGOT:1'
        - 'TOTEM_OF_UNDYING:1'

messages:
  activate: '&6Treasure Hunter! Voce encontrou um tesouro!'
  deactivate: ''

Efeitos Disponíveis

SUPER_BREAKER

Mineração ultra rápida temporária.

effect: 'SUPER_BREAKER'
effect-config:
  haste-level-base: 1              # Haste base
  haste-level-per-level: 0.2       # Haste por nível da habilidade
  triple-drop-chance: 10           # Chance de drop triplo (%)

Cálculo:

Nível 1: Haste I (1.0 + 0 * 0.2)
Nível 5: Haste II (1.0 + 4 * 0.2)
Nível 10: Haste III (1.0 + 9 * 0.2)

TREE_FELLER

Derruba árvores inteiras.

effect: 'TREE_FELLER'
effect-config:
  max-blocks-base: 50              # Blocos máximos base
  max-blocks-per-level: 10         # Blocos adicionais por nível
  damage-tool: true                # Gastar durabilidade
  double-drop-chance: 15           # Chance de drop duplo (%)

DAMAGE_BOOST

Aumenta o dano causado.

effect: 'DAMAGE_BOOST'
effect-config:
  damage-type: 'PERCENT'           # PERCENT ou FLAT

PERCENT: Aumenta em % (base-value: 10 = +10% de dano)
FLAT: Aumenta valor fixo (base-value: 2 = +2 de dano)

SKULL_SPLITTER

Ataque em área com machados.

effect: 'SKULL_SPLITTER'
effect-config:
  aoe-radius: 2.5                  # Raio do AoE
  damage-reduction-aoe: 50         # Redução de dano no AoE (%)

BLEED

Causa sangramento no alvo.

effect: 'BLEED'
effect-config:
  duration: 40                     # Duração do sangramento (ticks)
  damage-per-tick: 1               # Dano por tick

ROLL

Reduz dano de queda.

effect: 'ROLL'
effect-config:
  damage-reduction-percent: 100    # Redução de dano (%)
  max-fall-distance: 15            # Distância máxima de queda
  graceful-roll-bonus: 50          # Bônus com agachado (%)

REPAIR

Repara itens automaticamente.

effect: 'REPAIR'
effect-config:
  repair-percent-per-level: 2      # % de durabilidade por nível
  max-repair-percent: 20           # Máximo de % restaurada
  repair-main-hand: true           # Reparar item na mão
  repair-armor: false              # Reparar armadura

TREASURE_HUNTER

Encontra tesouros ao pescar.

effect: 'TREASURE_HUNTER'
effect-config:
  treasures:
    common:
      min-level: 1                 # Nível mínimo para desbloquear
      items:
        - 'DIAMOND:1-3'            # ITEM:quantidade_min-max
        - 'GOLD_INGOT:5-10'

SHROOM_THUMB

Multiplica drops de cogumelos.

effect: 'SHROOM_THUMB'
effect-config:
  multiplier: 2                    # Multiplicador de drops
  valid-blocks:                    # Blocos afetados
    - 'RED_MUSHROOM'
    - 'BROWN_MUSHROOM'
    - 'CRIMSON_FUNGUS'

Triggers Disponíveis

Trigger	Quando Ativa
`BLOCK_BREAK`	Ao quebrar bloco
`BLOCK_PLACE`	Ao colocar bloco
`MOB_KILL`	Ao matar mob
`PLAYER_ATTACK`	Ao atacar (mobs ou jogadores)
`PLAYER_DAMAGE`	Ao receber dano
`FISHING`	Ao pescar
`CRAFTING`	Ao craftar
`SMELTING`	Ao fundir
`BREWING`	Ao fazer poção
`ENCHANTING`	Ao encantar
`RIGHT_CLICK_AIR`	Shift + clique direito no ar
`RIGHT_CLICK_BLOCK`	Shift + clique direito em bloco
`ACROBATICS`	Ao cair

Criando Habilidade Personalizada

Exemplo: fire_resistance.yml (custom)

display-name: '&cResistência ao Fogo'
description: 'Chance de ganhar resistência ao fogo ao entrar em lava'
type: 'CHANCE'

base-chance: 10
chance-per-level: 5
max-level: 10

trigger: 'PLAYER_DAMAGE'
effect: 'FIRE_RESISTANCE'

effect-config:
  duration: 100                    # Duração em ticks (5 segundos)
  only-fire-damage: true           # Apenas ativar com dano de fogo
  
tools: []

messages:
  activate: '&cResistência ao Fogo ativada!'
  deactivate: '&7Resistência ao Fogo expirou.'

Calculadora de Valores

Habilidades PASSIVE

Fórmula: valor_total = base-value + (level * value-per-level)

Exemplo:

base-value: 5
value-per-level: 3

Nível 1: 5 + (1 * 3) = 8%
Nível 5: 5 + (5 * 3) = 20%
Nível 10: 5 + (10 * 3) = 35%

Habilidades CHANCE

Fórmula: chance_total = base-chance + (level * chance-per-level)

Exemplo:

base-chance: 2
chance-per-level: 1

Nível 1: 2 + (1 * 1) = 3%
Nível 5: 2 + (5 * 1) = 7%
Nível 10: 2 + (10 * 1) = 12%

Habilidades ACTIVE

Duração e cooldown são fixos, mas efeitos podem escalar:

duration: 10           # Sempre 10 segundos
cooldown: 120          # Sempre 120 segundos

effect-config:
  value-base: 10
  value-per-level: 2

Vinculando Habilidade à Skill

Depois de criar a habilidade, adicione-a na skill:

# Em skills/mining.yml
abilities:
  super_breaker:       # Nome do arquivo (sem .yml)
    level: 25          # Nível necessário para desbloquear
    max-level: 10      # Nível máximo da habilidade
  
  nova_habilidade:
    level: 50
    max-level: 5

Placeholders das Habilidades

Placeholder	Descrição
`{description}`	Descrição da habilidade
`{type_color}`	Cor do tipo
`{type_name}`	Nome do tipo
`{ability_level}`	Nível atual da habilidade
`{max_level}`	Nível máximo
`{value}`	Valor atual (PASSIVE)
`{chance}`	Chance atual (CHANCE)
`{duration}`	Duração (ACTIVE)
`{cooldown}`	Cooldown (ACTIVE)
`{unlock_level}`	Nível para desbloquear
`{levels_remaining}`	Níveis faltantes
`{levels_to_next}`	Níveis para próximo nível da habilidade

Exemplos Avançados

Habilidade Multi-Efeito

display-name: '&5Supremacia'
description: 'Ganha múltiplos buffs ao ativar'
type: 'ACTIVE'

duration: 20
cooldown: 300
max-level: 5

trigger: 'RIGHT_CLICK_AIR'
effect: 'MULTI_BUFF'

effect-config:
  effects:
    - type: 'SPEED'
      amplifier: 2
    - type: 'STRENGTH'
      amplifier: 1
    - type: 'RESISTANCE'
      amplifier: 1
  
  particles:
    enabled: true
    type: 'ENCHANTMENT_TABLE'
    count: 50

tools: []

messages:
  activate: '&5&lSUPREMACIA ATIVADA! &7Todos os buffs por {duration}s!'
  deactivate: '&7Supremacia expirou.'

Habilidade com Condições

display-name: '&3Pescador Noturno'
description: 'Bônus de pesca durante a noite'
type: 'PASSIVE'

base-value: 25
value-per-level: 5
max-level: 10

trigger: 'FISHING'
effect: 'NIGHT_FISHERMAN'

effect-config:
  only-night: true               # Apenas de noite
  only-rain: false               # Apenas com chuva
  biomes:                        # Biomas permitidos
    - 'OCEAN'
    - 'DEEP_OCEAN'
    - 'RIVER'

tools: []

messages:
  activate: '&3A noite favorece sua pesca!'
  deactivate: ''

Testar Habilidades

Use /skills addxp [player] [xp] [skill] para testar rapidamente habilidades sem precisar farmar XP.

Aplicar Mudanças

Use /skills reload após modificar qualquer arquivo de habilidade.

Habilidades

Nesta página