iHUD v2

Dateien & Manifest

• fxmanifest.lua
  • ui_page "NUI/index.html"
  • Lädt CSS/JS/Assets von NUI/src/*
  • shared_script "config.lua"
  • client_script "client/*.lua"
• Hauptlogik des Clients: client/main.lua
• Konfiguration: config.lua
• NUI: NUI/index.html, NUI/src/css/*, NUI/src/js/{config.js,index.js,events.js}, NUI/src/images/micro.png

Konfiguration (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
  }
}

Hinweise

• Wenn du einen alternativen Status-Tick verwendest (z. B. sigma_hud:onTick), hört der Client zu auf Config.statusEventName oder fällt zurück auf "sigma_hud:onTick".

Clientereignisse und Datenfluss

• Initialisierung
  • esx:playerLoaded → HUD wird mit ESX-Spielerdaten initialisiert.
  • Beim Initialisieren wird das HUD angezeigt und NUI empfängt:

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

• Statusaktualisierungen (Hunger/Durst)
  • Anhören Config.statusEventName (Standard esx_customui:updateStatus) und eine Liste wie folgt ausgeben:

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

  • HUD ordnet diese den beiden Statusleisten zu.
• Hauptberuf / Nebenjob
  • esx:setJob und esx:setJob2 werden automatisch verarbeitet. NUI empfängt:

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

• Geld
  • esx:setAccountMoney Aktualisierungen zu Bargeld und Schwarzgeld:

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

• Stimme (Sprechanzeige)
  • Umfragen NetworkIsPlayerTalking(PlayerId()); zeigt/blendet das Mikrofonsymbol ein mit:

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

  • In NUI existiert eine Hilfsfunktion zum Ändern von Proximity-Klassen (type = "changeMicro"), damit du es bei Bedarf in deine Sprachressource einbinden kannst.
• HUD ein-/ausblenden (benutzerdefiniert)
  • Auslösung von beliebiger Stelle clientseitig:

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

Installation

1. Lass den Ordner in deinem resources (z.B resources/[ui]/iHud-V2).
2. Sicherstellen der Ressource:

   ensure iHud-V2
   

3. Konfigurieren ESX-Zugriffsmethode, Statusereignisnameund Abschnitte umschalten in config.lua.
4. Bestätige, dass dein Status-Skript Emits sendet { name = "hunger"/"thirst", percent = <0-100> } Arrays zu Config.statusEventName.

Kompatibilität & Tipps

• ESX-Abruf
  • function Der Modus erwartet: ESX = exports[Config.extendedName]:getSharedObject()
  • event Der Modus erwartet: TriggerEvent(Config.eventNameESX, function(obj) ESX = obj end)
• Sprachnähe
  • Der HUD wird mit einem sprechenden Indikator geliefert. Um die Nähe (flüstern/normal/schreien) anzuzeigen, lasse deine Sprachressource eine NUI-Nachricht senden mit type="changeMicro" und deine gewählte CSS-Klasse.
• Styling
  • Schriftarten und Symbole werden von CDNs geladen; die Benutzeroberfläche ist responsiv und für RP-Server minimalistisch gehalten.