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
- 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.
- 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.
- 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.
- Ú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.