Personalizando o HUD e a Interface dos Scripts FiveM

A maioria dos scripts FiveM inclui elementos de interface como HUD, notificações e menus. Esta página explica como configurar a aparência e o comportamento visual, além de como integrar com sistemas de UI de terceiros que você já usa no servidor.

Configurações de Interface

As opções de UI ficam no config.lua de cada script:

config.lua

Config.UI = {
    -- Notificações
    NotificationSystem = 'default', -- 'default', 'okok', 'pNotify', 'ox_lib'
    NotificationPosition = 'top-right',
    NotificationDuration = 5000,    -- Duração em ms

    -- HUD
    ShowHUD = true,
    HUDPosition = 'bottom-left',    -- 'top-left', 'top-right', 'bottom-left', 'bottom-right'

    -- Menus
    MenuSystem = 'default',         -- 'default', 'ox_lib', 'qb-menu'
}

Sistemas de Notificação

Escolha o sistema de notificação compatível com o que você já usa:

Padrão
ox_lib
pNotify
okok Notify

O sistema padrão usa notificações nativas do FiveM. Nenhuma dependência adicional:

config.lua

Config.UI.NotificationSystem = 'default'

Para usar as notificações do ox_lib (requer ox_lib instalado):

config.lua

Config.UseOxLib = true
Config.UI.NotificationSystem = 'ox_lib'

Para integrar com o pNotify:

config.lua

Config.UI.NotificationSystem = 'pNotify'

Para usar o okokNotify:

config.lua

Config.UI.NotificationSystem = 'okok'

Posicionamento do HUD

Ajuste a posição dos elementos de HUD para evitar sobreposição com outros recursos:

config.lua

Config.UI.HUDPosition = 'bottom-left'
Config.UI.HUDOffset = { x = 20, y = 20 }  -- Offset em pixels a partir da borda

Se o HUD se sobrepõe a outro recurso, ajuste o HUDOffset ou altere o HUDPosition. As posições disponíveis são: top-left, top-right, bottom-left e bottom-right.

Desativando Elementos Visuais

Você pode desativar elementos específicos da interface:

config.lua

Config.UI = {
    ShowHUD = false,           -- Desativa completamente o HUD
    ShowProgressBar = true,    -- Mantém a barra de progresso
    ShowNotifications = true,  -- Mantém notificações
    ShowMarkers = false,       -- Remove marcadores no mapa
    ShowBlips = true,          -- Mantém blips no mapa
}

Compatibilidade com Frameworks de UI

Se você usa um pacote de UI completo (como lj-hud ou ps-hud), desative o HUD nativo do script com Config.UI.ShowHUD = false para evitar duplicação de informações na tela.

Configuração Geral

Veja todas as opções disponíveis no config.lua.

Solução de Problemas

Problemas com UI? Consulte o guia de troubleshooting.

Introdução

Guias

Scripts

Referência

Suporte

Personalizando o HUD e a Interface dos Scripts FiveM

Configurações de Interface

Sistemas de Notificação

Posicionamento do HUD

Desativando Elementos Visuais

Compatibilidade com Frameworks de UI

Configuração Geral

Solução de Problemas

​Configurações de Interface

​Sistemas de Notificação

​Posicionamento do HUD

​Desativando Elementos Visuais

​Compatibilidade com Frameworks de UI

Configuração Geral

Solução de Problemas

Configurações de Interface

Sistemas de Notificação

Posicionamento do HUD

Desativando Elementos Visuais

Compatibilidade com Frameworks de UI