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.

2023_fev.yml

commands.yml

config.yml

menus.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o centro de controle do plugin, onde você define o comportamento geral do sistema de recompensas diárias. 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 das recompensas coletadas 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/yPassRewards/data.db.

Define o tempo de espera (em ticks) antes de carregar os dados do jogador após o login. Útil para servidores em rede BungeeCord/Velocity onde os dados precisam sincronizar 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

Conversão de ticks para segundos:

20 ticks = 1 segundo
40 ticks = 2 segundos
60 ticks = 3 segundos

Para servidores standalone (sem rede), mantenha em 20 ticks. Para redes BungeeCord/Velocity, considere aumentar para 40-60 ticks se houver problemas de sincronização.

Define se o calendário de recompensas será aberto automaticamente quando o jogador entrar no servidor.

# Forçar abrir o calendário ao logar
force-login: true

Comportamento:

true - O menu de recompensas abre automaticamente no login (recomendado para aumentar engajamento)
false - O jogador precisa usar /diaria manualmente para abrir o menu

Com esta opção ativada, o calendário será exibido em todo login. Pode ser intrusivo em alguns casos, mas aumenta significativamente a taxa de coleta de recompensas.

Exemplo de uso:

# Configuração recomendada para máximo engajamento
force-login: true
login-delay: 20

Nesta configuração, o calendário abrirá automaticamente 1 segundo após o jogador entrar, dando tempo para carregar os dados.

Estrutura de arquivos

Configuração do plugin (config.yml)

debug-mode

database

login-delay

force-login

Nesta página