Menú de ajustes en juego (/hud)

PSTUDIOS-HUD incluye un panel de ajustes en el juego. Escribe /hud en el chat para abrirlo; escribe /hud otra vez (o pulsa Cerrar) para cerrarlo. Mientras el panel está abierto toma el foco de ratón y teclado.

Cómo abrirlo

El menú está asociado al comando /hud. También se registra un mapeo de tecla para que cada jugador asigne la suya en FiveM > Ajustes > Asignación de teclas, en la entrada "PSTUDIOS-HUD: abrir ajustes". Por defecto no hay ninguna tecla asignada a este menú; el jugador debe configurarla. Consulta Controles por defecto y asignación de teclas para la lista completa de teclas.

RegisterCommand('hud', function()
    if menuOpen then closeMenu() else openMenu() end
end, false)
-- Tecla opcional (sin asignar por defecto; el jugador la asigna en Ajustes).
RegisterKeyMapping('hud', _U('key_menu'), 'keyboard', '')

Qué puedes cambiar

Visibilidad

• Brújula — mostrar u ocultar la brújula.
• GPS / Ruta — mostrar u ocultar el módulo de GPS/ruta.
• Estado — mostrar u ocultar los anillos de estado (vida/armadura/hambre/sed/oxígeno).
• Minimapa a pie — mostrar u ocultar el minimapa del juego a pie.
• Minimapa en vehículo — mostrar u ocultar el minimapa del juego conduciendo.

Aspecto

• Posición — esquina del cluster de vehículo: Izquierda (bl) o Derecha (br).
• Escala — escala global del HUD.
• Opacidad — opacidad global del HUD.
• Daltónico — cambiar a la paleta alternativa para daltonismo.
• Mover estado — arrastrar los anillos de estado a una posición personalizada (ver la página Anillos de estado movibles).

Se guarda por jugador

Cada cambio se aplica en caliente y se escribe en el KVP del recurso del jugador bajo la clave pshud:settings, así que sobrevive a reconexiones y reinicios del recurso. Al cargar el recurso, loadSettings() corre antes de enviar la config a la NUI, de modo que el HUD arranca ya con las preferencias guardadas aplicadas.

local KVP = 'pshud:settings'

local function saveSettings()
    SetResourceKvp(KVP, json.encode(currentSettings()))
end

RegisterNUICallback('hud:set', function(data, cb)
    if data and data.key ~= nil then
        applySetting(data.key, data.value)
        saveSettings()
    end
    cb('ok')
end)