Comandos

O QuestsTracker oferece comandos de jogador para o menu e o acompanhamento, e comandos de administrador para gerenciamento, diagnóstico e manutenção.

Comandos de jogador

/quests

Abre o menu de quests.

/quests

Alias: /quetes, /quete, /quest, /q

Exibe o menu GUI com as categorias de quests. O jogador pode navegar entre as categorias, ver o status das suas quests e acompanhar/parar de acompanhar quests.

/quests [jogador]

Abre o menu de quests de outro jogador.

/quests NomeDoJogador

Permissão necessária: kginfoservs_quetes.admin

O título do menu exibe "Quests - NomeDoJogador".

/quests track

Começa a acompanhar uma quest no scoreboard.

/quests track <quest_id>

O jogador pode acompanhar até 3 quests simultâneas. As quests acompanhadas são exibidas no scoreboard no jogo com seus objetivos em tempo real.

Limite de acompanhamento

Se o jogador já está acompanhando 3 quests, ele deve remover uma antes de adicionar uma nova.

---

Comandos de administrador

/kgquests

Comando principal de administração.

/kgquests <subcomando>

Alias: /kgquetes, /kgq

Permissão necessária: kginfoservs_quetes.admin

---

/kgquests purgepackage

Exclui todos os dados de jogador para um pacote de quests. Suporta patterns com wildcard (%).

/kgquests purgepackage <pattern> [confirm|--force]

Exemplos:

# Limpar um pacote específico
/kgquests purgepackage MeuPacote

# Limpar todos os pacotes que começam com "Daily-" (wildcard)
/kgquests purgepackage Daily-%

# Limpar sem confirmação (forçar)
/kgquests purgepackage MeuPacote --force

Processo:

1. O comando exibe uma prévia dos dados que serão excluídos
2. Execute novamente com confirm para validar
3. Ou use --force para pular a confirmação

Dados excluídos:

• Progresso das quests (player_quest_progress)
• Quests acompanhadas (player_tracked_quest)
• Tags e pontos BetonQuest associados
• Cache local e Redis de todos os jogadores online

Ação irreversível

Este comando exclui permanentemente os dados. Faça backup do seu banco de dados antes de executar este comando.

Quests diárias

O pattern wildcard é útil para quests recorrentes:

/kgquests purgepackage Daily-%

---

/kgquests refresh

Força o recarregamento dos dados de um jogador a partir do banco de dados.

/kgquests refresh <jogador>

Invalida o cache local e Redis para este jogador, recarrega os dados a partir do BDD e atualiza o scoreboard. Útil se os dados em cache não correspondem à realidade.

---

/kgquests scoreboard

Controla o scoreboard de quests.

/kgquests scoreboard <on|off|toggle>

Opção	Efeito
on	Ativa o scoreboard
off	Desativa o scoreboard
toggle	Alterna o estado atual

Scoreboard global

Se o scoreboard estiver desativado globalmente (scoreboard.enabled: false no config.yml), este comando não tem efeito.

---

/kgquests stats

Exibe as estatísticas de desempenho do cache.

/kgquests stats

Informações exibidas:

• Taxa de acerto por cache (QuestStatus, QuestProgress, QuestTracked, PlaceholderAPI)
• Número de acertos/erros e carregamentos
• Análise da taxa de acerto (excelente: acima de 95%, bom: acima de 85%, a verificar: abaixo de 85%)

---

/kgquests redis

Exibe os diagnósticos Redis.

/kgquests redis [jogador]

Sem argumento — Visão global:

• Número de chaves quest:progress:*, quest:tracked:*, quest:status:*
• Total de chaves em cache

Com jogador — Visão específica:

• Existência e TTL da chave de progresso
• Existência e TTL da chave de tracking
• Número de chaves de status
• Alerta se chaves estiverem ausentes

---

/kgquests health

Verificação de saúde completa do sistema.

/kgquests health

Verifica todos os componentes:

• Banco de dados (conexão + latência)
• Redis (disponibilidade + latência)
• BetonQuest (carga)
• PlaceholderAPI (ativo)
• Virtual Threads (quantidade)
• Memória JVM
• Veredito global de saúde

---

/kgquests memory

Relatório detalhado de uso de memória.

/kgquests memory

Informações exibidas:

• Número de entradas por cache e estimativa em KB
• Menus GUI abertos
• Memória JVM (total, utilizada, máxima)
• Recomendações de otimização

---

/kgquests update

Verifica e baixa as atualizações do plugin.

/kgquests update

Verifica se uma nova versão está disponível e a baixa se for o caso. O JAR é colocado em plugins/update/ e será aplicado na próxima reinicialização.

---

/questsreload

Recarrega a configuração do plugin.

/questsreload

Alias: /quetesreload

Permissão necessária: kginfoservs_quetes.reload

Recarrega:

• config.yml (categorias, traduções, scoreboard, etc.)
• quests_config.yml (textos e etapas das quests)

---

Resumo dos comandos

Comando	Descrição	Permissão
/quests	Abre o menu de quests	Nenhuma
/quests [jogador]	Abre o menu de outro jogador	kginfoservs_quetes.admin
/quests track <id>	Acompanhar uma quest	Nenhuma
/kgquests purgepackage <pattern>	Limpar os dados de um pacote	kginfoservs_quetes.admin
/kgquests refresh <jogador>	Recarregar os dados de um jogador	kginfoservs_quetes.admin
/kgquests scoreboard	Controle do scoreboard (on/off/toggle)	kginfoservs_quetes.admin
/kgquests stats	Estatísticas do cache	kginfoservs_quetes.admin
/kgquests redis [jogador]	Diagnósticos Redis	kginfoservs_quetes.admin
/kgquests health	Saúde do sistema	kginfoservs_quetes.admin
/kgquests memory	Relatório de memória	kginfoservs_quetes.admin
/kgquests update	Verificar atualizações	kginfoservs_quetes.admin
/questsreload	Recarregar a configuração	kginfoservs_quetes.reload

Autocompletar com Tab

O autocompletar por Tab está disponível para todos os subcomandos de /kgquests, incluindo nomes de jogadores e pacotes de quests.