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.

Estrutura de arquivos

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

Configuração do plugin (config.yml)

O arquivo config.yml controla o funcionamento das máquinas virtuais. 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

database

Define como e onde os dados das máquinas 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: ''

login-delay

Tempo de espera em ticks antes de carregar os dados do jogador após o login. Essencial para redes BungeeCord onde jogadores são transferidos entre servidores.

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

Valores recomendados:

• Servidor standalone: 0 (sem delay)
• Rede BungeeCord: 20 (1 segundo)
• Conexões lentas: 40 (2 segundos)

limit

Limita quantos itens podem ser coletados por vez. Protege contra lag ao processar grandes quantidades.

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

Exemplo:

• Máquina acumulou 5.000 tokens
• Limite: 1.000
• Jogador coleta: recebe 1.000, restam 4.000
• Precisa coletar mais 4 vezes

general

Configurações gerais do comportamento das máquinas.

general:
  # Limite máximo de amigos que uma máquina 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: ''
  # Quantia máxima que pode ter de multiplicador
  multiplier-max: 10
  # Ativar a compra usando o limite disponível com o botão "Q"
  # Isto só funciona se o limite estiver ativado
  buy-q: true
  # Delay da compra com Q
  # em segundos
  buy-q-delay: 10
  # Ativar a compra via chat
  # caso desativado, comprará apenas 1 unidade (sem contar o multiplicador)
  buy-chat: true
  # Gastar limite ao comprar
  spend-limit: false
  # Delay da coleta
  # em segundos
  collect-delay: 10

Explicação dos parâmetros:

• friend-max: Quantos jogadores podem gerenciar a mesma máquina. Use 0 para ilimitado.
• accumulate-bonus: Se true, soma todos os bônus com permissão. Se false, usa apenas o maior.
• bolsa: Integração com plugins de bolsa de valores para preços dinâmicos.
• formatter-bonus-has: Formato exibido quando há bônus ativo. Placeholders: {bonus} e {display}.
• multiplier-max: Limite do multiplicador de compra na loja (ex: comprar 5x de uma vez).
• buy-q: Permite usar tecla Q para comprar usando todo o limite disponível automaticamente.
• buy-q-delay: Cooldown em segundos entre compras com Q.
• buy-chat: Permite especificar quantidade ao comprar por comando.
• spend-limit: Se true, comprar consome limite além de dinheiro.
• collect-delay: Cooldown em segundos entre coletas.

Exemplo de bônus acumulado:

• Jogador com permissões maquinas.bonus.vip (10%) e maquinas.bonus.elite (15%)
• Com accumulate-bonus: true → bônus total: 25%
• Com accumulate-bonus: false → bônus total: 15% (maior)

limit-shop

Controla quantas máquinas um jogador pode comprar usando um sistema de "moeda" secundária.

limit-shop:
  # Ativar o limite
  enabled: true
  # Quantia de limite que o jogador ganhar ao se registrar.
  default: 1
  # Máximo de limite que o jogador pode ter.
  # Deixe 0 para ser infinito.
  max: 100
  # Item do limite que será ativável
  item:
    material: '667da379f51d85d74fdba39a164d3f5062ef2ffc0b3e04d339376773931a4e'
    name: '&bLimite de compra'
    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:

• Jogadores começam com default de limite
• Para comprar máquinas, precisam ter limite disponível
• Limite adicional vem de itens ativáveis
• Shift + clique direito compacta múltiplos itens de limite em um só

Estratégias de balanceamento:

• default: 1, max: 100 → Progressão lenta, limite valioso
• default: 10, max: 0 → Liberdade total, foco em dinheiro
• default: 5, max: 50 → Equilíbrio entre os dois

slots

Define quantas máquinas um jogador pode ter ativas simultaneamente.

slots:
  # Quantia padrão de slots que o jogador irá ter
  default: 1
  # Quantia máxima de slots que o jogador poderá ter
  max: 20
  # Item do slot que será ativável
  item:
    material: 'HOPPER'
    name: '&bSlots'
    lore:
      - ''
      - '&fQuantia: &a{amount}'
      - ''
      - '&7Clique com botão direito para ativar.'

Como funciona:

Slots são espaços para máquinas ativas. Sem slots disponíveis, o jogador não pode colocar novas máquinas mesmo tendo comprado.

Estratégias de balanceamento:

• default: 1, max: 5 → Progressão premium, slots vendidos na loja
• default: 10, max: 50 → Progressão livre, sem pay-to-win
• default: 3, max: 20 → Equilíbrio entre os dois