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.

heads.yml

cow.yml

bonus.yml

boosters.yml

commands.yml

config.yml

economies.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 spawners. 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 spawners 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/ySpawners/data.db.

Delay para carregar os dados do jogador após o login. Esta configuração é essencial quando você usa o plugin em uma rede BungeeCord/Velocity com servidor de mina separado.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

Quando aumentar este valor:

Se jogadores estão perdendo dados ao trocar de servidor
Se o plugin reporta erros de "dados não carregados" no console
Recomendado aumentar para 40-60 ticks em redes com alta latência

limit

Este limite serve para prevenir lag ao recolher grandes quantidades de drops de uma vez.

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

Desativar ou aumentar muito este limite pode gerar lag severo e até crashar o servidor ao coletar drops de spawners com muito estoque acumulado.

Recomendações:

Servidores pequenos (até 50 players): max: 1000
Servidores médios (50-150 players): max: 500
Servidores grandes (150+ players): max: 300

general

Configurações gerais que controlam o comportamento dos spawners.

general:
  # Permitir colocar spawners apenas nos plots
  plot: false
  # Limitar a quantidade de spawners por tipo em cada plot (evita abuso de amigos com trust)
  plot-spawner-limit: false
  # Regras globais de limite por plot.
  # allow-unlisted: false bloqueia spawners que não estiverem listados em spawners.
  # A chave do spawner deve ser o ID interno do tipo, não o nome formatado.
  plot-spawner-limits:
    allow-unlisted: false
    spawners:
      cow: 10
  # Verifica se há mobs (ou outros spawners) por perto antes de colocar o spawner
  # Raio em blocos.
  radius: 5
  # Delay para hitar os mobs
  # Deixe 0 para não usar
  # em millisegundos
  hit-delay: 500
  # Mundos bloqueados para colocar spawners
  world-blacklist: [ 'none' ]
  # Formato do status do spawner quebrado
  broken-status: '&cQUEBRADO'
  # Fechar inventário dos jogadores que estiverem com o spawner aberta após ele ser quebrado
  close-broken: true
  # Limite máximo de amigos que um spawner pode ter
  # deixe 0 para ser infinito
  friend-max: 0
  # Acumular os bônus que tiver permissão
  accumulate-bonus: true
  # Sistema de bolsa de valores (yBolsa, StormEconomy ou HeroBolsa)
  bolsa: true
  # Formatador de bônus
  formatter-bonus-has: '&fBônus: &a{bonus}%&7 ({display}&7)'
  formatter-bonus-no-has: ''
  # Blacklist de nbttags que não pode bater no spawner
  nbttag-blacklist: [ 'yMinas-Pickaxe', 'yPlantacoes-Enxada', 'yCampo-Tool-Type' ]
  # Blacklist de nbttags que não vai descontar durabilidade
  nbttag-durability-blacklist: [ 'yMinas-Pickaxe', 'yPlantacoes-Enxada', 'yCampo-Tool-Type' ]
  # Habilitar o spawn de mob em spawners naturais
  natural-enabled: false
  # Rodar a task de limpeza de spawners inexistentes após 5 segundos do load do servidor
  spawner-clear-task: true
  # Permitir os jogadores desligarem as máquinas
  status-change: true
  # Permitir o jogador colocar apenas 1 stack de spawner de cada tipo
  just-one: false
  # Deletar as entidades ao desligar o servidor
  delete-shutdown: false
  # Deletar a entidade quando sobrar a entidade 0
  delete-zero: false
  # Ativar o menu do drop para venda e coleta
  sell-collect-menu: false
  # Permissão para conseguir ter o auto-sell
  auto-sell-permission: ''
  # O auto-sell vir ativado por padrão no spawner
  auto-sell-default: true
  # Desativar contabilizar a looting padrão do minecraft (encantamento)
  disable-vanilla-looting: false

skills

Identificadores das skills de combate para integração com mcMMO ou AuraSkills.

