Configuration

Tous les paramètres de BQBetterHUD sont situés dans plugins/KGInfoServs-BQBetterHud/config.yml.

📄 Fichier de configuration complet

config.yml
# Langue du plugin (en, fr)
language: "fr"

# ID du popup BetterHud pour le texte du PNJ (sans options)
spoken-popup: "bq_spoken"

# ID du popup BetterHud pour les options du joueur (mode scroll)
option-popup: "bq_option"

# ID du popup BetterHud pour les options du joueur (mode fixed)
option-popup-fixed: "bq_option_fixed"

# Son joué lors du changement d'option
option-sound:
  key: "minecraft:ui.button.click"
  volume: 1.0
  pitch: 1.0

# Configuration de l'effet typewriter
typewriter:
  enabled: true
  speed: 30  # Caractères par seconde

# Mode de sélection des options
# "scroll" = 3 options visibles, défilement avec molette
# "fixed" = toutes les options visibles avec indicateur de main
selection-mode: "scroll"

# Indicateur de sélection pour les options
selection-indicator:
  # Préfixe avant l'option sélectionnée (vide = utilise l'image de main)
  prefix: ""

  # Couleur de l'option sélectionnée (format MiniMessage)
  selected-color: "<#97deaa>"

  # Couleur des options non sélectionnées
  unselected-color: "<gray>"

  # Position Y de base pour la première option (mode fixed uniquement)
  hand-base-y: -25

  # Espacement entre les lignes d'options (pixels)
  hand-line-height: 10

  # Longueur maximale du texte d'une option (0 = illimité)
  max-option-length: 25

# Configuration du système de mise à jour
updater:
  # Téléchargement automatique des mises à jour dans plugins/update/
  auto-download: false

# Mode debug (logs détaillés dans la console)
debug: false

⚙️ Paramètres détaillés

🌍 Langue

language: "fr"

Valeur	Description
`en`	Anglais (English)
`fr`	Français

Définit la langue des messages du plugin (messages_en.yml ou messages_fr.yml).

🎨 IDs des popups BetterHud

spoken-popup: "bq_spoken"
option-popup: "bq_option"
option-popup-fixed: "bq_option_fixed"

Ces valeurs correspondent aux IDs définis dans plugins/BetterHud/popups/betonquest-popup.yml.

Paramètre	Usage
`spoken-popup`	Affichage du texte du PNJ quand il n'y a pas d'options
`option-popup`	Affichage des options en mode scroll
`option-popup-fixed`	Affichage des options en mode fixed

Ne pas modifier

À moins d'avoir renommé les popups dans BetterHud, ne modifiez pas ces valeurs.

🔊 Sons

option-sound:
  key: "minecraft:ui.button.click"
  volume: 1.0
  pitch: 1.0

Paramètre	Type	Valeur par défaut	Description
`key`	String	`minecraft:ui.button.click`	Nom du son Minecraft
`volume`	Double	`1.0`	Volume (0.0 = muet, 1.0 = normal)
`pitch`	Double	`1.0`	Hauteur (0.5 = grave, 2.0 = aigu)

Sons recommandés :

minecraft:ui.button.click (par défaut)
minecraft:block.note_block.hat
minecraft:entity.experience_orb.pickup
minecraft:block.lever.click

⌨️ Effet Typewriter

typewriter:
  enabled: true
  speed: 30

Paramètre	Type	Valeur par défaut	Description
`enabled`	Boolean	`true`	Active/désactive l'effet typewriter
`speed`	Integer	`30`	Caractères affichés par seconde

Valeurs recommandées pour speed :

20 : Lent (effet cinématique)
30 : Normal (recommandé)
50 : Rapide
100 : Très rapide

Effet typewriter

Le joueur peut passer l'animation en cliquant droit ou en appuyant sur Espace pendant l'affichage.

🎯 Mode de sélection

selection-mode: "scroll"

Mode	Description	Popups utilisé
`scroll`	3 options visibles (précédente, actuelle, suivante)	`option-popup`
`fixed`	Toutes les options visibles (max 10) avec indicateur de main	`option-popup-fixed`

Mode Scroll

Avantage : Fonctionne avec un nombre illimité d'options
Navigation : Molette de souris
Affichage : 3 options à la fois

Mode Fixed

Avantage : Toutes les options visibles simultanément
Limitation : Maximum 10 options (recommandé : 4-5)
Navigation : Molette de souris
Indicateur : Image de main pointant l'option sélectionnée

🖱️ Indicateur de sélection

selection-indicator:
  prefix: ""
  selected-color: "<#97deaa>"
  unselected-color: "<gray>"
  hand-base-y: -25
  hand-line-height: 10
  max-option-length: 25

Préfixe textuel

prefix: ""  # Vide = utilise l'image de main (mode fixed)

Exemples de préfixes personnalisés :

prefix: "➤ "   # Flèche
prefix: "▶ "   # Triangle
prefix: "» "   # Chevron
prefix: "👉 "  # Emoji

Mode Scroll uniquement

Le préfixe s'affiche uniquement en mode scroll. En mode fixed, l'indicateur est toujours une image de main.

Couleurs

Utilisez le format MiniMessage pour les couleurs :

selected-color: "<#97deaa>"      # Vert pastel (hex)
unselected-color: "<gray>"        # Gris

# Autres exemples :
selected-color: "<green>"         # Vert Minecraft
selected-color: "<#FFD700>"       # Or
selected-color: "<gradient:#FF0000:#00FF00>"  # Dégradé

