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 funcionamento do CoinFlip. 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 do CoinFlip (estatísticas dos jogadores) serão armazenados. O plugin suporta três tipos de armazenamento:

• SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos ou testes.
• 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 e estabilidade.

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: ''

redis

Configurações do servidor Redis para sincronização em redes multi-servidor (BungeeCord/Velocity).

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 6379]
  port: 6379
  # Usuário de conexão. [EX: root]
  username: ''
  # Senha do usuário de conexão: [EX: 123]
  password: ''

Quando usar Redis:

• Rede BungeeCord/Velocity com múltiplos servidores
• Sincronização de salas e estatísticas em tempo real entre servidores
• Jogadores de servidores diferentes disputando entre si

general

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

general:
  # Máximo de salas abertas por jogador
  max-rooms-per-player: 3
  # Tempo em segundos para uma sala expirar automaticamente
  room-expire-seconds: 300
  # Duração da animação em ticks (20 ticks = 1 segundo)
  animation-duration-ticks: 100
  # Quantidade de frames da animação
  animation-frames: 10
  # Valor mínimo de aposta
  min-amount: 100
  # Valor máximo de aposta
  max-amount: 1000000
  # Intervalo em ticks para atualizar o menu de salas
  menu-update-interval-ticks: 20

Destaques importantes:

• max-rooms-per-player: Evita que um jogador monopolize o menu com muitas salas abertas ao mesmo tempo.
• room-expire-seconds: Salas não aceitas são removidas automaticamente após este tempo. 300 = 5 minutos.
• animation-duration-ticks: Controla por quanto tempo a animação de cara ou coroa é exibida. 100 ticks = 5 segundos.
• min-amount / max-amount: Defina limites para evitar apostas irrelevantes ou excessivamente altas.
• menu-update-interval-ticks: Define com que frequência o menu de salas é atualizado. 20 ticks = 1 vez por segundo.

sounds

Configurações dos sons reproduzidos em cada evento do CoinFlip. Use nomes de sons válidos do Minecraft.

sounds:
  # Som ao criar uma sala
  room-created: 'ENTITY_EXPERIENCE_ORB_PICKUP'
  # Som ao aceitar uma sala
  room-accepted: 'ENTITY_EXPERIENCE_ORB_PICKUP'
  # Som de vitória
  win: 'ENTITY_PLAYER_LEVELUP'
  # Som de derrota
  lose: 'ENTITY_VILLAGER_NO'
  # Som de cada tick da animação
  animation-tick: 'UI_BUTTON_CLICK'
  # Som ao fim da animação
  animation-end: 'ENTITY_PLAYER_LEVELUP'