KGInfoServs QuestsTracker

QuestsTracker e um addon premium para BetonQuest que oferece um sistema completo de acompanhamento e gerenciamento de quests para o seu servidor Minecraft.

Projetado para servidores Paper 1.21+ e otimizado com Java 21, ele oferece um menu GUI interativo, um scoreboard em tempo real e sincronizacao multi-servidor transparente.

---

Funcionalidades

Menu de quests interativo (GUI)

• Categorias dinamicas: ate 4 categorias totalmente personalizaveis (nome, icone, modelo)
• Subcategorias: organizacao hierarquica ilimitada (ex: Historia > Capitulo 1)
• Barra de progresso automatica por subcategoria
• Paginacao para gerenciar um grande numero de quests
• Status visuais: bloqueado, ativo, concluido — cada um com seu icone e cor
• Alternar quests concluidas: o jogador pode ocultar/exibir as quests completadas (preferencia salva)
• Multilingue: frances, ingles, polones (determinado pela config do BetonQuest)

Scoreboard de acompanhamento em tempo real

• Acompanhamento de ate 3 quests simultaneas por jogador
• Titulo e separador personalizaveis em formato MiniMessage (gradientes, cores, etc.)
• Atualizacoes acionadas por evento: sem polling, sem ticks desnecessarios
• 95-98% menos pacotes de rede do que um scoreboard classico
• Ativavel/desativavel globalmente (config) e por jogador (comando)

Integracao nativa com BetonQuest

5 events personalizados registrados diretamente no BetonQuest:

Event	Descricao
activeQuest	Ativa uma quest (a torna visivel no menu)
lockQuest	Bloqueia uma quest (a oculta do menu)
finishQuest	Conclui uma quest
nextStep	Avanca para a proxima etapa
kgcomplete	Marca um objetivo como concluido

Sistema de status

Status	Descricao	Acionador
Bloqueado	Quest ainda nao disponivel	Nenhuma tag (estado padrao)
Ativo	Quest disponivel e rastreavel	Event activeQuest
Concluido	Quest completada	Event finishQuest

Sincronizacao multi-servidor

• Sincronizacao via Redis Pub/Sub em tempo real
• Cache de dois niveis (L1 local + L2 Redis) para desempenho otimo
• Sistema de heartbeat durante mudancas de servidor (janela de 2 minutos)
• Circuit breaker: fallback automatico para o banco de dados se o Redis estiver indisponivel
• Rate limiting: 100ms por jogador para evitar sobrecarga no Redis

Ferramentas de administracao

• Diagnosticos completos: saude do sistema, estatisticas de cache, relatorio de memoria, benchmarks
• Analytics: taxa de conclusao, quests populares, adocao por jogador
• Limpeza de dados: exclusao direcionada com patterns wildcard
• Atualizacao automatica: verificacao e download de novas versoes

Desempenho

• Virtual Threads (Java 21) para paralelismo sem bloquear a thread principal
• Pool de conexoes HikariCP para o banco de dados
• Cache Caffeine local com invalidacao inteligente
• Inicializacao assincrona (BDD + Redis em paralelo)

---

Pre-requisitos

Pre-requisito	Versao minima	Recomendado
Servidor	Paper 1.21+	Paper ultima versao
Java	Java 21+	Java 21
BetonQuest	3.0+	Ultima versao
Banco de dados	MySQL 8.0+ / MariaDB 10.5+	MariaDB ultima versao
Redis	6.0+ (opcional)	Redis ultima versao
Licenca	Chave de licenca valida KGInfoServs	-

Compatibilidade

O plugin funciona apenas no Paper ou seus forks (Purpur, Pufferfish). Spigot nao e suportado. Java 21 e obrigatorio para o suporte a Virtual Threads.

---

Visao rapida

Abrir o menu de quests

/quests

Acompanhar uma quest

/quests track <quest_id>

Diagnosticos de administrador

/kgquests health      # Saude do sistema
/kgquests stats       # Estatisticas do cache
/kgquests analytics   # Taxa de conclusao das quests
/questsreload         # Recarregar a configuracao

---

Sumario da documentacao

Pagina	Descricao
Instalacao	Guia de instalacao completo passo a passo
Configuracao	Referencia completa de config.yml e quests_config.yml
Comandos	Todos os comandos de jogador e administrador
Permissoes	Permissoes e cargos recomendados
Integracao BetonQuest	Events, templates, tags e exemplos completos
Multi-servidor	Sincronizacao Redis e cache distribuido
Solucao de problemas	Resolucao de problemas comuns