Instalação

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

Pré-requisitos

Pré-requisito	Versão mínima	Recomendado
Servidor	Paper 1.21+	Paper última versão
Java	Java 21+	Java 21
BetonQuest	3.0+	Última versão
Banco de dados	MySQL 8.0+ / MariaDB 10.5+	MariaDB última versão
Redis	6.0+ (opcional)	Redis última versão
Licença	Chave de licença válida KGInfoServs	-

Compatibilidade

O plugin funciona apenas no Paper ou seus forks (Purpur, Pufferfish). Java 21 é obrigatório.

Etapa 1: Baixar o plugin

Baixe o arquivo JAR a partir da sua área 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 configuração:

plugins/KGInfoServs-QuestsTrack/
├── config.yml           # Configuração principal
├── quests_config.yml    # Textos e etapas das quests
└── license.key          # Arquivo de licença (a preencher)

Etapa 3: Configurar a licença

1. Abra plugins/KGInfoServs-QuestsTrack/license.key
2. Cole sua chave de licença (uma única linha, sem espaços)
3. Reinicie o servidor
4. Verifique nos logs:

   [QuestsTracker] License validated successfully
   [QuestsTracker] Plugin enabled

Problema de licença?

Consulte Solução de problemas - Erro de licença.

Etapa 4: Banco de dados (OBRIGATÓRIO)

Como funciona

O QuestsTracker utiliza o mesmo banco de dados que o BetonQuest. Não há configuração de banco de dados separada no plugin.

Certifique-se de que o BetonQuest está 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"

Configuração do BetonQuest obrigatória

O BetonQuest deve ter o MySQL ativado. Se o BetonQuest estiver usando SQLite (padrão), o QuestsTracker não poderá funcionar. Ative o MySQL na configuração do BetonQuest antes de iniciar o QuestsTracker.

Criação do banco de dados

Se ainda não 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 próprias tabelas no banco de dados do BetonQuest na primeira inicialização:

Tabela	Descrição
player_quest_progress	Progresso das quests (etapa atual, objetivos concluídos)
player_tracked_quest	Quest atualmente acompanhada por cada jogador
player_preferences	Preferências do jogador (exibir quests concluídas, etc.)

Etapa 5: Redis (opcional)

O Redis é necessário apenas para a sincronização multi-servidor. Se você tem um único servidor, pule esta etapa.

Instalação 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

Configuração no config.yml

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

Servidor único?

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

Etapa 6: Configuração do BetonQuest

Para que uma quest apareça 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 Integração BetonQuest para o guia completo.

Etapa 7: Primeira configuração

1. Categorias do menu

Personalize as categorias no config.yml. Você pode definir até 4 categorias com nomes, ícones e comportamentos personalizados:

defaultCategory: "other"  # Categoria padrão se questCategory não for especificada

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

Veja Configuração para a referência completa.

2. Idioma do menu

O idioma do menu é determinado pela configuração language em plugins/BetonQuest/config.yml. Idiomas suportados: fr-FR, en-US, pl-PL.

3. Recarregar a configuração

/questsreload

Etapa 8: Teste no jogo

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

Checklist de verificação

• O menu abre com /quests
• As categorias são exibidas com os nomes e ícones corretos
• As quests ativas aparecem na categoria correta
• O acompanhamento funciona (/quests track <quest_id>)
• O scoreboard exibe os objetivos da quest acompanhada
• A paginação funciona (se houver muitas quests)

Problema de exibição?

Consulte Solução de problemas para as soluções dos problemas comuns.

Atualização do plugin

Para atualizar para uma nova versão:

1. Pare o servidor
2. Substitua o JAR em plugins/
3. Inicie o servidor
4. Verifique os logs para a nova versão
5. Execute /questsreload se necessário

Atualização automática

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

Backup

Antes de qualquer atualização, faça backup da sua pasta plugins/KGInfoServs-QuestsTrack/ e do seu banco de dados.

Próximas etapas

1. Configure suas categorias e quests: Configuração
2. Integre suas quests BetonQuest: Integração BetonQuest
3. Configure o Redis se multi-servidor: Multi-servidor
4. Em caso de problema: Solução de problemas