iHUD v2

Descrição

Arquivos e manifesto

• fxmanifest.lua
  • ui_page "NUI/index.html"
  • Carrega CSS/JS/recursos de NUI/src/*
  • script_compartilhado "config.lua"
  • script_cliente "cliente/*.lua"
• Lógica principal do cliente: cliente/principal.lua
• Configuração: configuração.lua
• NUI: NUI/index.html, NUI/src/css/*, NUI/src/js/{config.js,index.js,events.js}, NUI/src/images/micro.png

Configuração (config.lua)

Config = { DEBUG = false, -- Como obter o ESX: ESX_method = "function", -- "function" (export) ou "event" eventNameESX = "esx:getSharedObject", extendedName = "extended", -- ex "es_extended" / "extended" VERSION_ESX = "final", -- "legacy" ou "final" (informativo) -- Origem do status (lista de {nome, porcentagem}): statusEventName = "esx_customui:updateStatus", ACTIVED = { JOB = true, JOB2 = true, MONEY = true, BLACK_MONEY = true, MICRO = true } }

Notas

• Se você usar uma marca de seleção de status alternativa (por exemplo, sigma_hud:onTick), o cliente escuta em Config.statusEventName ou volta a "sigma_hud:onTick".

Eventos do cliente e fluxo de dados

• Inicialização
  • esx:playerLoaded → O HUD é inicializado com os dados do player ESX.
  • Na inicialização, o HUD é exibido e a NUI recebe:

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

• Atualizações de status (Fome/Sede)
  • Ouça Config.statusEventName (padrão esx_customui:updateStatus) e emita uma lista como:

    TriggerEvent("esx_customui:updateStatus", { { name = "fome", percent = 48.0 }, { name = "sede", percent = 72.0 } })
    

  • O HUD mapeia esses elementos para as duas barras de status.
• Emprego / Segundo Emprego
  • esx:setJob e esx:setJob2 são tratados automaticamente. A NUI recebe:

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

• Dinheiro
  • esx:setAccountMoney Atualizações sobre dinheiro em espécie e dinheiro ilícito:

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

• Voz (Indicador de conversa)
  • Pesquisas NetworkIsPlayerTalking(PlayerId()); mostra/oculta o ícone do microfone com:

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

  • Existe uma função auxiliar para alterar as classes de proximidade no NUI (tipo = "changeMicro"), para que você possa integrá-lo ao seu recurso de voz, se desejar.
• Mostrar/Ocultar HUD (personalizado)
  • Acionar de qualquer lugar no lado do cliente:

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

Instalação

1. Solte a pasta em seu recursos (por exemplo recursos/[ui]/iHud-V2).
2. Garantir o recurso:

   garantir iHud-V2
   

3. Configurar método de acesso ESX, nome do evento de statuse alternar seções em configuração.lua.
4. Confirme se o seu script de status emite { nome = "fome"/"sede", percentual = <0-100> } matrizes para Config.statusEventName.

Compatibilidade e dicas

• recuperação ESX
  • função O modo espera: ESX = exports[Config.extendedName]:getSharedObject()
  • evento O modo espera: TriggerEvent(Config.eventNameESX, function(obj) ESX = obj end)
• Proximidade de voz
  • O HUD vem com um indicador de fala integrado. Para mostrar os níveis de proximidade (sussurro/normal/grito), configure seu recurso de voz para enviar uma mensagem NUI com tipo="alterarMicro" e a classe CSS escolhida.
• Estilização
  • Fontes e ícones carregados de CDNs; a interface do usuário é responsiva e mantida minimalista para servidores de RP.

Se desejar, posso adaptar o texto acima ao nome exato do seu servidor e incluir um breve bloco de "Requisitos/Dependências do Servidor" (por exemplo, os nomes dos seus recursos de status/voz) ou adicionar capturas de tela.