Encantamentos

Exemplo completo de configuração

O plugin possui dois tipos de encantamentos: encantamentos padrão (enchants.yml) e encantamentos customizados (custom_enchants.yml).

Encantamentos padrão (enchants.yml)

enchants:
  efficiency:
    name: 'Eficiência'
    # Nível da ferramenta necessário para poder evoluir o encantamento
    pickaxe-level: 0
    # Ordem do ícone no menu
    order: 1
    # Aparecer no menu de evolução
    show-menu: true
    # Poder evoluir pagando no menu de evolução
    can-buy: true
    # Mostrar um ícone de infinito no lugar do nível
    show-infinity: false
    level:
      default: 0.0
      maximum: 25.0
    # Opções de give do encantamento
    options:
      # Delay para ativar o encantamento novamente em segundos
      delay: 0
      # Ativar dar EXP Vanilla
      xp: true
      # Ativar dar XP mcMMO
      xp-mcmmo: true
      # Ativar dar economias
      economy: true
      # Ativar dar blocos
      blocks: true
      # Ativar os custom enchant
      custom-enchant: true
      # Ativar os mine_rewards
      rewards: true
    prices-default:
      price1:
        provider: 'yfloresta'
        price: 10000.0
    prices-per-level:
      price1:
        provider: 'yfloresta'
        price: 10000.0
    prices-disenchanter:
      price2:
        provider: 'yfloresta'
        price: 100.0
    displays:
      can:
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore:
          - '&7Este encantamento permite que você'
          - '&7minere com mais agilidade.'
          - ''
          - '&f > Nível: &b{actual}&f/&b{maximum}&f.'
          - ''
          - '&f > Custo: &a{yfloresta} folhas&f.'
          - '&f > Nível necessário: &a{level}&f.'
          - ''
          - '&aBotão &fesquerdo &apara evoluir 1x'
          - '&aBotão &fdireito &apara escolher a quantia de evolução'
          - '&aBotão &fQ &apara evoluir o possível'
      cant:
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore:
          - '&cVocê não tem recursos suficientes.'
      maximum:
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore:
          - '&cVocê já está no máximo.'

Encantamentos customizados (custom_enchants.yml)

enchants:
  chaveiro:
    name: 'Chaveiro'
    pickaxe-level: 0
    order: 14
    show-menu: true
    can-buy: true
    show-infinity: false
    level-percentage: 0.15
    level:
      default: 0.0
      maximum: 10.0
    prices-default:
      price1:
        provider: 'yfloresta'
        price: 10000.0
    prices-per-level:
      price1:
        provider: 'yfloresta'
        price: 10000.0
    prices-disenchanter:
      price2:
        provider: 'yfloresta'
        price: 100.0
    commands: ['100.0,give {player} TRIPWIRE_HOOK 1']
    displays:
      can:
        material: TRIPWIRE_HOOK
        name: '&aChaveiro'
        lore:
          - '&7Este encantamento permite que você'
          - '&7encontre chaves ao desmatar.'
          - ''
          - '&f > Nível: &b{actual}&f/&b{maximum}&f.'
          - '&f > Porcentagem Atual: &b{percentage}%&f.'

Estrutura de encantamentos

Configurações básicas

name

Nome de exibição do encantamento.

Exemplo:

enchants:
  efficiency:
    name: 'Eficiência'

pickaxe-level

Nível mínimo da ferramenta para poder evoluir este encantamento.

Exemplo:

enchants:
  efficiency:
    pickaxe-level: 10

order

Ordem de exibição no menu.

Exemplo:

enchants:
  efficiency:
    order: 1

Define se o encantamento aparece no menu de evolução.

Exemplo:

enchants:
  efficiency:
    show-menu: true

can-buy

Define se o jogador pode comprar/evoluir o encantamento.

Exemplo:

enchants:
  efficiency:
    can-buy: true

show-infinity

Mostra símbolo de infinito ao invés do nível.

Exemplo:

enchants:
  efficiency:
    show-infinity: false

Níveis

level

Define os níveis mínimo e máximo do encantamento.

Exemplo:

enchants:
  efficiency:
    level:
      default: 0.0
      maximum: 25.0

Use -1 em maximum para nível infinito.

level-percentage

Porcentagem de chance por nível (usado em encantamentos de chance).

Exemplo:

enchants:
  lucky:
    level-percentage: 0.15

0.15 = 0.15% de chance por nível

level-multiplier

Multiplicador por nível (usado em encantamentos multiplicadores).

Exemplo:

enchants:
  multiplier:
    level-multiplier: 0.15

