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.

commands.yml

config.yml

daily_rewards.yml

data.yml

menus.yml

messages.yml

rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento das 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 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/yRecompensasDiarias/data.db.

redis

Configurações do servidor Redis para sincronização de dados entre múltiplos servidores. Necessário apenas em redes BungeeCord/Velocity para manter os dados sincronizados em tempo real.

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

Redis é essencial se você tem múltiplos servidores de mineração conectados via BungeeCord/Velocity.

Define o atraso em ticks para carregar os dados do jogador após o login. Essencial para evitar problemas em redes BungeeCord/Velocity onde o jogador pode ser transferido 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

Quando ajustar:

Servidor único: 10-20 ticks (0.5-1 segundo)
Rede BungeeCord: 20-40 ticks (1-2 segundos)
Rede com alta latência: 40-60 ticks (2-3 segundos)

limit

Sistema de segurança para limitar a quantidade de recompensas coletadas de uma vez. Previne sobrecarga do servidor e possíveis crashes.

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

Desativar ou aumentar muito este limite pode gerar lag severo e até crashar o servidor. Mantenha ativado com valores seguros.

Valores recomendados por porte do servidor:

Servidor pequeno (20-50 jogadores): max: 500
Servidor médio (50-150 jogadores): max: 1000
Servidor grande (150+ jogadores): max: 2000

Define o comportamento do menu após o jogador coletar uma recompensa.

# Fechar o menu ao coletar a recompensa
close-menu-collect: false

false - Menu permanece aberto (jogador pode coletar múltiplas recompensas)
true - Menu fecha automaticamente após coletar

npc

Configurações do NPC entregador que os jogadores podem interagir para abrir o menu de recompensas. Requer Citizens instalado.

npc:
  # Skin do NPC (nome do jogador ou ID da skin)
  skin: 'deliveryman'
  hologram:
    # Offset de altura do holograma acima do NPC
    offset: 3.4
    # Linhas do holograma
    hologram:
      - '&6&lRecompensas Diárias'
      - '&7Clique para coletar as entregas.'
      - '[item]DIAMOND'

Configuração da skin:

Use um nome de jogador: skin: 'Notch'
Use uma URL de textura: skin: 'http://textures.minecraft.net/texture/...'
Use um nome personalizado: skin: 'deliveryman'

Configuração do holograma:

offset: Altura em blocos acima do NPC (recomendado: 2.0 a 3.5)
hologram: Lista de linhas do holograma

Use [item]MATERIAL para exibir itens 3D no holograma. Exemplos: [item]DIAMOND, [item]GOLD_INGOT, [item]CHEST

Exemplo de holograma personalizado:

npc:
  skin: 'Steve'
  hologram:
    offset: 2.8
    hologram:
      - '&e&l⭐ ENTREGADOR ⭐'
      - '&7Recompensas diárias disponíveis!'
      - ''
      - '[item]CHEST'
      - ''
      - '&aClique para abrir'

lore

Sistema de lores adicionais que podem ser inseridas nos itens de recompensa.

lore:
  # Lore de chance exibida nos itens
  chance: ['', '&6Chance: &f{chance}%', '']

Placeholder disponível:

{chance} - Percentual de chance de receber o item (0-100)

Exemplo de uso:

Quando configurado, itens com chance inferior a 100% exibirão automaticamente a lore de chance no preview.

format

Define o formato de exibição de números grandes no plugin (dinheiro, quantidades, etc).

# Tipos disponíveis:
# yPlugins -> Usa a formatação do yPlugins
# LETRA -> Força usar a formatação em letra
# NUMERO -> Força usar a formatação em número
format: 'yPlugins'

Exemplos de formatação:

Valor	yPlugins	LETRA	NUMERO
1000	1k	1mil	1,000
1000000	1M	1milhão	1,000,000
1000000000	1B	1bilhão	1,000,000,000

A opção yPlugins detecta automaticamente o formato configurado em outros plugins yStore no servidor, mantendo consistência visual.

Nesta página