mri_Qhud — Manual

HUD completo para QBox: status do jogador, painel do veículo, bússola com nomes de rua, minimapa quadrado, sistema de stress e menu de personalização por jogador.

Sumário

1. Dependências
2. Instalação
3. Permissões (ACE)
4. Configuração
5. Comandos
6. Menu do HUD
7. Sistema de stress
8. Minimapa quadrado
9. Integrações
10. Entrypoints para outros recursos
11. Localização
12. Estrutura de arquivos

Dependências

O HUD não escreve no banco diretamente, mas depende de Player.Functions.SetMetaData('stress', ...) do qbx_core para persistir o stress.

Instalação

1. Copie a pasta mri_Qhud para resources/.
2. Adicione ao server.cfg:

   ensure mri_Qhud
3. Remova ou desabilite o qb-hud / ps-hud — os dois registram os mesmos eventos (hud:client:UpdateNeeds, hud:client:UpdateStress, hud:client:ShowAccounts, hud:client:OnMoneyChange) e o mesmo comando /resethud, e não podem rodar juntos.
4. Não há SQL a importar.

Permissões (ACE)

Apenas o comando /dev é restrito.

add_ace group.admin command.dev allow

Configuração

Arquivo config.lua.

As rotinas de ganho de stress por velocidade e por disparo estão comentadas no client.lua desta versão. Config.StressChance, Config.MinimumSpeed, Config.MinimumSpeedUnbuckled e Config.WhitelistedWeaponStress só voltam a ter efeito se esses blocos forem reativados; o stress continua chegando normalmente de outros recursos que disparem hud:server:GainStress.

Comandos

Menu do HUD

Aberto com /menu ou a tecla configurada. Cada toggle é salvo no KVP local hudSettings e recarregado no login e no start do recurso — as preferências são de cada jogador, não do servidor. O reset volta tudo para os valores de Config.Menu, buscados do servidor pelo callback hud:server:getMenu.

O anel de oxigênio mostra a estamina de corrida em terra e o ar restante debaixo d’água.

Sistema de stress

O stress fica no metadata stress do personagem (qbx_core), de 0 a 100.

• Outros recursos aumentam ou reduzem o valor com os eventos hud:server:GainStress e hud:server:RelieveStress.
• Config.DisableStress = true bloqueia todo ganho; Config.DisablePoliceStress = true isenta jobs do tipo leo.
• Acima de Config.MinimumStress, a tela borra periodicamente. A intensidade do blur vem de Config.Intensity.blur e o intervalo entre os episódios vem de Config.EffectInterval — ambos escalonados por faixa de stress.
• Com stress em 100, além do blur o personagem cai em ragdoll e a tela pisca em fade de 2 a 4 vezes.

Minimapa quadrado

O recurso substitui as texturas nativas do radar (dicionário squaremap), reposiciona o minimapa e corrige o offset em monitores mais largos que 16:9. O carregamento acontece no login e sempre que as configurações são recarregadas, pelo evento hud:client:LoadMap. O scaleform vem de stream/minimap.gfx.

O blip do norte é ocultado e o zoom do radar é fixado em 1000.

Integrações

ps-buffs

Se o recurso indicado em Config.Buffs (padrão ps-buffs) estiver iniciado, o HUD chama exports[Config.Buffs]:GetBuffNUIData() no login e ao resetar o HUD, e exibe os buffs ativos. Atualizações em runtime chegam pelos eventos hud:client:BuffEffect e hud:client:EnhancementEffect.

interact-sound

Todos os sons (abrir/fechar menu, reset, clique nos toggles, alerta de combustível) passam por TriggerServerEvent("InteractSound_SV:PlayOnSource", ...). Sem o recurso, os toggles de som do menu não têm efeito prático.

Cinto e piloto automático

O HUD apenas escuta seatbelt:client:ToggleSeatbelt e seatbelt:client:ToggleCruise — quem controla o cinto e o cruise control é outro recurso (tipicamente o smallresources). O status do arnês é lido do statebag LocalPlayer.state.seatbelt.

