Encantamentos

Visão geral

O yMinasPackets possui 17 encantamentos customizados que podem ser aplicados nas picaretas. Cada encantamento possui configurações detalhadas de níveis, preços, permissões e comportamentos.

Estrutura básica de configuração

Todos os encantamentos seguem esta estrutura:

enchants:
  efficiency:
    # Nome de exibição
    name: 'Eficiência'
    # Nível da picareta necessário
    pickaxe-level: 0
    # Ordem no menu
    order: 1
    # Mostrar no menu
    show-menu: true
    # Pode comprar no menu
    can-buy: true
    # Mostrar símbolo infinito
    show-infinity: true
    # Configuração de níveis
    level:
      default: 1000.0
      maximum: 1000.0  # -1 para infinito
    # Opções do encantamento
    options:
      delay: 0
      xp: true
      xp-mcmmo: true
      economy: true
      blocks: true
      energy: true
      custom-enchant: true
      rewards: true
      permission: ''
      permission-buy: ''
      skin-whitelist: []
      show-skin-whitelist: false
    # Multiplicador de preço
    price-multiplier: 1.00
    # Multiplicador de economia
    economy-multiplier: 1.00
    # Preços para evoluir
    prices-default:
      price1:
        provider: 'yminaspackets'
        price: 10000.0
    prices-per-level:
      price1:
        provider: 'yminaspackets'
        price: 10000.0
    # Preço para desincantar
    prices-disenchanter:
      price2:
        provider: 'yminaspackets'
        price: 100.0
    # Livro do encantamento
    book:
      material: ENCHANTED_BOOK
      name: '&bLivro de Eficiência &7(MINA)'
      lore: [...]
    # Displays no menu
    displays:
      can: # Quando pode evoluir
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore: [...]
      cant: # Quando não pode evoluir
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore: [...]
      permission: # Quando não tem permissão
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore: [...]
      maximum: # Quando está no máximo
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore: [...]

Opções de configuração

Configurações básicas

name

Nome de exibição do encantamento.

enchants:
  efficiency:
    name: 'Eficiência'

pickaxe-level

Nível mínimo da picareta para poder evoluir o encantamento.

enchants:
  efficiency:
    pickaxe-level: 0  # Sem requisito
  destruction:
    pickaxe-level: 50  # Requer picareta nível 50

order

Ordem de exibição no menu de encantamentos.

enchants:
  efficiency:
    order: 1  # Primeiro no menu
  fortune:
    order: 2  # Segundo no menu

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

enchants:
  efficiency:
    show-menu: true

can-buy

Define se o jogador pode comprar/evoluir o encantamento no menu.

enchants:
  efficiency:
    can-buy: true

show-infinity

Mostra o símbolo infinito (∞) no lugar do nível na lore da picareta.

enchants:
  efficiency:
    show-infinity: true  # Mostra: Eficiência ∞

Configurações de nível

level

Define o nível padrão e máximo do encantamento.

enchants:
  efficiency:
    level:
      default: 1000.0  # Nível inicial
      maximum: 1000.0  # Nível máximo
  fortune:
    level:
      default: 0.0
      maximum: 10.0
  nuclear:
    level:
      default: 0.0
      maximum: -1  # Sem limite

level-percentage

Define a porcentagem de chance por nível (usado em encantamentos de chance).

enchants:
  nuclear:
    level-percentage: 0.15  # 0.15% por nível

Esta opção é usada em encantamentos como Nuclear, Destructor, etc. O placeholder {percentage} mostra a chance calculada.

Opções do encantamento

options.delay

Tempo de espera em segundos para usar o encantamento novamente.

enchants:
  efficiency:
    options:
      delay: 0  # Sem cooldown
  nuclear:
    options:
      delay: 60  # 60 segundos de cooldown

options.xp

Ativa o drop de experiência vanilla ao minerar com este encantamento.

enchants:
  efficiency:
    options:
      xp: true

options.xp-mcmmo

Ativa o ganho de XP do mcMMO ao minerar.

enchants:
  efficiency:
    options:
      xp-mcmmo: true

options.economy

Ativa o ganho de dinheiro ao minerar.

