yMinasPacketsDeluxe

Visao Geral

O yMinasPacketsDeluxeAddon adiciona recursos visuais e encantamentos avancados ao yMinasPackets.

Arquivo principal:

plugins/yMinasPackets/addons/deluxe.yml

Arquivo fonte padrao:

src/main/resources/addons/deluxe.yml

Ativacao

O arquivo addons/deluxe.yml so e carregado quando o addon yMinasPacketsDeluxeAddon esta instalado e acessivel.

No codigo, a verificacao e feita tentando acessar:

com.ystoreplugins.yminaspacketsdeluxeaddon.Main.get()

Se o addon nao estiver ativo, as configuracoes Deluxe e seus encantamentos nao sao carregados.

Recursos Principais

O arquivo padrao possui:

Observacao: o arquivo tambem possui secoes bee-explosive e magma-enchant, mas neste codigo os valores efetivamente usados para esses recursos privados sao carregados de private/orfz.yml, nao da constante Deluxe.

Boss-Bar

Configuracao padrao:

boss-bar:
  enabled: true
  delay: 3
  progress: -1
  bar: 'Energia: {energy}/{next_energy} - {percentage}'

enabled

Ativa ou desativa a boss-bar.

enabled: true

A boss-bar so e exibida para jogadores que estao dentro de uma mina.

delay

Intervalo de atualizacao em segundos.

delay: 3

O task roda assincronamente a cada 20 * delay ticks.

progress

Define o preenchimento da barra.

progress: -1

Use -1 para usar automaticamente a porcentagem de energia atual em relacao a proxima energia.

Se usar outro valor, ele e enviado diretamente como progresso da boss-bar.

bar

Texto exibido na boss-bar.

bar: 'Energia: {energy}/{next_energy} - {percentage}'

Tambem passa pelo PlaceholderAPI se o plugin estiver instalado.

Placeholders da Boss-Bar

Exemplo:

bar: '&aNivel {level} &7| &eEnergia {energy}/{next_energy} &7({percentage})'

Configuracoes Extras do Magnet

magnet:
  block-amount: 100
  duration: 20

block-amount

Quantidade de blocos usada pela animacao/sistema do magnetismo.

block-amount: 100

duration

Duracao da animacao em segundos.

duration: 20

O codigo usa magnet.duration para definir o tempo da MagnetAnimation.

Configuracoes Extras do Vampire

vampire:
  messages:
    title: 'Aproveite o luar...'
    actionbar: ''
    chat: ''
  bonus-per-level: 1.0
  particle: 'soul'
  time: 10
  weather:
    night-time: 18000
    day-time: -1

messages.title

Titulo usado durante o efeito do vampire.

messages.actionbar

Actionbar usada durante o efeito.

messages.chat

Mensagem de chat usada durante o efeito.

bonus-per-level

Bonus percentual por nivel do encantamento enquanto o efeito esta ativo.

bonus-per-level: 1.0

O bonus calculado e:

nivel-do-vampire * bonus-per-level

Esse bonus e aplicado no calculo de ganhos da mina enquanto o jogador esta com o efeito ativo.

particle

Particula visual ao redor do jogador.

particle: 'soul'

time

Tempo total do efeito em segundos.

time: 10

weather.night-time

Tempo/clima visual usado para simular noite.

night-time: 18000

weather.day-time

Tempo/clima visual usado para restaurar o estado anterior.

day-time: -1

Use -1 para tentar reutilizar o clima/tempo anterior.

Encantamentos Deluxe

Todos ficam dentro de:

enchants:
  id-do-encantamento:
    ...

O ID precisa ser mantido, pois o codigo reconhece os encantamentos pelas chaves fixas.

Funcionamento Geral dos Encantamentos

Os encantamentos Deluxe seguem a mesma base do sistema de encantamentos:

• O addon Deluxe precisa estar ativo.
• O jogador precisa ter nivel maior que 0 no encantamento.
• O encantamento nao pode estar bloqueado.
• A chance e level-percentage * nivel.
• Boosts de SingleBoosts para enchants podem multiplicar a chance.
• options.permission, quando configurado, exige permissao para ativar.
• options.skin-whitelist, quando configurado, restringe por skin.
• options.delay, quando configurado, aplica cooldown.

Campos dos Encantamentos

name

Nome do encantamento.

name: '§aGuardian'

pickaxe-level

Nivel minimo da picareta para evoluir.

pickaxe-level: 500

order

Ordem do icone no menu.

order: 18

show-menu

Define se aparece no menu.

show-menu: true

can-buy

Define se pode ser comprado/evoluido.

can-buy: true