Positionnement de la main (mode fixed)

hand-base-y: -25         # Position Y de la première option
hand-line-height: 10     # Espacement entre les options

Calcul automatique : hand_y = hand-base-y + (selected_index * hand-line-height)

Exemple avec 4 options :

Option 1 : hand_y = -25 + (0 * 10) = -25
Option 2 : hand_y = -25 + (1 * 10) = -15
Option 3 : hand_y = -25 + (2 * 10) = -5
Option 4 : hand_y = -25 + (3 * 10) = 5

Longueur maximale

max-option-length: 25

0 : Aucune limite (peut casser la mise en page)
25 : Tronque à 25 caractères (recommandé)
30+ : Pour layouts plus larges

Le texte tronqué affiche ... à la fin.

🔄 Système de mise à jour

updater:
  auto-download: false

Valeur	Description
`false`	Les mises à jour doivent être téléchargées manuellement
`true`	Le plugin télécharge automatiquement dans `plugins/update/`

Installation manuelle requise

Même avec auto-download: true, vous devez manuellement :

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

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

Vérifier les mises à jour :

/bqhud update

🐛 Mode Debug

debug: false

Active les logs détaillés dans la console :

États de conversation (begin, display, end)
Variables BetterHud
Événements d'interaction (scroll, clic, sneak)
Validation de licence
Affichage des popups

Performances

Le mode debug génère beaucoup de logs. Utilisez-le uniquement pour diagnostiquer des problèmes.

🎨 Configuration avancée

Personnaliser les layouts BetterHud

Les layouts sont dans plugins/BetterHud/layouts/betonquest-layout.yml.

Exemple de modification de la couleur du fond :

layouts/betonquest-layout.yml
layouts:
  bq_dialogue:
    images:
      dialogue_background:
        image: dialogue
        x: 0
        y: 0
        # Ajuster la transparence
        color: "#FFFFFF"
        opacity: 0.8  # 80% opacité

Ajouter un son personnalisé

Si vous avez un resourcepack avec des sons personnalisés :

option-sound:
  key: "custom:menu_click"  # Votre son personnalisé
  volume: 0.8
  pitch: 1.2

Limiter les options en mode fixed

Si vous avez toujours plus de 4 options, ajustez votre layout BetterHud pour afficher plus de lignes :

layouts/betonquest-layout.yml
# Ajouter option_5, option_6, etc.
texts:
  option_5:
    text: dialogue
    x: 50
    y: 100  # Ajuster position Y
    value: "[custom_variable:option_5]"

📝 Messages personnalisés

Les messages du plugin sont dans messages_en.yml et messages_fr.yml.

messages_fr.yml
command:
  reload:
    success: "&aConfiguration rechargée !"
    error: "&cErreur lors du rechargement."
  update:
    not-initialized: "&cGestionnaire de versions non initialisé."
    no-update: "&eAucune mise à jour disponible."
    access-denied: "&cAccès refusé. Votre licence ne permet pas les mises à jour."
    downloading: "&aTéléchargement de la mise à jour..."

popup:
  not-found: "&cPopup ''{0}'' introuvable dans BetterHud !"

Codes couleur supportés :

&a = vert, &c = rouge, &e = jaune
{0}, {1} = Variables de remplacement

🔄 Recharger la configuration

Après modification du fichier config.yml :

/bqhud reload

Rechargement

Cette commande recharge :

config.yml
messages_en.yml et messages_fr.yml

Elle ne recharge PAS les configurations BetterHud. Pour cela, utilisez /betterhud reload.

💡 Configurations recommandées

Configuration cinématique

typewriter:
  enabled: true
  speed: 20  # Lent
selection-mode: "fixed"
selection-indicator:
  prefix: ""
  selected-color: "<gradient:#FFD700:#FFA500>"

Configuration rapide

typewriter:
  enabled: true
  speed: 100  # Très rapide
selection-mode: "scroll"
option-sound:
  key: "minecraft:block.note_block.hat"
  volume: 0.5

Configuration minimaliste

typewriter:
  enabled: false  # Pas d'effet
selection-mode: "scroll"
option-sound:
  volume: 0.0  # Pas de son

🆘 Problèmes courants

Problème	Solution
Les couleurs ne fonctionnent pas	Vérifiez le format MiniMessage (`<#RRGGBB>` ou `<color>`)
La main ne s'affiche pas (fixed mode)	Installez PlaceholderAPI
Les options sont tronquées	Augmentez `max-option-length` ou réduisez le texte
Le son ne joue pas	Vérifiez que le son existe dans Minecraft 1.21+

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

📄 Fichier de configuration complet​

⚙️ Paramètres détaillés​

🌍 Langue​

🎨 IDs des popups BetterHud​

🔊 Sons​

⌨️ Effet Typewriter​

🎯 Mode de sélection​

Mode Scroll​

Mode Fixed​

🖱️ Indicateur de sélection​

Préfixe textuel​

Couleurs​

Positionnement de la main (mode fixed)​

Longueur maximale​

🔄 Système de mise à jour​

🐛 Mode Debug​

🎨 Configuration avancée​

Personnaliser les layouts BetterHud​

Ajouter un son personnalisé​

Limiter les options en mode fixed​

📝 Messages personnalisés​

🔄 Recharger la configuration​

💡 Configurations recommandées​

Configuration cinématique​

Configuration rapide​

Configuration minimaliste​

🆘 Problèmes courants​