enchants:
  efficiency:
    options:
      economy: true

options.blocks

Ativa o ganho de blocos ao minerar.

enchants:
  efficiency:
    options:
      blocks: true

options.energy

Ativa o ganho de energia para a picareta.

enchants:
  efficiency:
    options:
      energy: true

options.custom-enchant

Ativa os custom enchants configurados.

enchants:
  efficiency:
    options:
      custom-enchant: true

options.rewards

Ativa as recompensas configuradas em mine_rewards.yml.

enchants:
  efficiency:
    options:
      rewards: true

options.permission

Permissão necessária para usar o encantamento. Deixe vazio para não exigir.

enchants:
  efficiency:
    options:
      permission: ''  # Sem permissão
  vip-enchant:
    options:
      permission: 'mina.enchant.vip'

options.permission-buy

Permissão necessária para comprar/evoluir o encantamento.

enchants:
  efficiency:
    options:
      permission-buy: ''

options.skin-whitelist

Lista de skins (por order) que podem usar este encantamento. Deixe vazio para todas.

enchants:
  efficiency:
    options:
      skin-whitelist: []  # Todas as skins
  special-enchant:
    options:
      skin-whitelist: [3, 4]  # Apenas skins com order 3 e 4

options.show-skin-whitelist

Mostrar o encantamento no menu mesmo se o jogador não tiver a skin necessária.

enchants:
  efficiency:
    options:
      show-skin-whitelist: false

Configurações de preço

price-multiplier

Multiplicador aplicado aos preços do encantamento.

enchants:
  efficiency:
    price-multiplier: 1.00  # Preço normal
  expensive:
    price-multiplier: 2.50  # Preço 2.5x maior

economy-multiplier

Multiplicador aplicado aos ganhos de economia ao usar este encantamento. Permite balancear diferentes encantamentos para diferentes tipos de economia.

enchants:
  efficiency:
    economy-multiplier: 1.00  # Ganho normal
  nuclear:
    economy-multiplier: 2.0  # Dobra o ganho
  laser:
    economy-multiplier: 1.5  # 50% a mais

Explicação:

Este multiplicador é aplicado aos ganhos monetários quando um jogador minera usando o encantamento
Valores maiores que 1.0 aumentam o ganho de economia
Valores menores que 1.0 diminuem o ganho de economia
Útil para balancear encantamentos poderosos e evitar inflação

Exemplo prático:

Se um bloco dá 100 moedas e o multiplicador é 1.5:

O jogador receberá 150 moedas ao minerar com o encantamento

enchants:
  nuclear:
    name: 'Nuclear'
    economy-multiplier: 0.5  # Reduz para 50% do ganho
    level:
      default: 0.0
      maximum: 10.0
  explosion:
    name: 'Explosão'
    economy-multiplier: 1.8  # Aumenta para 180% do ganho
    level:
      default: 0.0
      maximum: 5.0

Configure este valor com cuidado para manter o balanceamento da economia do servidor. Encantamentos muito poderosos devem ter multiplicadores menores.

prices-default

Preço inicial para comprar o encantamento pela primeira vez.

enchants:
  efficiency:
    prices-default:
      price1:
        provider: 'yminaspackets'
        price: 10000.0

prices-per-level

Preço para evoluir cada nível do encantamento.

enchants:
  efficiency:
    prices-per-level:
      price1:
        provider: 'yminaspackets'
        price: 10000.0

Providers disponíveis:

yminaspackets - Blocos minerados
money - Economia principal
Outras economias configuradas

Você pode adicionar múltiplos custos usando price1, price2, etc.

prices-disenchanter

Preço para remover o encantamento da picareta.

enchants:
  efficiency:
    prices-disenchanter:
      price2:
        provider: 'yminaspackets'
        price: 100.0

Mensagens

Alguns encantamentos possuem mensagens customizadas ao serem ativados:

enchants:
  nuclear:
    messages:
      title: '&cNuclear<nl>&cativado'
      actionbar: '&cEncantamento Nuclear ativado!'
      chat: '<nl>&c&lNUCLEAR: &cAtivado com sucesso!<nl>'
      sound: 'EXPLODE'