show-infinity

Define se mostra infinito no lugar do nivel.

show-infinity: false

level-percentage

Chance por nivel.

level-percentage: 0.0002

radius

Raio de acao do encantamento, quando aplicavel.

radius: 20

level

Nivel inicial e maximo.

level:
  default: 0.0
  maximum: 3000.0

messages

Mensagens enviadas ao ativar.

messages:
  title: '&3Guardian<nl>&fDisparando lasers...'
  actionbar: ''
  chat: ''

prices-default

Custo base para comprar/evoluir.

prices-per-level

Custo por nivel adicional.

prices-disenchanter

Valor usado ao desencantar.

displays

Itens exibidos no menu para os estados can, cant e maximum.

Placeholders dos Displays

Guardian

ID:

guardian

Funcao:

O Guardian cria uma animacao de entidade Guardian e quebra blocos em uma area pequena ao redor do bloco minerado.

Configuracao padrao relevante:

guardian:
  name: '§aGuardian'
  pickaxe-level: 500
  level-percentage: 0.0002
  radius: 20
  level:
    maximum: 3000.0

Observacoes:

• O codigo limita a uma animacao ativa por jogador.
• O codigo evita iniciar se houver muitas tasks de particula ativas.
• A ativacao depende da chance configurada e do nivel do encantamento.

Twister

ID:

twister

Funcao:

O Twister cria uma animacao de tornado na mina.

Configuracao padrao relevante:

twister:
  name: '§aTornado'
  pickaxe-level: 700
  level-percentage: 0.0001
  radius: 10
  level:
    maximum: 4000.0

Observacoes:

• O codigo limita a uma animacao ativa por jogador.
• A animacao e cancelada/evitada se a mina for resetada durante o processo.

Magnet

ID:

magnet

Funcao:

O Magnetismo cria uma animacao que atrai/processa blocos proximos.

Configuracao padrao relevante:

magnet:
  name: '§aMagnetismo'
  pickaxe-level: 120
  level-percentage: 0.001
  radius: 250
  level:
    maximum: 1000.0

Configuracao extra usada:

magnet:
  block-amount: 100
  duration: 20

Observacoes:

• A duracao da animacao vem de magnet.duration.
• O codigo limita a uma animacao ativa por jogador.

Vampire / Crepusculo

ID:

vampire

Funcao:

Ativa um estado temporario que aplica bonus de ganhos por nivel e efeitos visuais/climaticos.

Configuracao padrao relevante:

vampire:
  name: '§aCrepúsculo'
  pickaxe-level: 1250
  level-percentage: 0.000001
  radius: 30
  level:
    maximum: 50000.0

Configuracao extra usada:

vampire:
  bonus-per-level: 1.0
  particle: 'soul'
  time: 10

Calculo do bonus:

bonus = nivel-do-vampire * bonus-per-level

Observacoes:

• O bonus so e aplicado enquanto a animacao/estado esta ativo.
• O codigo limita a uma animacao ativa por jogador.

Exemplo de Boss-Bar Customizada

boss-bar:
  enabled: true
  delay: 2
  progress: -1
  bar: '&aNivel {level} &8| &eEnergia &f{energy}&7/&f{next_energy} &8- &b{percentage}'

Exemplo de Ajuste do Magnet

magnet:
  block-amount: 150
  duration: 12

Exemplo de Ajuste do Vampire

vampire:
  messages:
    title: '&4Crepusculo<nl>&fBonus ativo!'
    actionbar: '&cBonus de mineracao ativo'
    chat: ''
  bonus-per-level: 0.5
  particle: 'soul'
  time: 8
  weather:
    night-time: 18000
    day-time: -1

Problemas Comuns

A boss-bar nao aparece

Verifique se o addon Deluxe esta ativo, se boss-bar.enabled esta true e se o jogador esta dentro de uma mina.

A boss-bar nao atualiza rapido o suficiente

Reduza boss-bar.delay.

O encantamento nao aparece no menu

Verifique show-menu, pickaxe-level, requisitos de permissao e se o addon Deluxe esta ativo.

O encantamento aparece, mas nao ativa

Verifique nivel atual, chance (level-percentage), cooldown (options.delay), permissao (options.permission) e skin whitelist.

O efeito esta pesado

Reduza a chance, aumente delay, diminua duracao ou reduza raio conforme o encantamento.

Bee Explosive ou Magma nao mudam ao editar deluxe.yml

Neste codigo, esses recursos usam a configuracao de private/orfz.yml quando a chave privada esta ativa. As secoes presentes em addons/deluxe.yml nao sao lidas pela classe Deluxe atual.