Cómo instalar y probar un HUD de FiveM

Para instalar un HUD de FiveM, confirma su framework y dependencias, añade su carpeta de recursos, inícialo después de esas dependencias y prueba los valores mostrados con un jugador normal. Un HUD que aparece en pantalla todavía necesita una verificación de datos y usabilidad.

Verifica la compatibilidad y mantén una reversión

Lee la documentación del HUD para la versión de framework compatible, el inventario, el estado y los recursos de voz. Las integraciones de ESX, QBCore y Qbox no son intercambiables a menos que el creador las admita explícitamente. Haz una copia de seguridad del HUD actual, la configuración y cualquier tabla de la base de datos que la instalación cambie.

Prueba primero en un servidor separado. Deshabilita el HUD antiguo durante la prueba para evitar superposiciones duplicadas y lógicas de minimapa o estado en conflicto.

Instala el recurso

1. Extrae el paquete. La carpeta de recursos debe contener fxmanifest.lua en su raíz, en lugar de otra copia anidada de la carpeta. Preserva los nombres de las carpetas documentados.
2. Instala las dependencias requeridas y configura la integración del framework compatible con el HUD. Mantén los secretos fuera de los archivos del cliente y de la NUI.
3. Añade ensure seguido del nombre exacto de la carpeta de recursos a server.cfg después de sus dependencias. Inicia el servidor de prueba y lee el primer error del recurso antes de continuar.
4. Únete con una cuenta normal. Verifica los valores de salud, armadura, hambre/sed (donde sea compatible), dinero, trabajo y vehículo con el estado real del juego.

Verifica la interfaz

Prueba diferentes resoluciones y escalado de la interfaz de usuario, entrando y saliendo de vehículos, reconectando, cambios de personaje y un reinicio completo del servidor. Confirma que los menús sigan siendo clicables y que el texto importante sea legible sin depender solo del color. Inspecciona las consolas F8 y del servidor en busca de errores.

Encuentra la causa de un fallo

Sin interfaz: verifica el error de inicio del recurso, el manifiesto, las rutas de archivo NUI y los activos del navegador. Una interfaz con valores incorrectos apunta en cambio al framework o a la integración de estado. Los elementos superpuestos sugieren que otro HUD o recurso de minimapa sigue en ejecución.

Restaura el HUD y la configuración antiguos si el nuevo recurso falla estas comprobaciones. Restaura una copia de seguridad de la base de datos solo cuando su migración haya cambiado datos; coordina esto para que el progreso más reciente del jugador no se sobrescriba.

Referencias oficiales

El manifiesto de recursos explica las declaraciones de scripts y UI; comandos del servidor documenta ensure.