Comandos

O QuestsTracker oferece comandos de jogador para o menu e o acompanhamento, e comandos de administrador para gerenciamento, diagnostico e manutencao.

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

Permissao necessaria: kginfoservs_quetes.admin

O titulo do menu exibe "Quests - NomeDoJogador".

/quests track

Comeca a acompanhar uma quest no scoreboard.

/quests track <quest_id>

O jogador pode acompanhar ate 3 quests simultaneas. As quests acompanhadas sao exibidas no scoreboard no jogo com seus objetivos em tempo real.

Limite de acompanhamento

Se o jogador ja esta acompanhando 3 quests, ele deve remover uma antes de adicionar uma nova.

---

Comandos de administrador

/kgquests

Comando principal de administracao.

/kgquests <subcomando>

Alias: /kgquetes, /kgq

Permissao necessaria: 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 especifico
/kgquests purgepackage MeuPacote

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

# Limpar sem confirmacao (forcar)
/kgquests purgepackage MeuPacote --force

Processo:

1. O comando exibe uma previa dos dados que serao excluidos
2. Execute novamente com confirm para validar
3. Ou use --force para pular a confirmacao

Dados excluidos:

• 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

Acao irreversivel

Este comando exclui permanentemente os dados. Faca backup do seu banco de dados antes de executar este comando.

Quests diarias

O pattern wildcard e util para quests recorrentes:

/kgquests purgepackage Daily-%

---

/kgquests refresh

Forca 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. Util se os dados em cache nao correspondem a realidade.

---

/kgquests scoreboard

Controla o scoreboard de quests.

/kgquests scoreboard <on|off|toggle>

Opcao	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 nao tem efeito.

---

/kgquests stats

Exibe as estatisticas de desempenho do cache.

/kgquests stats

Informacoes exibidas:

• Taxa de acerto por cache (QuestStatus, QuestProgress, QuestTracked, PlaceholderAPI)
• Numero de acertos/erros e carregamentos
• Analise da taxa de acerto (excelente: acima de 95%, bom: acima de 85%, a verificar: abaixo de 85%)

---

/kgquests redis

Exibe os diagnosticos Redis.

/kgquests redis [jogador]

Sem argumento — Visao global:

• Numero de chaves quest:progress:*, quest:tracked:*, quest:status:*
• Total de chaves em cache

Com jogador — Visao especifica:

• Existencia e TTL da chave de progresso
• Existencia e TTL da chave de tracking
• Numero de chaves de status
• Alerta se chaves estiverem ausentes

---

/kgquests health

Verificacao de saude completa do sistema.

/kgquests health

Verifica todos os componentes:

• Banco de dados (conexao + latencia)
• Redis (disponibilidade + latencia)
• BetonQuest (carga)
• PlaceholderAPI (ativo)
• Virtual Threads (quantidade)
• Memoria JVM
• Veredito global de saude

---

/kgquests memory

Relatorio detalhado de uso de memoria.

/kgquests memory

Informacoes exibidas:

• Numero de entradas por cache e estimativa em KB
• Menus GUI abertos
• Memoria JVM (total, utilizada, maxima)
• Recomendacoes de otimizacao

---

/kgquests benchmark

Testes de desempenho com medicoes de latencia.

/kgquests benchmark [numero_jogadores]

Testes executados:

• Cold start: leitura com cache vazio
• Warm cache: leitura com cache carregado
• Stress BDD: requisicoes sequenciais
• Resultados: latencia, throughput, taxa de acerto
• Recomendacoes de capacidade

---

/kgquests analytics

Estatisticas de adocao e conclusao das quests.

/kgquests analytics [package]

Sem argumento — Visao global:

• Total de jogadores com dados
• Numero de quests ativas e concluidas
• Top 5 quests ativas
• Top 5 quests concluidas (com taxa de conclusao)
• Top 5 quests acompanhadas

Com package — Visao especifica:

• Estatisticas detalhadas para um pacote de quests

---

/kgquests update

Verifica e baixa as atualizacoes do plugin.

/kgquests update

Verifica se uma nova versao esta disponivel e a baixa se for o caso. O JAR e colocado em plugins/update/ e sera aplicado na proxima reinicializacao.

---

/questsreload

Recarrega a configuracao do plugin.

/questsreload

Alias: /quetesreload

Permissao necessaria: kginfoservs_quetes.reload

Recarrega:

• config.yml (categorias, traducoes, scoreboard, etc.)
• quests_config.yml (textos e etapas das quests)

---

Resumo dos comandos

Comando	Descricao	Permissao
/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	Estatisticas do cache	kginfoservs_quetes.admin
/kgquests redis [jogador]	Diagnosticos Redis	kginfoservs_quetes.admin
/kgquests health	Saude do sistema	kginfoservs_quetes.admin
/kgquests memory	Relatorio de memoria	kginfoservs_quetes.admin
/kgquests benchmark [n]	Testes de desempenho	kginfoservs_quetes.admin
/kgquests analytics [pkg]	Estatisticas das quests	kginfoservs_quetes.admin
/kgquests update	Verificar atualizacoes	kginfoservs_quetes.admin
/questsreload	Recarregar a configuracao	kginfoservs_quetes.reload

Autocompletar com Tab

O autocompletar por Tab esta disponivel para todos os subcomandos de /kgquests, incluindo nomes de jogadores e pacotes de quests.