yMinasPacketsBazooka

Visao Geral

O yMinasPacketsBazookaAddon adiciona itens de bazuca que disparam um missil visual dentro da mina do jogador. Ao atingir o alvo, a bazuca quebra blocos em area, podendo entregar recompensas e acionar lucky-blocks conforme a configuracao.

Arquivo principal:

plugins/yMinasPackets/addons/bazooka.yml

Arquivo fonte padrao:

src/main/resources/addons/bazooka.yml

Ativacao

O arquivo addons/bazooka.yml so e carregado quando o addon yMinasPacketsBazookaAddon esta ativo no bootstrap.

No codigo, a verificacao e feita por:

BukkitBootstrap.isActivated("yMinasPacketsBazookaAddon")

Se o addon nao estiver ativo, as bazucas nao serao carregadas e o comando de entrega nao tera bazucas registradas.

Como Usar

1. Instale o addon yMinasPacketsBazookaAddon junto com o yMinasPackets.
2. Configure as bazucas em addons/bazooka.yml.
3. Reinicie o servidor ou use o reload do plugin.
4. Entregue uma bazuca ao jogador com /minaadmin givebazooka.
5. O jogador deve estar dentro de uma mina para usar a bazuca.
6. O disparo e feito com clique direito segurando o item.

Comando Administrativo

Dar Bazuca

/minaadmin givebazooka <bazuca> <player> <quantia>

Alias aceito:

/minaadmin darbazooka <bazuca> <player> <quantia>

Permissao:

yminaspackets.admin.givebazooka

Exemplo:

/minaadmin givebazooka bazooka-small Steve 1

Se a bazuca informada nao existir, o plugin envia a lista de bazucas carregadas.

Permissoes de Uso

Cada bazuca pode ter uma permissao propria em:

permission: ''

Se o valor estiver vazio, qualquer jogador que tenha a bazuca e esteja em uma mina podera usa-la.

Exemplo com permissao:

permission: 'yminaspackets.bazooka.large'

Bazucas Padrao

bazooka-small

bazooka-small:
  message-display: '&cBAZUCA PEQUENA'
  permission: ''
  uses: 3
  reload-delay: 30
  radius: 4
  reward: true
  luckyblock: true

Resumo:

• Nome exibido: BAZUCA PEQUENA
• Permissao: nenhuma
• Usos antes da recarga: 3
• Recarga: 30 segundos
• Raio: 4 blocos
• Da recompensas: sim
• Ativa lucky-block: sim

bazooka-large

bazooka-large:
  message-display: '&4BAZUCA GRANDE'
  permission: 'yminaspackets.bazooka.large'
  uses: 2
  reload-delay: 60
  radius: 7
  reward: true
  luckyblock: true

Resumo:

• Nome exibido: BAZUCA GRANDE
• Permissao: yminaspackets.bazooka.large
• Usos antes da recarga: 2
• Recarga: 60 segundos
• Raio: 7 blocos
• Da recompensas: sim
• Ativa lucky-block: sim

Estrutura do YAML

Todas as bazucas ficam dentro da secao:

bazookas:
  id-da-bazuca:
    ...

O id-da-bazuca e a chave usada no comando /minaadmin givebazooka e tambem e salva no NBT do item.

Opcoes da Bazuca

message-display

Nome usado nas mensagens de chat e actionbar.

message-display: '&cBAZUCA PEQUENA'

permission

Permissao necessaria para disparar a bazuca.

permission: 'yminaspackets.bazooka.large'

Use vazio para nao exigir permissao:

permission: ''

uses

Quantidade de disparos antes da recarga.

uses: 3

O valor atual de usos e salvo no proprio item por NBT.

reload-delay

Tempo de recarga em segundos depois que os usos acabam.

reload-delay: 30

Enquanto a bazuca esta recarregando, o jogador recebe mensagem/actionbar com o tempo restante.

radius

Raio da explosao em blocos.

radius: 4

Internamente, a explosao usa uma area esferica ao redor do impacto.

reward

Controla se os blocos quebrados pela bazuca entregam recompensas/economias.

reward: true

Se for false, os blocos sao removidos visualmente, mas nao passam pelo calculo de recompensas.

luckyblock

Controla se lucky-blocks podem ser ativados pelos blocos quebrados.

