Aller au contenu principal

Installation

Ce guide vous accompagne pas à pas pour installer et configurer BQBetterHUD sur votre serveur Minecraft.

📋 Prérequis​

Avant d'installer BQBetterHUD, assurez-vous d'avoir :

Serveur​

  • Paper ou Spigot 1.21+
  • Java 17 ou supérieur
  • Accès aux fichiers du serveur

Plugins requis​

Plugins optionnels​

  • PlaceholderAPI 2.11+ (pour avatars dynamiques et indicateurs avancés)

🔧 Étape 1 : Installation des dépendances​

1.1 Installer BetonQuest​

# Télécharger BetonQuest 3.0+ depuis https://betonquest.org/3.0-DEV/Downloads/
# Placer BetonQuest.jar dans plugins/
# Redémarrer le serveur

1.2 Installer BetterHud​

# Télécharger depuis SpigotMC
# Placer BetterHud.jar dans plugins/
# Redémarrer le serveur

1.3 Installer PlaceholderAPI (optionnel)​

# Télécharger depuis SpigotMC
# Placer PlaceholderAPI.jar dans plugins/
# Redémarrer le serveur

📦 Étape 2 : Installation de BQBetterHUD​

2.1 Achat et téléchargement​

  1. Achetez le plugin sur kginfoservs.com
  2. Une licence vous sera fournie automatiquement après l'achat
  3. Connectez-vous à votre espace client KGInfoServs
  4. Accédez à la section Téléchargements
  5. Téléchargez KGInfoServs-BQBetterHud.jar
  6. Téléchargez aussi le dossier delivery/ (configurations BetterHud)

2.2 Installation du plugin​

# 1. Placer KGInfoServs-BQBetterHud.jar dans plugins/
# 2. Démarrer le serveur (génère les fichiers de config)
# 3. Arrêter le serveur

2.3 Configuration de la licence​

Lors du premier démarrage, le plugin crée automatiquement :

plugins/KGInfoServs-BQBetterHud/
├── config.yml
├── license.key          # À CONFIGURER !
├── messages_en.yml
└── messages_fr.yml

Ouvrez license.key et vous verrez :

license.key
# KGInfoServs License Configuration
# HWID: 12345678-abcd-1234-abcd-123456789abc
# Entrez votre clé de licence ci-dessous (première ligne non-commentée)

VOTRE-CLE-DE-LICENCE-ICI
Important
  • La clé de licence vous a été fournie lors de l'achat du plugin
  • Copiez votre HWID (affiché dans le fichier)
  • Enregistrez ce HWID sur votre espace client KGInfoServs
  • Collez votre clé de licence (reçue par email/espace client)
  • Remplacez VOTRE-CLE-DE-LICENCE-ICI par votre clé
  • Sauvegardez le fichier

🎨 Étape 3 : Installation des fichiers BetterHud​

Le dossier delivery/ contient tous les fichiers de configuration pour BetterHud.

3.1 Structure du dossier delivery​

delivery/BetterHud/
├── popups/
│   └── betonquest-popup.yml       # Définitions des popups
├── layouts/
│   └── betonquest-layout.yml      # Layouts d'affichage
├── images/
│   └── dialogue-images.yml        # Configuration des images
├── texts/
│   └── dialogue.yml               # Polices et textes
├── backgrounds/
│   └── dialogue.yml               # Arrière-plans
├── assets/                        # Images PNG
│   ├── dialogue.png
│   ├── answer.png
│   ├── hand.png
│   ├── nameless.png
│   └── ...
└── NPC_AVATARS_GUIDE.md          # Guide avatars

3.2 Copie des fichiers​

Copiez TOUT le contenu du dossier delivery/BetterHud/ vers plugins/BetterHud/ :

# Windows
xcopy delivery\BetterHud\* plugins\BetterHud\ /E /Y

# Linux/Mac
cp -r delivery/BetterHud/* plugins/BetterHud/
Fusion de fichiers

Si vous avez déjà des configurations BetterHud existantes :

  • Les fichiers betonquest-*.yml sont nouveaux, pas de conflit
  • Les images dans assets/ peuvent être ajoutées sans écraser vos images existantes

3.3 Recharger BetterHud​

/betterhud reload

✅ Étape 4 : Vérification​

4.1 Vérifier le démarrage​

Redémarrez le serveur et vérifiez les logs :

[BQBetterHud] Validating license...
[BQBetterHud] License validated successfully!
[BQBetterHud] ConversationIO 'betterhud' registered successfully
[BQBetterHud] PlaceholderAPI expansion registered
[BQBetterHud] Plugin enabled!
Erreurs de licence

Si vous voyez :

[BQBetterHud] License validation failed!

Vérifiez :

  1. La clé de licence est correcte dans license.key
  2. Le HWID est enregistré sur votre espace client
  3. Le serveur a accès à Internet (validation en ligne)

4.2 Vérifier les popups BetterHud​

/betterhud list popups

Vous devriez voir :

  • bq_spoken
  • bq_option
  • bq_option_fixed

4.3 Tester avec BetonQuest​

Créez une conversation de test :

plugins/BetonQuest/conversations/test.yml
conversations:
  test_npc:
    quester: "Guide"
    conversationIO: betterhud
    first: "salut"
    NPC_options:
      salut:
        text: "Bienvenue ! Ceci est un test de BQBetterHUD."
        pointers: "option1,option2"
    player_options:
      option1:
        text: "Comment ça marche ?"
        pointer: "explication"
      option2:
        text: "Au revoir !"
        pointer: "fin"
      explication:
        text: "Super ! Ça fonctionne."
      fin:
        text: "À bientôt !"

Rechargez BetonQuest :

/bq reload

Créez un PNJ avec Citizens ou un bloc de commande :

/execute as @p run bq conversation test test_npc

🎨 Étape 5 : Personnalisation (optionnel)​

5.1 Activer par défaut​

Pour utiliser BQBetterHUD sur toutes vos conversations :

plugins/BetonQuest/config.yml
default_conversation_IO: betterhud,menu,chest

5.2 Ajouter des avatars NPC​

Consultez le guide Avatars NPC pour personnaliser les images de vos PNJ.

5.3 Ajuster la configuration​

Modifiez plugins/KGInfoServs-BQBetterHud/config.yml selon vos préférences (voir Configuration).

🔄 Mises à jour​

Mise à jour manuelle​

  1. Connectez-vous à votre espace client sur kginfoservs.com
  2. Téléchargez la nouvelle version depuis la section Téléchargements
  3. Arrêtez le serveur
  4. Remplacez l'ancien JAR par le nouveau
  5. Démarrez le serveur

Mise à jour automatique​

Si activé dans la config (updater.auto-download: true) :

/bqhud update

Le plugin télécharge automatiquement la mise à jour dans plugins/update/.

Auto-download

L'option auto-download télécharge les mises à jour mais ne les installe pas automatiquement (sécurité). Vous devez :

  1. Arrêter le serveur
  2. Déplacer le JAR depuis plugins/update/ vers plugins/
  3. Redémarrer

🆘 Problèmes courants​

ProblèmeSolution
License validation failedVérifiez HWID + clé de licence + connexion Internet
Popups not foundExécutez /betterhud reload après avoir copié les fichiers
ConversationIO not workingVérifiez conversationIO: betterhud dans votre conversation
Avatars ne s'affichent pasInstallez PlaceholderAPI et vérifiez les images dans assets/

Pour plus de détails, consultez le Guide de dépannage.

✨ Prochaines étapes​

Besoin d'aide ? Rejoignez notre Discord !

Dernière mise à jour le par Bossbirdyman