# Identificadores das skills
skills:
  swords: 'SWORDS'
  axes: 'AXES'
  unarmed: 'UNARMED'

Funcionalidade:

O plugin detecta qual tipo de arma o jogador está usando e libera XP na skill correspondente ao matar mobs:

swords - XP de espada ao matar com espada
axes - XP de machado ao matar com machado
unarmed - XP de desarmado ao matar com punho

Destaques importantes:

plot

Define se spawners só podem ser colocados em plots (requer PlotSquared).

plot: false

true - Spawners só funcionam em plots
false - Spawners podem ser colocados em qualquer lugar

Quando usar: Servidores com sistema de plots/terrenos protegidos.

plot-spawner-limit e plot-spawner-limits

Controla limites por tipo de spawner dentro de cada plot. Quando plot-spawner-limit está ativo, o plugin consulta plot-spawner-limits para decidir quantos spawners de cada tipo podem existir no terreno.

general:
  plot-spawner-limit: false
  plot-spawner-limits:
    allow-unlisted: false
    spawners:
      cow: 10

allow-unlisted: define se spawners que não estão listados podem ser colocados.
spawners: lista de limites por ID interno do spawner, como cow, zombie ou o ID configurado nos arquivos da pasta spawners/.

Quando o limite é atingido, a mensagem plot-spawner-limit pode usar {spawner}, {current} e {limit}.

radius

Raio de verificação para evitar spawners muito próximos.

radius: 5

Impede colocar spawners se houver outro spawner ou mobs num raio de 5 blocos. Útil para evitar lag por concentração excessiva.

hit-delay

Delay entre cada ataque aos mobs do spawner (em milissegundos).

hit-delay: 500

0 - Sem delay (pode causar lag)
500 - Meio segundo entre ataques (recomendado)
1000 - 1 segundo entre ataques (para servidores com muitos spawners)

Aumente este valor se estiver tendo problemas de TPS quando muitos jogadores estão farmando spawners.

world-blacklist

Lista de mundos onde spawners não podem ser colocados.

world-blacklist: [ 'none' ]

Exemplo de uso:

world-blacklist: [ 'world_pvp', 'minigames', 'lobby' ]

friend-max

Limite máximo de amigos que um spawner pode ter.

friend-max: 0

0 - Ilimitado
5 - Máximo 5 amigos por spawner
10 - Máximo 10 amigos por spawner

accumulate-bonus

Define se os bônus de venda são acumulados.

accumulate-bonus: true

Exemplo:

Jogador tem permissões: yspawnersv2.bonus.vip (20%) e yspawnersv2.bonus.mvp (30%)
true - Receberá 50% de bônus (20% + 30%)
false - Receberá apenas o bônus de maior prioridade

bolsa

Ativa integração com plugins de bolsa de valores.

bolsa: true

Compatível com: yBolsa, StormEconomy, HeroBolsa

Quando ativo, o valor de venda dos drops é multiplicado pela cotação da bolsa.

nbttag-blacklist

Lista de NBT tags de itens que não podem bater em mobs dos spawners.

nbttag-blacklist: [ 'yMinas-Pickaxe', 'yPlantacoes-Enxada', 'yCampo-Tool-Type' ]

Útil para prevenir que ferramentas de outros plugins (minas, plantações) sejam usadas nos spawners.

natural-enabled

Habilita spawn de mobs em spawners naturais do Minecraft.

natural-enabled: false

true - Spawners naturais de cavernas também usarão o sistema do plugin
false - Apenas spawners colocados pelos jogadores

Ativar esta opção pode causar conflitos com outros plugins de spawners e aumentar significativamente o uso de recursos.

status-change

Permite jogadores ligarem/desligarem seus spawners.

status-change: true

Útil para economia de recursos quando o jogador não está farmando.

just-one

Permite apenas 1 stack de cada tipo de spawner por jogador.

just-one: false

true - Jogador só pode ter 1 spawner de vaca, 1 de porco, etc.
false - Sem limite de tipos

