Aller au contenu principal

Commandes

BQBetterHUD propose une interface de commandes simple pour gérer le plugin.

📝 Commande principale​

/bqhud [sous-commande]

Alias : Aucun

Permission requise : bqhud.admin (voir Permissions)

🔄 Sous-commandes​

/bqhud reload​

Recharge la configuration et les fichiers de messages du plugin.

Usage :

/bqhud reload

Ce qui est rechargé :

  • ✅ config.yml - Configuration principale
  • ✅ messages_en.yml - Messages anglais
  • ✅ messages_fr.yml - Messages français

Ce qui N'est PAS rechargé :

  • ❌ Fichiers BetterHud (popups, layouts, images)
  • ❌ Licence (nécessite un redémarrage)

Réponses :

  • ✅ Configuration rechargée ! (succès)
  • ❌ Erreur lors du rechargement. (échec)

Exemple :

> /bqhud reload
[BQBetterHud] Configuration rechargée !
Recharger BetterHud

Pour recharger les configurations BetterHud (popups, layouts), utilisez :

/betterhud reload

/bqhud update​

Télécharge la dernière version disponible du plugin (si une mise à jour existe).

Usage :

/bqhud update

Prérequis :

  • ✅ Licence valide avec accès aux mises à jour
  • ✅ Connexion Internet active
  • ✅ Une mise à jour doit être disponible

Processus :

  1. Vérifie la disponibilité d'une mise à jour
  2. Télécharge le fichier JAR
  3. Sauvegarde dans plugins/update/
  4. Affiche un message de confirmation

Réponses :

MessageSignification
Aucune mise à jour disponible.Vous avez déjà la dernière version
Téléchargement de la mise à jour...Téléchargement en cours
Mise à jour téléchargée dans plugins/update/Succès
Accès refusé. Votre licence ne permet pas les mises à jour.Licence sans accès updates
Gestionnaire de versions non initialisé.Erreur interne

Exemple :

> /bqhud update
[BQBetterHud] Téléchargement de la mise à jour...
[BQBetterHud] Mise à jour téléchargée dans plugins/update/
[BQBetterHud] Redémarrez le serveur pour l'installer.
Installation manuelle

Le téléchargement est automatique, mais l'installation est manuelle :

  1. Arrêter le serveur
  2. Déplacer le nouveau JAR depuis plugins/update/ vers plugins/
  3. Remplacer l'ancien fichier
  4. Redémarrer le serveur

Ceci est une mesure de sécurité pour éviter les installations automatiques non souhaitées.

🔧 Auto-complétion​

La commande /bqhud propose une auto-complétion des sous-commandes :

/bqhud <TAB>
# Suggestions : reload, update

L'auto-complétion fonctionne uniquement si vous avez la permission bqhud.admin.

🎮 Commandes BetonQuest​

Démarrer une conversation avec BetterHud​

Pour tester BQBetterHUD avec BetonQuest :

/bq conversation <joueur> <conversation>

Exemple :

/bq conversation Notch test_npc
Activer BetterHud

Pour qu'une conversation utilise BQBetterHUD, ajoutez dans votre fichier de conversation :

conversations:
  test_npc:
    conversationIO: betterhud

Recharger BetonQuest​

Après avoir modifié vos conversations BetonQuest :

/bq reload

🎨 Commandes BetterHud​

Recharger BetterHud​

Après avoir modifié les popups, layouts ou images :

/betterhud reload

Lister les popups​

Vérifier que les popups BQBetterHUD sont bien chargés :

/betterhud list popups

Vous devriez voir :

  • bq_spoken
  • bq_option
  • bq_option_fixed

Afficher/Masquer un popup manuellement​

Pour tester l'affichage d'un popup :

/betterhud show <joueur> <popup_id>
/betterhud hide <joueur> <popup_id>

Exemple :

/betterhud show Notch bq_spoken

🔑 Permissions​

Toutes les commandes de BQBetterHUD nécessitent la permission bqhud.admin.

Voir la page Permissions pour plus de détails.

📊 Exemples d'utilisation​

Workflow de modification de configuration​

# 1. Modifier config.yml
nano plugins/KGInfoServs-BQBetterHud/config.yml

# 2. Recharger BQBetterHud
/bqhud reload

# 3. Tester
/bq conversation <joueur> <conversation>

Workflow de modification de layout BetterHud​

# 1. Modifier layout
nano plugins/BetterHud/layouts/betonquest-layout.yml

# 2. Recharger BetterHud (PAS bqhud !)
/betterhud reload

# 3. Tester
/bq conversation <joueur> <conversation>

Workflow de mise à jour​

# 1. Vérifier les mises à jour
/bqhud update

# 2. Si une mise à jour est disponible, arrêter le serveur
stop

# 3. Déplacer le JAR (en local sur le serveur)
mv plugins/update/KGInfoServs-BQBetterHud.jar plugins/

# 4. Redémarrer
# Le serveur démarre avec la nouvelle version

🆘 Messages d'erreur courants​

Vous n'avez pas la permission​

Cause : Vous n'avez pas la permission bqhud.admin

Solution : Demandez à un administrateur de vous accorder la permission :

/lp user <votre_nom> permission set bqhud.admin true

Popup 'bq_spoken' introuvable dans BetterHud !​

Cause : Les fichiers BetterHud n'ont pas été copiés ou BetterHud n'a pas été rechargé

Solution :

  1. Vérifiez que plugins/BetterHud/popups/betonquest-popup.yml existe
  2. Exécutez /betterhud reload
  3. Vérifiez avec /betterhud list popups

Gestionnaire de versions non initialisé​

Cause : Le plugin n'a pas pu initialiser le système de mise à jour (problème de licence ou de connexion)

Solution :

  1. Vérifiez que votre licence est valide
  2. Vérifiez la connexion Internet du serveur
  3. Redémarrez le serveur

Accès refusé. Votre licence ne permet pas les mises à jour​

Cause : Votre licence ne donne pas accès aux mises à jour automatiques

Solution :

  • Mettez à niveau votre licence sur votre espace client KGInfoServs
  • Ou téléchargez manuellement depuis votre espace client

💡 Conseils​

Utiliser un alias​

Pour raccourcir la commande, ajoutez un alias dans votre configuration shell ou utilisez un plugin d'alias :

# Exemple avec un plugin d'alias
/alias add bqr "bqhud reload"
# Ensuite :
/bqr

Automatiser les recharges​

Créez un script pour recharger tout après modification :

reload_bq.sh
#!/bin/bash
screen -S minecraft -X stuff "/bqhud reload\n"
screen -S minecraft -X stuff "/betterhud reload\n"
screen -S minecraft -X stuff "/bq reload\n"
echo "Rechargement complet effectué !"

Tester rapidement​

Utilisez un bloc de commande pour tester rapidement vos conversations :

/give @s command_block
# Dans le bloc de commande :
/execute as @p run bq conversation @s test_npc

🔗 Voir aussi​

Dernière mise à jour le par Bossbirdyman