Nitro

Além do evento hud:client:UpdateNitrous, o HUD acompanha os statebags de entidade nitro e nitroFlames do veículo, comparando a placa para ignorar veículos de outros jogadores.

Voz e rádio

Os indicadores de voz e rádio leem LocalPlayer.state.proximity.distance e LocalPlayer.state.radioChannel, preenchidos pelo recurso de voz/rádio do servidor.

Entrypoints para outros recursos

O recurso não expõe exports. A superfície pública são eventos.

Stress

-- do client de outro recurso
TriggerServerEvent('hud:server:GainStress', 5)
TriggerServerEvent('hud:server:RelieveStress', 10)

Status do jogador e do veículo

-- servidor -> client
TriggerClientEvent('hud:client:UpdateNeeds', src, hunger, thirst)  -- 0 a 100
TriggerClientEvent('hud:client:UpdateStress', src, stress)         -- 0 a 100
TriggerClientEvent('hud:client:EngineHealth', src, engineHealth)
TriggerClientEvent('hud:client:UpdateNitrous', src, hasNitro, nitroLevel, isActive)
TriggerClientEvent('hud:client:UpdateHarness', src, harnessHp)

Dinheiro

-- mostra o saldo na tela: type = 'cash' | 'bank'
TriggerClientEvent('hud:client:ShowAccounts', src, 'cash', amount)
 
-- animação de ganho/perda: isMinus = true para saída
TriggerClientEvent('hud:client:OnMoneyChange', src, 'cash', amount, isMinus)

Toggles do HUD

TriggerEvent('hud:client:ToggleAirHud')        -- altímetro (helicóptero/avião)
TriggerEvent('hud:client:ToggleShowSeatbelt')  -- indicador de cinto
TriggerEvent('hud:client:LoadMap')             -- recarrega o minimapa quadrado
TriggerEvent('hud:client:resetStorage')        -- volta as configurações para o padrão do servidor

Buffs

TriggerClientEvent('hud:client:BuffEffect', src, {
    buffName = 'strength',
    display = true,
    iconName = 'dumbbell',
    iconColor = '#00E699',
    progressValue = 80,
    progressColor = '#00E699',
})
 
TriggerClientEvent('hud:client:EnhancementEffect', src, {
    enhancementName = 'nightvision',
    display = true,
    iconColor = '#00E699',
})

Callback

-- retorna a tabela Config.Menu (valores padrão dos toggles)
local defaults = lib.callback.await('hud:server:getMenu', false)

Localização

As notificações são traduzidas via ox_lib locale. Os arquivos usados são os locales/*.json declarados no fxmanifest:

ar, cs, da, de, en, es, fa, fi, fr, pt-br

O locale ativo é definido pela convar ox:locale no server.cfg:

setr ox:locale "pt-br"

Os arquivos .lua em locales/ são do sistema de tradução antigo (qb-core) e não são carregados pelo fxmanifest atual.

Estrutura de arquivos

mri_Qhud/
├── client.lua              — loops de HUD, veículo e bússola, menu NUI, stress, minimapa, KVP das configurações
├── server.lua              — comandos /cash, /bank, /dev, eventos de stress e callback hud:server:getMenu
├── config.lua              — todas as opções (stress, velocidade, blacklists, padrões do menu)
├── html/
│   ├── index.html          — markup do HUD e do menu
│   ├── app.js              — lógica da NUI (status, veículo, bússola, dinheiro, buffs)
│   ├── styles.css          — estilos do HUD (contém o texto da unidade de velocidade)
│   ├── responsive.css      — ajustes por resolução
│   └── fa/                 — Font Awesome (ícones do HUD)
├── locales/
│   ├── *.json              — 10 idiomas usados via ox_lib locale
│   └── *.lua               — traduções legadas (não carregadas)
├── img/logo.png            — logo exibida no menu
├── stream/minimap.gfx      — scaleform do minimapa quadrado
└── fxmanifest.lua