KS-HUD

Installation

1. Décompressez l’archive livrée dans votre dossier resources/, sous le nom ks-hud.
2. Importez le fichier install.sql fourni dans votre base de données.
3. Ajoutez ensure ks-hud dans votre server.cfg, après oxmysql et qb-core.
4. Redémarrez votre serveur.

Configuration

Config.Elements = {
  health = { enabled = true, position = "bottom-left" },
  hunger = { enabled = true, position = "bottom-left" },
  minimap = { enabled = true, showSpeed = true, showFuel = true },
}
Config.CompactModeKey = "F7"

Chaque élément se désactive ou se repositionne indépendamment, utile pour libérer de la place quand un autre script d’interface occupe déjà une zone de l’écran.

Ajouter un indicateur de métier

Un indicateur personnalisé s’enregistre pour n’importe quel métier :

exports['ks-hud']:RegisterJobIndicator('police', {
  label = "En service",
  icon = "fa-solid fa-shield-halved",
  getValue = function(src) return QBCore.Functions.GetPlayer(src).PlayerData.job.onduty end,
})

getValue est réévaluée périodiquement — retournez la valeur à afficher (texte, booléen ou nombre) selon l’icône choisie.

Problèmes fréquents

Le HUD se superpose à un autre script d’interface. Ajustez Config.Elements[element].position pour libérer la zone occupée par l’autre interface, ou désactivez temporairement l’élément concerné via enabled = false.

La minimap n’affiche pas la vitesse ou le carburant. Vérifiez que showSpeed et showFuel sont bien à true, et que votre script de carburant expose une valeur lisible (KS-HUD lit exports['votre-script-carburant']:GetFuel(vehicle) par défaut, configurable dans Config.FuelExport).