Ativa menu individual para cada tipo de drop.

sell-collect-menu: false

true - Abre menu separado ao clicar em um drop
false - Vende/coleta direto do menu de drops

auto-sell-permission

Define a permissão necessária para que jogadores possam usar a função de auto-venda de drops do spawner. Esta opção permite controlar quais jogadores têm acesso ao auto-sell.

auto-sell-permission: ''

Como funciona:

Se vazio ('') - Todos os jogadores têm acesso ao auto-sell
Se com valor (ex: 'yspawners.autosell.vip') - Apenas jogadores com esta permissão usam auto-sell

Exemplos de uso:

# Liberar auto-sell apenas para VIPs
auto-sell-permission: 'yspawners.autosell.vip'

Com esta configuração:

Apenas jogadores com a permissão yspawners.autosell.vip podem usar auto-sell
Outros jogadores precisam coletar manualmente ou vender através do menu

# Liberar auto-sell apenas para MVPs
auto-sell-permission: 'yspawners.autosell.mvp'

Dicas de uso:

# Liberar para todos (auto-sell para qualquer jogador)
auto-sell-permission: ''

# Liberar apenas para membros premium
auto-sell-permission: 'yspawners.autosell'

# Diferentes níveis de auto-sell
# Você pode criar sistemas em camadas:
# - auto-sell-permission: 'yspawners.autosell' (padrão)
# - Combinar com bônus de venda por permissão

Esta permissão funciona independentemente dos bônus de venda. Um jogador pode ter bônus mas não ter acesso ao auto-sell, e vice-versa.

auto-sell-default

Define se o auto-sell virá ativado por padrão ao criar um novo spawner.

auto-sell-default: true

Como funciona:

Se true - Novos spawners nascem com auto-sell já ativado
Se false - Novos spawners nascem com auto-sell desativado, devendo ser ativado manualmente

Explicação:

Esta configuração controla o estado padrão do sistema de auto-venda para spawners recém-criados. Não afeta spawners já existentes que têm suas próprias configurações salvas.

Exemplos de uso:

# Auto-sell ativado por padrão
auto-sell-default: true

Com esta configuração:

Todos os novos spawners vendem automaticamente os drops
Jogadores podem desativar manualmente se desejarem

# Auto-sell desativado por padrão
auto-sell-default: false

Com esta configuração:

Novos spawners não vendem automaticamente
Jogadores devem ativar manualmente no menu do spawner

disable-vanilla-looting

Desativa a contabilização do encantamento Looting padrão do Minecraft nos drops dos spawners.

disable-vanilla-looting: false

Use true quando quiser que apenas os multiplicadores e bônus do plugin influenciem os drops.

max-stacked-mobs-per-chunk

Limite de entidades stackadas vivas por chunk. Use 0 para sem limite. Valores como 32–64 ajudam se houver flood/crash.

# Limite de entidades stackadas vivas por chunk (0 = sem limite). Use 32-64 se houver flood/crash.
max-stacked-mobs-per-chunk: 0

Quando o sistema de stack-spawners está desativado (ou limitado a 1x), permite que spawners do mesmo tipo próximos compartilhem o mob já existente ao invés de cada um criar seu próprio.

share-mob-between-spawners: false

Como funciona:

Se true - Múltiplos spawners do mesmo tipo próximos compartilham um único mob e acumulam o stack nele
Se false - Cada spawner cria e gerencia seu próprio mob independentemente

Quando usar:

Esta opção é recomendada quando:

stack-spawners.max: 1 ou stack-spawners desativado
Você quer evitar múltiplos mobs da mesma entidade em um pequeno espaço
Deseja economizar recursos do servidor

Exemplo de uso:

# Configuração para compartilhamento de mobs
share-mob-between-spawners: true
# Com stack-spawners limitado a 1x
stack-spawners:
  max: 1

Com esta configuração:

Se você colocar 3 spawners de Zombie próximos, apenas 1 Zombie spawna
O stack deste Zombie acumula quando os 3 spawners tentam gerar