Configurações visuais

animation

Define se o encantamento possui animação ao ser ativado.

enchants:
  destructor:
    animation: true

book

Configuração do livro do encantamento.

enchants:
  efficiency:
    book:
      material: ENCHANTED_BOOK
      name: '&bLivro de Eficiência &7(MINA)'
      lore:
        - '&7Este encantamento permite que você'
        - '&7minere com mais agilidade.'
        - ''
        - '&f > Nível: &b{amount}&f.'
        - ''
        - '&aBotão &fdireito &apara ativar'

Placeholders no livro:

{amount} - Quantidade de níveis no livro

displays

Configuração dos itens exibidos no menu em diferentes estados.

enchants:
  efficiency:
    displays:
      can:
        # Quando pode evoluir
        material: DIAMOND_PICKAXE
        name: '&aEficiência'
        lore:
          - '&f > Nível: &b{actual}&f/&b{maximum}&f.'
          - '&f > Custo: &a{yminaspackets} blocos&f.'
          - ''
          - '&aClique para evoluir'
      cant:
        # Quando não tem recursos
        lore:
          - '&cVocê não tem blocos suficientes.'
      permission:
        # Quando não tem permissão
        lore:
          - '&cVocê não tem permissão.'
      maximum:
        # Quando está no máximo
        lore:
          - '&cVocê já está no máximo.'

Placeholders nos displays:

{actual} - Nível atual
{maximum} - Nível máximo
{percentage} - Porcentagem de chance (se aplicável)
{level} - Nível da picareta necessário
{yminaspackets} - Preço em blocos
{money} - Preço em dinheiro

Lista dos 17 encantamentos

1. Efficiency (Eficiência)

Permite minerar com mais agilidade (velocidade de quebra).

efficiency:
  name: 'Eficiência'
  show-infinity: true
  level:
    default: 1000.0
    maximum: 1000.0

2. Fortune (Fortuna)

Aumenta a quantidade de recursos obtidos ao minerar.

fortune:
  name: 'Fortuna'
  show-infinity: false
  level:
    default: 0.0
    maximum: 10.0

3. Nuclear

Chance de quebrar a mina inteira ao minerar um bloco.

nuclear:
  name: 'Nuclear'
  level-percentage: 0.15  # 0.15% por nível
  level:
    default: 0.0
    maximum: 10.0
  messages:
    title: '&cNuclear<nl>&cativado'

4. Destructor (Destruidor)

Chance de quebrar uma camada inteira de blocos.

destructor:
  name: 'Destruidor'
  animation: true
  level-percentage: 0.15
  level:
    default: 0.0
    maximum: 10.0
  messages:
    title: '&cDestruidor<nl>&cativado'

5. Summoner (Sumonador)

Chance de transformar um bloco em LuckyBlock ao quebrá-lo.

summoner:
  name: 'Sumonador'
  level-percentage: 0.15
  level:
    default: 0.0
    maximum: 10.0

Requer o plugin yLuckyBlock instalado para funcionar!

6. Speed (Velocidade)

Aplica efeito de velocidade ao jogador na mina.

speed:
  name: 'Velocidade'
  level:
    default: 0.0
    maximum: 1.0

7. Haste (Pressa)

Aplica efeito de pressa (mineração rápida) ao jogador.

haste:
  name: 'Pressa'
  level:
    default: 0.0
    maximum: 3.0

8. Lucky (Sorte)

Chance de ativar eventos especiais ao minerar.

lucky:
  name: 'Sorte'
  level-percentage: 0.15
  level:
    default: 0.0
    maximum: 10.0

9. Explosion (Explosão)

Quebra blocos em área ao redor do bloco minerado.

explosion:
  name: 'Explosão'
  animation: true
  level:
    default: 0.0
    maximum: 5.0

10. Laser

Quebra uma linha de blocos na direção que o jogador está olhando.

laser:
  name: 'Laser'
  level:
    default: 0.0
    maximum: 10.0

11. Drill (Broca)

Quebra blocos em formato de broca/espiral.

drill:
  name: 'Broca'
  animation: true
  level:
    default: 0.0
    maximum: 5.0

