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

menus.yml

discord.yml

messages.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla o comportamento geral do ponto: banco de dados, permissão de staff, limites de sessões, formatos de data/hora, status exibidos e sons.

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.

# Modo de depuração para correção de problemas no plugin.
debug-mode: false

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados de ponto 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.

redis

Configurações do servidor Redis para sincronização 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: 3306]
  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 em tempo real de dados de ponto entre servidores

Delay (em ticks) para carregar os dados depois do login do jogador.

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

20 ticks = 1 segundo
Útil em redes com servidor de mina separado, para evitar carregar dados antes do jogador estar pronto

general

Configurações gerais do sistema de ponto.

general:
  # Permissão que identifica membros da equipe a serem rastreados
  staff-permission: 'ybaterponto.staff'
  # Máximo de sessões guardadas por membro (as mais antigas são removidas)
  max-sessions-per-player: 50
  # Formato de data exibido nas mensagens
  date-format: 'dd/MM/yyyy'
  # Formato de horário exibido nas mensagens
  time-format: 'HH:mm:ss'
  # Intervalo do tick de tempo online (em ticks). 20 = 1 segundo
  tick-interval: 20

Opções:

Opção	Descrição
`staff-permission`	Permissão que identifica quem é staff rastreado pelo ponto.
`max-sessions-per-player`	Máximo de sessões salvas por membro. As mais antigas são removidas.
`date-format`	Formato de data exibido nas mensagens (padrão Java).
`time-format`	Formato de horário exibido nas mensagens (padrão Java).
`tick-interval`	Intervalo do tick de tempo online em ticks (`20` = 1 segundo).

Exemplos de formato:

date-format: 'dd/MM/yyyy'   # 21/07/2026
time-format: 'HH:mm:ss'     # 14:30:05

status

Textos de status exibidos em mensagens e menus.

status:
  online: '&aOnline'
  offline: '&cOffline'
  in-session: '&aEm expediente'
  out-session: '&7Fora do expediente'

Opção	Quando é usado
`online`	Staff online no servidor
`offline`	Staff offline no servidor
`in-session`	Staff em expediente (ponto aberto)
`out-session`	Staff fora do expediente (ponto fechado)

sounds

Sons reproduzidos em ações do ponto.

sounds:
  session-start: ENTITY_EXPERIENCE_ORB_PICKUP
  session-end: ENTITY_ITEM_BREAK
  action-fail: ENTITY_VILLAGER_NO

Opção	Quando é reproduzido
`session-start`	Ao registrar entrada no expediente
`session-end`	Ao registrar saída do expediente
`action-fail`	Quando uma ação falha

Use nomes de sons válidos da versão do Minecraft do seu servidor.

Nesta página