Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

creeper.yml

bosses.yml

basic.yml

amulets.yml

commands.yml

config.yml

discounts.yml

economies.yml

enchants.yml

menus.yml

messages.yml

rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento dos bosses, matadoras e sistemas do plugin. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados dos jogadores (bosses mortos, dano causado, recompensas) serão armazenados. O plugin suporta três tipos de armazenamento:

SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente em plugins/yStackBosses/data.db.

Define o atraso em ticks (20 ticks = 1 segundo) para carregar os dados do jogador após o login. Útil em redes BungeeCord onde o jogador precisa sincronizar dados entre servidores.

# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

Quando ajustar:

Servidor único: Pode usar 0 ou valores baixos (5-10 ticks)
Rede BungeeCord: Use 20-40 ticks para garantir sincronização
Problemas de lag ao logar: Aumente para 40-60 ticks

limit

Sistema de limitação ao recolher recompensas no armazém. Essencial para evitar sobrecarga do servidor quando jogadores acumulam milhares de recompensas.

limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Desativar ou aumentar muito o limite pode gerar lag severo e em alguns casos crashar o servidor. Mantenha entre 500-2000 dependendo da capacidade do servidor.

Valores recomendados por tipo de servidor:

Servidor pequeno (até 50 players): max: 500
Servidor médio (50-200 players): max: 1000
Servidor grande (200+ players): max: 2000

general

Configurações gerais do comportamento dos bosses e do sistema de combate.

general:
  # Habilitar o sistema de stack-bosses
  stack: true
  # Permitir colocar bosses e matar bosses apenas nos plots
  plot: false
  # Verifica se há mobs (ou outros bosses) por perto antes de spawnar
  # Raio em blocos.
  radius: 5
  # Delay para hitar os bosses
  # Deixe 0 para não usar
  # em millisegundos
  hit-delay: 500
  # Mundos bloqueados para colocar bosses
  world-blacklist: [ 'none' ]
  # Matar todos no shift
  shift-all: false
  # Matar todos sem shift
  no-shift-all: false
  # Quantia máxima que poderá matar
  # Cuidado com valores altos
  # -1 para infinito
  kill-maximum: 1000
  # Deletar a recompensa ao clicar com botão direito
  right-delete-reward: true
  # Blacklist de entidades que não serão verificadas no raio de "Mobs por perto"
  nearby-entity-blacklist: [ 'PLAYER', 'DROPPED_ITEM', 'ARROW', 'SPLASH_POTION', 'EXPERIENCE_ORB', 'THROWN_EXP_BOTTLE', 'SNOWBALL', 'EGG', 'ITEM' ]
  # Blacklist de metadata que não serão verificadas no raio de "Mobs por perto"
  nearby-metadata-blacklist: [ 'mascote' ]

Destaques importantes:

stack: Ative para permitir que múltiplos bosses sejam agrupados em uma única entidade
plot: Ative se quiser integração com PlotSquared (requer plugin instalado)
radius: Distância de verificação de mobs próximos. Valores altos podem causar lag
hit-delay: Previne spam de cliques. Use 200-500ms para servidores PvP balanceados
kill-maximum: Limite de bosses stackados que podem ser mortos de uma vez. -1 para infinito pode causar lag severo
world-blacklist: Útil para bloquear mundos de spawn ou lobbies

Exemplo para servidor com PlotSquared:

general:
  stack: true
  plot: true  # Bosses só podem ser colocados/mortos em plots do jogador
  radius: 10
  hit-delay: 300
  world-blacklist: [ 'world', 'spawn', 'lobby' ]
  kill-maximum: 500

plot-boss-limit

Limite de boss por terreno/plot

# Limite de boss por terreno/plot
# Quando ativado, apenas um tipo de boss pode ser colocado por terreno
# Isso evita que jogadores ou amigos com trust coloquem múltiplos stacks do mesmo boss
plot-boss-limit:
  # Habilitar o limite de boss por terreno
  enabled: false

effects

Define os efeitos visuais e sonoros quando os bosses aplicam efeitos nos jogadores. Estes efeitos são configurados individualmente em cada boss no arquivo da pasta bosses/.

effects:
  explosion:
    # Lista da 1.8: https://helpch.at/docs/1.8/org/bukkit/Sound.html
    # Lista da 1.16: https://helpch.at/docs/1.16.2/org/bukkit/Sound.html
    # Lista da 1.18: https://helpch.at/docs/1.18/org/bukkit/Sound.html
    sound: 'EXPLODE'
    # Lista da 1.8: https://helpch.at/docs/1.8/org/bukkit/Effect.html
    # Lista da 1.16: https://helpch.at/docs/1.16.2/org/bukkit/Effect.html
    # Lista da 1.18: https://helpch.at/docs/1.18/org/bukkit/Effect.html
    particle1: 'LAVA'
    particle2: 'VILLAGER_ANGRY'
    particle3: 'CLOUD'
  # Lista da 1.8: https://helpch.at/docs/1.8/org/bukkit/potion/PotionEffectType.html
  # Lista da 1.16: https://helpch.at/docs/1.16.2/org/bukkit/potion/PotionEffectType.html
  # Lista da 1.18: https://helpch.at/docs/1.18/org/bukkit/potion/PotionEffectType.html
  poison: 'POISON'
  confusion: 'CONFUSION'
  blindness: 'BLINDNESS'

