Instalacao

Guia passo a passo para instalar e configurar o QuestsTracker no seu servidor Minecraft.

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). Java 21 e obrigatorio.

Etapa 1: Baixar o plugin

Baixe o arquivo JAR a partir da sua area de cliente KGInfoServs.

Etapa 2: Instalar no servidor

1. Pare seu servidor (recomendado)

2. Copie o JAR para a pasta plugins/:

   seu-servidor/
   └── plugins/
       ├── BetonQuest.jar
       └── kginfoservs_queststrack-X.X.X.jar

3. Inicie o servidor

O plugin gera automaticamente sua pasta de configuracao:

plugins/kginfoservs_queststrack/
├── config.yml           # Configuracao principal
├── quests_config.yml    # Textos e etapas das quests
└── license.key          # Arquivo de licenca (a preencher)

Etapa 3: Configurar a licenca

1. Abra plugins/kginfoservs_queststrack/license.key
2. Cole sua chave de licenca (uma unica linha, sem espacos)
3. Reinicie o servidor
4. Verifique nos logs:

   [QuestsTracker] License validated successfully
   [QuestsTracker] Plugin enabled

Problema de licenca?

Consulte Solucao de problemas - Erro de licenca.

Etapa 4: Banco de dados (OBRIGATORIO)

Como funciona

O QuestsTracker utiliza o mesmo banco de dados que o BetonQuest. Nao ha configuracao de banco de dados separada no plugin.

Certifique-se de que o BetonQuest esta configurado com MySQL/MariaDB no seu arquivo plugins/BetonQuest/config.yml:

# Em plugins/BetonQuest/config.yml
mysql:
  enabled: true
  host: "localhost"
  port: "3306"
  base: "betonquest"
  user: "seu_usuario"
  pass: "sua_senha"

Configuracao do BetonQuest obrigatoria

O BetonQuest deve ter o MySQL ativado. Se o BetonQuest estiver usando SQLite (padrao), o QuestsTracker nao podera funcionar. Ative o MySQL na configuracao do BetonQuest antes de iniciar o QuestsTracker.

Criacao do banco de dados

Se ainda nao foi feito, crie o banco de dados para o BetonQuest:

CREATE DATABASE betonquest;
CREATE USER 'betonquest'@'localhost' IDENTIFIED BY 'sua_senha';
GRANT ALL PRIVILEGES ON betonquest.* TO 'betonquest'@'localhost';
FLUSH PRIVILEGES;

Tabelas criadas automaticamente

O QuestsTracker cria suas proprias tabelas no banco de dados do BetonQuest na primeira inicializacao:

Tabela	Descricao
player_quest_progress	Progresso das quests (etapa atual, objetivos concluidos)
player_tracked_quest	Quest atualmente acompanhada por cada jogador
player_preferences	Preferencias do jogador (exibir quests concluidas, etc.)

Etapa 5: Redis (opcional)

O Redis e necessario apenas para a sincronizacao multi-servidor. Se voce tem um unico servidor, pule esta etapa.

Instalacao do Redis

# Ubuntu/Debian
sudo apt install redis-server

# CentOS/RHEL
sudo yum install redis

# Docker
docker run -d --name redis -p 6379:6379 redis:latest

Configuracao no config.yml

redis:
  enabled: true
  host: "127.0.0.1"
  port: 6379
  password: ""  # Deixe vazio se nao houver senha

Servidor unico?

Se voce tem apenas um servidor, mantenha redis.enabled: false. O plugin funciona perfeitamente sem Redis.

Etapa 6: Configuracao do BetonQuest

Para que uma quest apareca no menu, ela deve usar o template trackedQuest.

Adicionar o template a uma quest

No arquivo package.yml da sua quest BetonQuest:

templates:
  - trackedQuest

questParameters:
  questCategory: "Story"  # Deve corresponder ao displayName de uma categoria

Veja Integracao BetonQuest para o guia completo.

Etapa 7: Primeira configuracao

1. Categorias do menu

Personalize as categorias no config.yml. Voce pode definir ate 4 categorias com nomes, icones e comportamentos personalizados:

defaultCategory: "other"  # Categoria padrao se questCategory nao for especificada

menuItems:
  categories:
    story:
      displayName: "Story"
      material: WRITABLE_BOOK
      customModelData: 0
      autoTrack: true
    secondary:
      displayName: "Secondary"
      material: BOOK
      customModelData: 0
      autoTrack: false

Veja Configuracao para a referencia completa.

2. Idioma do menu

O idioma do menu e determinado pela configuracao language em plugins/BetonQuest/config.yml. Idiomas suportados: fr-FR, en-US, pl-PL.

3. Recarregar a configuracao

/questsreload

Etapa 8: Teste no jogo

1. Conecte-se ao servidor
2. Abra o menu: /quests
3. Verifique se o menu e exibido corretamente
4. Ative uma quest via BetonQuest e verifique se ela aparece na categoria correta

Checklist de verificacao

• O menu abre com /quests
• As categorias sao exibidas com os nomes e icones corretos
• As quests ativas aparecem na categoria correta
• O acompanhamento funciona (/quests track <quest_id>)
• O scoreboard exibe os objetivos da quest acompanhada
• A paginacao funciona (se houver muitas quests)

Problema de exibicao?

Consulte Solucao de problemas para as solucoes dos problemas comuns.

Atualizacao do plugin

Para atualizar para uma nova versao:

1. Pare o servidor
2. Substitua o JAR em plugins/
3. Inicie o servidor
4. Verifique os logs para a nova versao
5. Execute /questsreload se necessario

Atualizacao automatica

Ative updater.auto-download: true no config.yml para baixar automaticamente as novas versoes em plugins/update/.

Backup

Antes de qualquer atualizacao, faca backup da sua pasta plugins/kginfoservs_queststrack/ e do seu banco de dados.

Proximas etapas

1. Configure suas categorias e quests: Configuracao
2. Integre suas quests BetonQuest: Integracao BetonQuest
3. Configure o Redis se multi-servidor: Multi-servidor
4. Em caso de problema: Solucao de problemas