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.

member.yml

bonus.yml

commands.yml

config.yml

economies.yml

menus.yml

messages.yml

rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla o comportamento central do plugin, incluindo banco de dados, sistema de bônus e recompensas. 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 do plugin 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/yAutoVender/data.db.

limit

Sistema de limite para recolhimento de recompensas. Controla quantas recompensas podem ser coletadas por vez para evitar sobrecarga do servidor.

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

Como funciona:

Quando um jogador coleta recompensas acumuladas, o sistema processa no máximo a quantidade definida em max por operação. Se houver mais recompensas, o jogador precisará coletar novamente.

Desativar ou aumentar muito o limite pode gerar lag ao processar muitas recompensas simultaneamente e, em casos extremos, crashar o servidor.

general

Configurações gerais que controlam o comportamento do sistema de venda automática e recompensas.

general:
  # Acumular os bônus que tiver permissão
  accumulate-bonus: false
  # Som de item quebrado
  break-sound: 'ITEM_BREAK'
  # Mundos que não poderão coletar recompensas
  world-reward-collect-blacklist: [ 'none' ]
  # Dar as recompensas diretamente para o jogador (sem enviar para o menu)
  reward-give-inventory: false

Explicação dos parâmetros:

accumulate-bonus

Define como múltiplos bônus de permissão são processados.

false: Apenas o maior bônus é aplicado (recomendado para progressão linear)
true: Todos os bônus são somados (pode criar valores muito altos)

Exemplo de funcionamento:

Imagine um jogador com as seguintes permissões de bônus:

VIP: 10% de bônus
Premium: 25% de bônus
Booster: 15% de bônus

Com accumulate-bonus: false, o jogador recebe apenas 25% (o maior). Com accumulate-bonus: true, o jogador recebe 50% (10% + 25% + 15%).

Use false para manter a economia balanceada. Use true apenas se quiser recompensar jogadores com múltiplas permissões premium.

break-sound

Define o som reproduzido quando um bloco é quebrado e vendido automaticamente.

Padrão: ITEM_BREAK
Outros exemplos: ENTITY_EXPERIENCE_ORB_PICKUP, BLOCK_NOTE_BLOCK_PLING, UI_TOAST_CHALLENGE_COMPLETE

Use nomes de sons válidos do Minecraft. Para desabilitar o som, use 'NONE' ou ''.

world-reward-collect-blacklist

Lista de mundos onde jogadores não podem coletar recompensas acumuladas. Útil para prevenir abusos em mundos específicos como lobbies ou arenas.

Exemplo:

general:
  world-reward-collect-blacklist:
    - 'world_pvp'
    - 'lobby'
    - 'eventos'

Use ['none'] ou [] para permitir coleta em todos os mundos.

reward-give-inventory

Controla o fluxo de entrega de recompensas:

false (padrão): Recompensas vão para um menu interno e devem ser coletadas manualmente pelo jogador
true: Recompensas vão direto para o inventário do jogador

Vantagens de cada modo:

Modo	Vantagens
Menu (false)	• Não ocupa espaço do inventário • Jogador controla quando receber • Previne perda de itens por inventário cheio
Direto (true)	• Mais conveniente • Feedback imediato • Menos cliques necessários

Se usar true, certifique-se de que os jogadores têm espaço no inventário, ou os itens podem ser perdidos dependendo da configuração do servidor.

Nesta página