luckyblock: true

Essa opcao so tem efeito quando reward esta ativo, pois o processamento dos blocos usa a rotina de recompensas.

Efeitos

effects:
  sound: 'EXPLODE'
  effect: 'EXPLOSION_LARGE'

sound

Som tocado no impacto.

Use nomes validos de Sound do Bukkit para a versao do servidor.

effect

Efeito visual executado no impacto.

Use nomes validos de Effect do Bukkit para a versao do servidor.

Missil

missile:
  trail-particle: 'FLAME'
  trail-particle-secondary: 'SMOKE_NORMAL'
  steps: 25
  range: 30
  gravity: 0.003

trail-particle

Particula principal do rastro do missil.

trail-particle-secondary

Particula secundaria do rastro.

steps

Quantidade de passos da trajetoria.

Quanto maior o valor, mais suave fica o movimento do missil.

range

Alcance maximo do missil em blocos.

O alvo e buscado na direcao em que o jogador esta olhando, limitado ao cuboid da mina.

gravity

Forca da curva parabolica do missil.

Formula usada:

arcY = -gravity * step * step

Valores menores deixam o disparo mais reto. Valores maiores deixam a trajetoria mais curva.

Item

item:
  material: 'BLAZE_ROD'
  name: '&c&lBAZUCA &7({uses}/{max-uses})'
  lore:
    - '&7Dispare um missil explosivo que'
    - '&7quebra blocos ao redor do impacto.'

material

Material do item. Tambem aceita hash de skull quando o sistema de SetupItem reconhece o valor.

name

Nome exibido no item.

lore

Descricao exibida no item.

O nome e a lore sao atualizados automaticamente quando os usos mudam.

Placeholders do Item

Disponiveis em item.name e item.lore:

Mensagens Relacionadas

As mensagens ficam em messages.yml.

chat:
  bazooka-give: ...
  bazooka-received: ...
  bazooka-list: ...
  bazooka-wait: ...
  bazooka-reloading: ...
  bazooka-not-in: ...
actionbar:
  bazooka-reloading: ...

Placeholders usados nas mensagens:

Comportamento em Jogo

O jogador precisa estar dentro de uma mina para disparar.

O clique direito cancela a interacao normal e dispara o missil.

O item nao pode ser colocado como bloco.

Os usos e a recarga ficam salvos no NBT do proprio item.

Ao trocar de slot, o actionbar de recarga e cancelado se o novo item nao for uma bazuca em recarga.

Quando a recarga termina, os usos sao restaurados no proximo uso do item.

NBT Usado pelo Addon

O addon marca os itens de bazuca com NBTs internos:

Nao edite esses valores manualmente.

Exemplo de Nova Bazuca

bazookas:
  bazooka-vip:
    message-display: '&6BAZUCA VIP'
    permission: 'yminaspackets.bazooka.vip'
    uses: 5
    reload-delay: 45
    radius: 6
    reward: true
    luckyblock: true
    effects:
      sound: 'EXPLODE'
      effect: 'EXPLOSION_LARGE'
    missile:
      trail-particle: 'FLAME'
      trail-particle-secondary: 'SMOKE_NORMAL'
      steps: 30
      range: 35
      gravity: 0.003
    item:
      material: 'BLAZE_ROD'
      name: '&6&lBAZUCA VIP &7({uses}/{max-uses})'
      lore:
        - '&7Raio: &6{radius}'
        - '&7Usos: &f{uses}/{max-uses}'
        - '&7Recarga: &f{reload-delay}s'
        - ''
        - '&aClique direito para disparar.'

Depois de configurar, entregue com:

/minaadmin givebazooka bazooka-vip <player> 1

Problemas Comuns

A bazuca nao aparece na lista

Verifique se o addon yMinasPacketsBazookaAddon esta ativo e se a secao bazookas existe no YAML.

O jogador nao consegue usar

Verifique se ele esta dentro de uma mina e se possui a permissao definida em permission.

A recarga nao aparece no actionbar

Verifique se actionbar.bazooka-reloading esta configurado em messages.yml.

O item nao atualiza os usos

Use apenas itens entregues pelo comando do plugin. Itens clonados sem NBT nao sao reconhecidos como bazucas.