Use este sistema para economizar recursos em servidores com muitos spawners em pequenas áreas, como em lobbies ou farms compartilhadas.

sword-detect

Sistema para detectar e validar matadoras (espadas de farm).

sword-detect:
  enabled: false
  whitelist-nbt: ['yEspadasFarm-Sword']

Como funciona:

Quando enabled: true, apenas itens com as NBT tags listadas podem matar mobs dos spawners.

Exemplo de uso:

sword-detect:
  enabled: true
  whitelist-nbt: ['yEspadasFarm-Sword', 'CustomSword', 'FarmWeapon']

Útil em servidores que vendem matadoras especiais e querem que apenas elas funcionem nos spawners.

limit-stack

Configuração do item que aumenta o limite de stack de spawners.

limit-stack:
  material: '667da379f51d85d74fdba39a164d3f5062ef2ffc0b3e04d339376773931a4e'
  name: '&bLimite de stack'
  lore:
    - ''
    - '&fQuantia: &a{amount}'
    - ''
    - '&7Clique com botão direito no spawner para ativar.'
    - ''
    - '&7Clique com shift + botão direito para compactar'
    - '&7todos os seus limites no inventário em 1 só.'
    - ''

Este é um item consumível que jogadores usam para aumentar o limite de spawners stackados.

Placeholders disponíveis:

{amount} - Quantidade de limite no item

Como dar o item:

/spawneradmin givelimitstack <player> <quantia>

limit-mobs

Configuração do item que aumenta o limite de stack de mobs.

limit-mobs:
  material: '667da379f51d85d74fdba39a164d3f5062ef2ffc0b3e04d339376773931a4e'
  name: '&bLimite de mobs'
  lore:
    - ''
    - '&fQuantia: &a{amount}'
    - ''
    - '&7Clique com botão direito no spawner para ativar.'
    - ''
    - '&7Clique com shift + botão direito para compactar'
    - '&7todos os seus limites no inventário em 1 só.'
    - ''

Similar ao limite de stack, mas para a quantidade de mobs que podem ser stackados por spawner.

Como dar o item:

/spawneradmin givelimitstack <player> <quantia>

limit-drop

Sistema de limite de venda de drops. Jogadores precisam de "limite" para vender drops dos spawners.

limit-drop:
  # Ativar o sistema
  enabled: false
  # Padrão que o jogador irá receber
  default: 64
  # Deixe 0 para ser infinito
  max: 0
  # Item do limite
  item:
    material: '667da379f51d85d74fdba39a164d3f5062ef2ffc0b3e04d339376773931a4e'
    name: '&bLimite de Drops'
    lore:
      - ''
      - '&fQuantia: &a{amount}'
      - ''
      - '&7Clique com botão direito para ativar.'
      - ''
      - '&7Clique com shift + botão direito para compactar'
      - '&7todos os seus limites no inventário em 1 só.'
      - ''

Como funciona o sistema:

Jogadores começam com o limite padrão (ex: 64)
Cada vez que vendem drops, o limite diminui
Podem comprar/ganhar mais limite através de itens ou comandos
Se o limite chegar a 0, não podem mais vender até ganharem mais

Configuração recomendada para economia balanceada:

limit-drop:
  enabled: true
  default: 1000  # Começa com limite de 1000
  max: 10000     # Máximo de 10000 de limite

Comandos relacionados:

/limitdrop                    # Ver seu limite
/limitdrop enviar <player>    # Enviar limite para outro jogador
/spawneradmin givelimitdrop   # Dar limite (admin)

Use este sistema para criar uma economia onde jogadores precisam comprar "limite de venda" na loja do servidor, gerando receita e controlando a inflação.

Exemplo de uso em servidor pay-to-win:

Jogadores VIP ganham mais limite padrão
Venda itens de limite na loja
Crie eventos que dão limite como recompensa
Limite máximo maior para ranks superiores

Nesta página