Installation

Guide etape par etape pour installer et configurer QuestsTracker sur votre serveur Minecraft.

Prerequis

Prerequis	Version minimale	Recommande
Serveur	Paper 1.21+	Paper derniere version
Java	Java 21+	Java 21
BetonQuest	3.0+	Derniere version
Base de donnees	MySQL 8.0+ / MariaDB 10.5+	MariaDB derniere version
Redis	6.0+ (optionnel)	Redis derniere version
Licence	Cle de licence valide KGInfoServs	-

Compatibilite

Le plugin ne fonctionne que sur Paper ou ses forks (Purpur, Pufferfish). Java 21 est obligatoire.

Etape 1 : Telecharger le plugin

Telechargez le fichier JAR depuis votre espace client KGInfoServs.

Etape 2 : Installer sur le serveur

1. Arretez votre serveur (recommande)

2. Copiez le JAR dans le dossier plugins/ :

   votre-serveur/
   └── plugins/
       ├── BetonQuest.jar
       └── kginfoservs_queststrack-X.X.X.jar

3. Demarrez le serveur

Le plugin genere automatiquement son dossier de configuration :

plugins/kginfoservs_queststrack/
├── config.yml           # Configuration principale
├── quests_config.yml    # Textes et etapes des quetes
└── license.key          # Fichier de licence (a remplir)

Etape 3 : Configurer la licence

1. Ouvrez plugins/kginfoservs_queststrack/license.key
2. Collez votre cle de licence (une seule ligne, pas d'espaces)
3. Redemarrez le serveur
4. Verifiez dans les logs :

   [QuestsTracker] License validated successfully
   [QuestsTracker] Plugin enabled

Probleme de licence ?

Consultez Depannage - Erreur de licence.

Etape 4 : Base de donnees (OBLIGATOIRE)

Comment ca fonctionne

QuestsTracker utilise la meme base de donnees que BetonQuest. Il n'y a pas de configuration de base de donnees separee dans le plugin.

Assurez-vous que BetonQuest est configure avec MySQL/MariaDB dans son fichier plugins/BetonQuest/config.yml :

# Dans plugins/BetonQuest/config.yml
mysql:
  enabled: true
  host: "localhost"
  port: "3306"
  base: "betonquest"
  user: "votre_utilisateur"
  pass: "votre_mot_de_passe"

Configuration BetonQuest requise

BetonQuest doit avoir MySQL active. Si BetonQuest utilise SQLite (par defaut), QuestsTracker ne pourra pas fonctionner. Activez MySQL dans la configuration de BetonQuest avant de demarrer QuestsTracker.

Creation de la base de donnees

Si ce n'est pas deja fait, creez la base de donnees pour BetonQuest :

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

Tables creees automatiquement

QuestsTracker cree ses propres tables dans la base de donnees de BetonQuest au premier demarrage :

Table	Description
player_quest_progress	Progression des quetes (etape courante, objectifs completes)
player_tracked_quest	Quete actuellement suivie par chaque joueur
player_preferences	Preferences joueur (afficher les quetes terminees, etc.)

Etape 5 : Redis (optionnel)

Redis est necessaire uniquement pour la synchronisation multi-serveur. Si vous avez un seul serveur, passez cette etape.

Installation de 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

Configuration dans config.yml

redis:
  enabled: true
  host: "127.0.0.1"
  port: 6379
  password: ""  # Laisser vide si pas de mot de passe

Serveur unique ?

Si vous n'avez qu'un seul serveur, laissez redis.enabled: false. Le plugin fonctionne parfaitement sans Redis.

Etape 6 : Configuration BetonQuest

Pour qu'une quete apparaisse dans le menu, elle doit utiliser le template trackedQuest.

Ajouter le template a une quete

Dans le fichier package.yml de votre quete BetonQuest :

templates:
  - trackedQuest

questParameters:
  questCategory: "Story"  # Doit correspondre au displayName d'une categorie

Voir Integration BetonQuest pour le guide complet.

Etape 7 : Premiere configuration

1. Categories du menu

Personnalisez les categories dans config.yml. Vous pouvez definir jusqu'a 4 categories avec des noms, icones et comportements personnalises :

defaultCategory: "other"  # Categorie par defaut si questCategory non specifie

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

Voir Configuration pour la reference complete.

2. Langue du menu

La langue du menu est determinee par le reglage language dans plugins/BetonQuest/config.yml. Langues supportees : fr-FR, en-US, pl-PL.

3. Recharger la configuration

/questsreload

Etape 8 : Test en jeu

1. Connectez-vous au serveur
2. Ouvrez le menu : /quests
3. Verifiez que le menu s'affiche correctement
4. Activez une quete via BetonQuest et verifiez qu'elle apparait dans la bonne categorie

Checklist de verification

• Le menu s'ouvre avec /quests
• Les categories s'affichent avec les bons noms et icones
• Les quetes actives apparaissent dans la bonne categorie
• Le suivi fonctionne (/quests track <quest_id>)
• Le scoreboard affiche les objectifs de la quete suivie
• La pagination fonctionne (si beaucoup de quetes)

Probleme d'affichage ?

Consultez Depannage pour les solutions aux problemes courants.

Mise a jour du plugin

Pour mettre a jour vers une nouvelle version :

1. Arretez le serveur
2. Remplacez le JAR dans plugins/
3. Demarrez le serveur
4. Verifiez les logs pour la nouvelle version
5. Executez /questsreload si necessaire

Mise a jour automatique

Activez updater.auto-download: true dans config.yml pour telecharger automatiquement les nouvelles versions dans plugins/update/.

Sauvegarde

Avant toute mise a jour, sauvegardez votre dossier plugins/kginfoservs_queststrack/ et votre base de donnees.

Prochaines etapes

1. Configurez vos categories et quetes : Configuration
2. Integrez vos quetes BetonQuest : Integration BetonQuest
3. Configurez Redis si multi-serveur : Multi-serveur
4. En cas de probleme : Depannage