Tipos de efeitos disponíveis:

FOGO: Coloca o jogador em chamas
EXPLOSAO: Cria explosão visual e sonora
DANO: Causa dano direto
VENENO: Aplica efeito de veneno
EMPURRAR: Empurra o jogador para trás
NAUSEA: Aplica efeito de náusea
CEGUEIRA: Aplica efeito de cegueira

Certifique-se de usar valores compatíveis com a versão do Minecraft do seu servidor. Links de referência estão nos comentários acima.

lore

Define o formato da lore que mostra a chance de drop das recompensas no preview.

lore:
  chance: ['', '&6Chance: &f{chance}%', '']

O placeholder {chance} será substituído pela porcentagem de drop da recompensa configurada em cada boss.

progress-bar

Configuração da barra de progresso visual que aparece na actionbar ao atacar bosses, mostrando a vida restante.

progress-bar:
  amount: 10
  symbol: ':'
  color-yes: '&a'
  color-no: '&7'

Como funciona:

amount: Quantidade total de símbolos na barra (10 = ::::::::::)
symbol: Caractere usado na barra (pode ser |, █, ▌, etc)
color-yes: Cor dos símbolos representando vida restante (verde)
color-no: Cor dos símbolos representando vida perdida (cinza)

Exemplo visual:

Boss com 70% de vida: &a:::::::&7::: Boss com 30% de vida: &a:::&7:::::::

damage

Sistema de livros de encantamento para aumentar o dano das matadoras. Jogadores podem usar estes livros para adicionar dano extra nas suas matadoras.

damage:
  # Mensagens
  give-book: '&bVocê deu &71x Livro de Dano {damage}&b para o jogador &f{player}.'
  received-book: '&bVocê recebeu &71x Livro de Dano {damage}&b.'
  maximum: '&cVocê não pode encantar esta espada, pois ela já está no máximo, com {damage} em Dano.'
  converted: '&bVocê compactou todos seus livros em 1.'
  # Item da sharpness ativável
  usable-item:
    material: ENCHANTED_BOOK
    name: '&b+{damage} Dano'
    lore:
      - ''
      - '&fDano: &b{damage}'
      - ''
      - '&7Clique em uma matadora para ativar.'

Como funciona:

Administradores dão livros com /boss givebookdamage <player> <quantidade>
Jogadores clicam com o livro em uma matadora para aplicar o dano
O dano é permanentemente adicionado à matadora
Múltiplos livros podem ser compactados em um único livro maior

Placeholders disponíveis: {damage} - Quantidade de dano do livro, {player} - Nome do jogador

stack

Sistema de livros de encantamento para aumentar o multiplicador de kill-stack das matadoras. Este encantamento permite matar múltiplos bosses de uma vez.

stack:
  # Mensagens
  give-book: '&bVocê deu &71x Livro de Kill-Stack {stack}&b para o jogador &f{player}.'
  received-book: '&bVocê recebeu &71x Livro de Kill-Stack {stack}&b.'
  maximum: '&cVocê não pode encantar esta espada, pois ela já está no máximo, com {stack} em Kill-Stack.'
  converted: '&bVocê compactou todos seus livros em 1.'
  # Item da sharpness ativável
  usable-item:
    material: ENCHANTED_BOOK
    name: '&b+{stack} Kill-Stack'
    lore:
      - ''
      - '&fKill-Stack: &b{stack}'
      - ''
      - '&7Clique em uma matadora para ativar.'

Como funciona:

Administradores dão livros com /boss givestackdamage <player> <quantidade>
Jogadores clicam com o livro em uma matadora para aplicar o stack
O multiplicador é permanentemente adicionado à matadora
Uma matadora com stack x5 matará 5 bosses por vez ao invés de 1

Exemplo prático:

Matadora base: x1 (mata 1 boss por hit)
Matadora + livro x2: x3 (mata 3 bosses por hit)
Matadora + livro x5: x8 (mata 8 bosses por hit)

Valores muito altos de stack podem causar lag ao matar centenas de bosses simultaneamente. Recomenda-se limitar a x50-x100.

Placeholders disponíveis: {stack} - Multiplicador do livro, {player} - Nome do jogador

Nesta página