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
• Main-Client-Logik: 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,

  -- Wie man ESX bekommt:
  ESX_method   = function,         -- function (export) oder event
  eventNameESX = esx:getSharedObject,
  extendedName = extended,         -- z.B. es_extended / extended
  VERSION_ESX  = final,            -- legacy oder final (informativ)

  -- Statusquelle (Liste von {name, percent}):
  statusEventName = esx_customui:updateStatus,

  ACTIVED = {
    BERUF         = true,
    JOB2        = true,
    GELD        = true,
    SCHWARZES_GELD = true,
    MICRO       = true
  }
}

Anmerkungen

• Wenn Sie eine alternative Statusaktualisierung verwenden (z.B. sigma_hud:onTick), hört der Client auf Config.statusEventName oder fällt zurück auf sigma_hud:onTick.

Client-Events & Datenfluss

• Initialisierung
  • esx:playerLoaded → HUD initialisiert mit ESX-Spielerdaten.
  • Bei der Initialisierung wird das HUD angezeigt und NUI erhält:

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

• Statusaktualisierungen (Hunger/Durst)
  • Hört auf Config.statusEventName (Standard esx_customui:updateStatus) und sendet eine Liste wie folgt:

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

  • HUD kartiert diese auf die beiden Statusleisten.
• Beruf / Zweiter Beruf
  • esx:setJob und esx:setJob2 werden automatisch bearbeitet. NUI erhält:

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

• Geld
  • esx:setAccountMoney aktualisiert Bargeld und Schwarzgeld:

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

• Stimme (Sprechindikator)
  • Abfragen von NetworkIsPlayerTalking(PlayerId()); zeigt das Mikrofon-Symbol mit:

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

  • Ein Helfer zum Ändern von Proximity-Klassen existiert in NUI (type = changeMicro), damit Sie ihn in Ihre Voice-Ressource einhaken können, wenn gewünscht.
• Anzeigen/Ausblenden des HUD (benutzerdefiniert)
  • Auslösen von überall auf dem Client:

  TriggerEvent(iHud-V2::show, true)  -- anzeigen
  TriggerEvent(iHud-V2::show, false) -- ausblenden

Installation

1. Legen Sie den Ordner in Ihren ressourcen-Ordner (z.B. ressourcen/[ui]/iHud-V2).
2. Stellen Sie sicher, dass die Ressource:

ensure iHud-V2

3. Konfigurieren Sie ESX-Zugriffsverfahren, Statusereignisname und aktivieren Sie Abschnitte in config.lua.
4. Stellen Sie sicher, dass Ihr Status-Skript Arrays mit { name = hunger/thirst, percent = <0-100> } an Config.statusEventName sendet.

Kompatibilität & Tipps

• ESX-Abruf
  • function-Modus erwartet: ESX = exports[Config.extendedName]:getSharedObject()
  • event-Modus erwartet: TriggerEvent(Config.eventNameESX, function(obj) ESX = obj end)
• Stimmproximität
  • Das HUD enthält einen Sprechindikator aus der Box. Um Proximitätsstufen (flüstern/normale/laut) anzuzeigen, senden Sie eine NUI-Nachricht mit type=changeMicro und Ihrer gewünschten CSS-Klasse.
• Styling
  • Schriften & Symbole werden von CDNs geladen; die UI ist responsiv und minimalistisch für RP-Server gehalten.

Verwandte FiveM-HUDs

• izzy HUD V2
• Trygon HUD
• Trygon HUD v2
• ESX Moveable Premium HUD