Opções (options)

Configurações específicas para encantamentos padrão.

Exemplo:

enchants:
  efficiency:
    options:
      delay: 0
      xp: true
      xp-mcmmo: true
      economy: true
      blocks: true
      custom-enchant: true
      rewards: true

Preços

prices-default

Preço inicial para o primeiro nível.

Exemplo:

enchants:
  efficiency:
    prices-default:
      price1:
        provider: 'yfloresta'
        price: 5000.0

prices-per-level

Preço que aumenta a cada nível.

Exemplo:

enchants:
  efficiency:
    prices-per-level:
      price1:
        provider: 'yfloresta'
        price: 1000.0

prices-disenchanter

Valor de reembolso ao desencantar.

Exemplo:

enchants:
  efficiency:
    prices-disenchanter:
      price1:
        provider: 'yfloresta'
        price: 500.0

Displays

Itens exibidos no menu em diferentes estados.

can

Quando o jogador pode evoluir.

Exemplo:

displays:
  can:
    material: DIAMOND_PICKAXE
    name: '&aEficiência'
    lore:
      - '&f > Nível: &b{actual}&f/&b{maximum}&f.'
      - '&f > Custo: &a{yfloresta} folhas&f.'
      - ''
      - '&aClique para evoluir'

Placeholders: {actual}, {maximum}, {yfloresta}, {level}, {percentage}, {multiplier}

cant

Quando o jogador não pode evoluir.

Exemplo:

displays:
  cant:
    material: DIAMOND_PICKAXE
    name: '&cEficiência'
    lore:
      - '&cVocê não tem recursos suficientes.'

maximum

Quando já está no nível máximo.

Exemplo:

displays:
  maximum:
    material: DIAMOND_PICKAXE
    name: '&aEficiência'
    lore:
      - '&aVocê já está no máximo!'

Mensagens

Mensagens exibidas ao ativar o encantamento.

Exemplo:

enchants:
  explosion:
    messages:
      title: '&cExplosão<nl>&cativado'
      actionbar: '&cExplosão ativada!'
      chat: ''

Animação

Ativa animação visual ao usar o encantamento.

Exemplo:

enchants:
  explosion:
    animation: true

Radius

Raio de efeito do encantamento (para encantamentos de área).

Exemplo:

enchants:
  explosion:
    radius: 2
  sphere:
    radius: 5

Commands (custom_enchants)

Comandos executados ao ativar o encantamento customizado.

Exemplo:

enchants:
  chaveiro:
    commands: ['100.0,give {player} TRIPWIRE_HOOK 1']

Formato: chance,comando onde chance é a porcentagem de executar

Encantamentos padrão disponíveis

Encantamentos de velocidade

efficiency: Aumenta a velocidade de quebra
speed: Dá efeito de velocidade
haste: Dá efeito de pressa

Encantamentos de recompensa

fortune: Aumenta a quantidade de drops
multiplier: Multiplica os blocos quebrados
eletricity: Aumenta a energia ganha

Encantamentos de chance

lucky: Aumenta a chance de recompensas raras

Encantamentos de área

explosion: Chance de quebrar uma área em formato de explosão
laser: Chance de quebrar em formato de +
sphere: Chance de quebrar uma esfera
destructor: Quebra em formato específico
nuclear: Quebra em formato nuclear
drill: Quebra em formato de broca
inverted-destructor: Quebra invertida
linear: Quebra em linha
x: Quebra em formato de X

Outros

summoner: Invoca efeitos especiais

Criando encantamentos customizados

Para criar um encantamento customizado que executa comandos:

enchants:
  meu_encantamento:
    name: 'Meu Encantamento'
    pickaxe-level: 0
    order: 20
    show-menu: true
    can-buy: true
    level-percentage: 0.10
    level:
      default: 0.0
      maximum: 10.0
    prices-default:
      price1:
        provider: 'yfloresta'
        price: 50000.0
    prices-per-level:
      price1:
        provider: 'yfloresta'
        price: 5000.0
    commands:
      - '100.0,give {player} DIAMOND 1'
      - '50.0,eco give {player} 1000'
    displays:
      can:
        material: DIAMOND
        name: '&bMeu Encantamento'
        lore:
          - '&7Encantamento customizado'
          - '&7que dá recompensas especiais!'
          - ''
          - '&f > Nível: &b{actual}&f/&b{maximum}&f.'
          - '&f > Chance: &b{percentage}%&f.'

Os IDs dos encantamentos não devem ser alterados após criados, pois são salvos no banco de dados.

Nesta página