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 é o coração do plugin, onde você controla todos os aspectos do sistema de apostas do Jogo do Bicho. 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 apostas 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 antes de carregar os dados do jogador após o login. Essencial para servidores com BungeeCord/Velocity onde a mina está em servidor separado.

# Delay em ticks (20 ticks = 1 segundo)
# Recomendado: 20 ticks (1 segundo)
login-delay: 20

Por que é necessário:

• Em redes com múltiplos servidores, os dados podem não estar sincronizados imediatamente
• O delay garante que o plugin carregue informações corretas do banco de dados
• Valores muito baixos podem causar perda de dados ou apostas inválidas

general

Configurações gerais que controlam o comportamento do sistema de apostas.

general:
  # Números que cada bicho possuirá
  numbers-total: 4
  # Mínimo por aposta
  bet-minimum: 100.0
  # Multiplicador da aposta simples
  simple-multiplier: 4.0
  # Multiplicador da aposta em dezenas
  dozens-multiplier: 6.0
  # Multiplicador da aposta em centenas
  hundreds-multiplier: 11.0
  # Multiplicador da aposta em milhar
  thousands-multiplier: 50.0
  # Delay para apostar novamente em segundos
  delay: 5

Explicação dos parâmetros:

numbers-total

Quantidade de números que cada bicho representa. Com valor 4, o sistema funciona assim:

• Bicho 1 (Avestruz) → 01, 02, 03, 04
• Bicho 2 (Águia) → 05, 06, 07, 08
• Bicho 3 (Burro) → 09, 10, 11, 12
• E assim por diante...

bet-minimum

Valor mínimo que um jogador pode apostar. Define a barreira de entrada:

• Valores baixos (10-100) → mais jogadores participam
• Valores altos (500-1000) → apostas mais significativas, menos spam

Multiplicadores

Os multiplicadores definem quanto o jogador ganha ao acertar. Cada tipo de aposta tem dificuldade diferente:

Aposta Simples (simple-multiplier: 4.0)

• Cobre 4 números do bicho escolhido
• Exemplo: Aposta R$ 100 no Avestruz → ganha R$ 400 se sair qualquer número do Avestruz
• Chance: 4 em 100 (4%)

Dezenas (dozens-multiplier: 6.0)

• Acerta as duas últimas cifras
• Exemplo: Escolhe 45, número sorteado 2345 → ganha!
• Chance: 1 em 100 (1%)

Centenas (hundreds-multiplier: 11.0)

• Acerta as três primeiras cifras
• Exemplo: Escolhe 234, número sorteado 2345 → ganha!
• Chance: 1 em 1000 (0.1%)

Milhar (thousands-multiplier: 50.0)

• Acerta o número exato de 0001 a 9999
• Exemplo: Escolhe 2345, número sorteado 2345 → ganha!
• Chance: 1 em 10000 (0.01%)

Exemplo de cálculo:

Jogador aposta R$ 1.000 no Milhar (número 7777)
Se acertar → recebe R$ 50.000 (1.000 × 50)
Se errar → perde R$ 1.000

delay

Tempo em segundos que o jogador deve esperar entre apostas. Previne:

• Spam de apostas
• Exploits tentando múltiplas apostas simultâneas
• Sobrecarga do servidor

Valores recomendados:

• 5 segundos: Balanceado para maioria dos servidores
• 10 segundos: Servidores com economia mais séria
• 2 segundos: Servidores casuais com alto ritmo

announces

Sistema de anúncios públicos quando jogadores ganham apostas de alto valor. Cria engajamento e mostra que o sistema realmente paga prêmios.

announces:
  dozens:
    chat: |

      &eO jogador &f{player}&e acertou a DEZENA no &fJOGO DO BICHO&e!
      &eAposta: &f{amount}
      &eRecebeu: &f{total} (&lx{odd}&f)

    actionbar: ''
    title: ''
  hundreds:
    chat: |

      &eO jogador &f{player}&e acertou a CENTENA no &fJOGO DO BICHO&e!
      &eAposta: &f{amount}
      &eRecebeu: &f{total} (&lx{odd}&f)

    actionbar: ''
    title: ''
  thousands:
    chat: |

      &eO jogador &f{player}&e acertou o MILHAR no &fJOGO DO BICHO&e!
      &eAposta: &f{amount}
      &eRecebeu: &f{total} (&lx{odd}&f)

    actionbar: ''
    title: ''

Tipos de anúncio:

• chat: Mensagem enviada no chat para todos os jogadores
• actionbar: Texto exibido acima da hotbar
• title: Título grande no centro da tela

Placeholders disponíveis:

• {player} - Nome do jogador que ganhou
• {amount} - Valor apostado
• {total} - Valor total ganho
• {odd} - Multiplicador aplicado

Por que não há anúncio para Aposta Simples?

• Apostas simples são mais comuns (chance de 4%)
• Anunciar todas causaria spam no chat
• Apenas apostas difíceis (Dezenas, Centenas, Milhar) são anunciadas

Exemplo de configuração personalizada:

announces:
  thousands:
    chat: |

      &6&l⚡ GRANDE PRÊMIO! ⚡
      &e{player} &facertou o &c&lMILHAR &fcom apenas &e1 em 10.000 &fde chance!
      &fGanhou incríveis &a{total} &f(aposta: &7{amount}&f)

    title: '&6&lJACKPOT!'
    actionbar: '&e{player} ganhou {total} no Jogo do Bicho!'