12. Multiplier (Multiplicador)

Multiplica a quantidade de recursos obtidos.

multiplier:
  name: 'Multiplicador'
  level:
    default: 0.0
    maximum: 10.0

13. Eletricity (Eletricidade)

Efeito elétrico que quebra blocos adjacentes.

eletricity:
  name: 'Eletricidade'
  animation: true
  level:
    default: 0.0
    maximum: 5.0

14. Sphere (Esfera)

Quebra blocos em formato esférico.

sphere:
  name: 'Esfera'
  animation: true
  level:
    default: 0.0
    maximum: 5.0

15. X

Quebra blocos em formato de X.

x:
  name: 'X'
  animation: true
  level:
    default: 0.0
    maximum: 3.0

16. Linear

Quebra uma linha horizontal de blocos.

linear:
  name: 'Linear'
  level:
    default: 0.0
    maximum: 10.0

17. Inverted Destructor (Destruidor Invertido)

Similar ao Destructor, mas quebra camadas de baixo para cima.

inverted-destructor:
  name: 'Destruidor Invertido'
  animation: true
  level-percentage: 0.15
  level:
    default: 0.0
    maximum: 10.0

18. Abelha Explosiva (Bee Explosive)

Invoca abelhas explosivas ao minerar, causando dano em área ao redor do bloco quebrado.

bee-explosive:
  name: 'Abelha Explosiva'
  level-percentage: 0.10
  level:
    default: 0.0
    maximum: 10.0

Este encantamento faz parte do addon Deluxe (addons/deluxe.yml).

19. Magma

Transforma os blocos ao redor em magma ao minerar, criando um efeito de área com blocos de magma.

magma-enchant:
  name: 'Magma'
  level-percentage: 0.10
  level:
    default: 0.0
    maximum: 10.0

Este encantamento faz parte do addon Deluxe (addons/deluxe.yml).

Criando livros de encantamento

Para dar um livro de encantamento a um jogador:

/minaadm give enchant <jogador> <encantamento> <nível>

Exemplo:

/minaadm give enchant Player123 efficiency 100

Desencantando

Os jogadores podem remover encantamentos através do menu de desencantamento, pagando o preço configurado em prices-disenchanter.

Combinando encantamentos

Uma picareta pode ter múltiplos encantamentos simultaneamente!

Dica de balanceamento:

Encantamentos passivos (Efficiency, Fortune, Speed, Haste) funcionam sempre
Encantamentos de área (Destructor, Explosion, etc.) podem ter delay (cooldown)
Encantamentos de chance (Nuclear, Summoner, Lucky) usam level-percentage

Customização avançada

Criando um encantamento exclusivo VIP

enchants:
  vip-fortune:
    name: '&6Fortuna VIP'
    pickaxe-level: 0
    order: 99
    show-menu: true
    can-buy: true
    show-infinity: false
    level:
      default: 0.0
      maximum: 20.0
    options:
      permission: 'mina.vip'
      permission-buy: 'mina.vip'
    price-multiplier: 0.50  # 50% mais barato
    prices-per-level:
      price1:
        provider: 'yminaspackets'
        price: 5000.0

Criando encantamento com múltiplos custos

enchants:
  premium-nuclear:
    name: '&b&lNuclear Premium'
    prices-per-level:
      price1:
        provider: 'yminaspackets'
        price: 50000.0
      price2:
        provider: 'money'
        price: 10000.0
      price3:
        provider: 'gems'
        price: 100

Permissões

Para usar encantamentos:

yminaspackets.use

Para acessar o menu de encantamentos:

/mina enchants

Após alterar as configurações de encantamentos, execute /minaadm reload para aplicar as mudanças.

Notas importantes

Não mude o ID do encantamento (chave no YAML), pois isso pode causar problemas de reconhecimento!

Recomendações:

Mantenha os IDs originais (efficiency, fortune, nuclear, etc.)
Ajuste apenas os valores de preços, níveis e opções
Teste o balanceamento antes de aplicar em produção
Use show-menu: false para ocultar encantamentos em desenvolvimento
Configure pickaxe-level adequadamente para criar progressão

Nesta página