iHUD v2

Fichiers et manifeste

• fxmanifest.lua
  • ui_page "NUI/index.html"
  • Charge les fichiers CSS/JS/ressources depuis NUI/src/*
  • shared_script "config.lua"
  • client_script "client/*.lua"
• Logique client principale : client/main.lua
• Configuration: config.lua
• NUI : NUI/index.html, NUI/src/css/*, NUI/src/js/{config.js,index.js,events.js}, NUI/src/images/micro.png

Configuration (config.lua)

Config = {
  DEBUG = false,

  -- How to get ESX:
  ESX_method   = "function",         -- "function" (export) or "event"
  eventNameESX = "esx:getSharedObject",
  extendedName = "extended",         -- e.g. "es_extended" / "extended"
  VERSION_ESX  = "final",            -- "legacy" or "final" (informational)

  -- Status source (list of {name, percent}):
  statusEventName = "esx_customui:updateStatus",

  ACTIVED = {
    JOB         = true,
    JOB2        = true,
    MONEY       = true,
    BLACK_MONEY = true,
    MICRO       = true
  }
}

Remarques

• Si vous utilisez une coche de statut alternative (par exemple sigma_hud:onTick), le client écoute sur Config.statusEventName ou retombe à "sigma_hud:onTick".

Événements clients et flux de données

• Initialisation
  • esx:playerLoaded → L'interface HUD s'initialise avec les données du lecteur ESX.
  • Au démarrage, l'interface utilisateur (HUD) s'affiche et l'interface utilisateur native (NUI) reçoit :

    SendNUIMessage({ type = "init", config = Config.ACTIVED })
    

• Mises à jour de statut (Faim/Soif)
  • Écouter Config.statusEventName (défaut esx_customui:updateStatus) et émettre une liste comme :

    TriggerEvent("esx_customui:updateStatus", {
      { name = "hunger", percent = 48.0 },
      { name = "thirst", percent = 72.0 }
    })
    

  • L'interface utilisateur (HUD) associe ces éléments aux deux barres d'état.
• Emploi / Deuxième emploi
  • esx:setJob et esx:setJob2 sont traitées automatiquement. NUI reçoit :

    SendNUIMessage({ type = "updateJob", jobs = {
      { label = job.label, grade = job.grade_label },
      { label = job2.label, grade = job2.grade_label }
    }})
    

• Argent
  • esx:setAccountMoney mises à jour sur l'argent liquide et l'argent noir :

    SendNUIMessage({ type = "updateMoney", moneys = {
      { label = "Liquide", value = cash.money },
      { label = black.label, value = black.money }
    }})
    

• Voix (indicateur de conversation)
  • Sondages NetworkIsPlayerTalking(PlayerId()); affiche/masque l'icône du micro avec :

    SendNUIMessage({ type = "toogleMicro", show = true/false })
    

  • Une fonction d'assistance pour modifier les classes de proximité existe dans NUI (type = "changeMicro"), vous pouvez donc l'intégrer à votre ressource vocale si vous le souhaitez.
• Afficher/Masquer HUD (personnalisé)
  • Déclenchement depuis n'importe quel point côté client :

    TriggerEvent("iHud-V2::show", true)  -- show
    TriggerEvent("iHud-V2::show", false) -- hide
    

Installation

1. Déposez le dossier dans votre resources (par exemple resources/[ui]/iHud-V2).
2. Assurez-vous que la ressource :

   ensure iHud-V2
   

3. configurer méthode d'accès ESX, nom de l'événement d'état, et basculer les sections dans config.lua.
4. Vérifiez que votre script d'état émet { name = "hunger"/"thirst", percent = <0-100> } tableaux à Config.statusEventName.

Compatibilité et conseils

• Récupération ESX
  • function le mode attend : ESX = exports[Config.extendedName]:getSharedObject()
  • event le mode attend : TriggerEvent(Config.eventNameESX, function(obj) ESX = obj end)
• Proximité vocale
  • L'interface HUD est livrée avec un indicateur vocal intégré. Pour afficher les niveaux de proximité (chuchotement/normal/cri), configurez votre ressource vocale pour qu'elle envoie un message NUI avec type="changeMicro" et votre classe CSS choisie.
• stylisme
  • Polices et icônes chargées depuis des CDN ; l’interface utilisateur est réactive et minimaliste pour les serveurs RP.