Cuando FiveM se queda en una pantalla de carga, primero determina si el fallo afecta a un cliente, a un servidor o a todos los jugadores después de un cambio de recurso. Conserva el texto exacto de la pantalla y el error de la consola, prueba con un servidor que funcione conocido y cambia una causa reversible a la vez. No empieces con convars de seguridad no documentados ni con una eliminación general de datos de la aplicación y del servidor.
Clasifica el fallo antes de cambiar archivos
| Alcance observado | Empieza aquí |
|---|---|
| Un jugador, múltiples servidores | Proceso del cliente, problema del cliente oficial, instalación de GTA/FiveM y diagnóstico de caché local. |
| Un jugador, un servidor | Error F8, ruta de conexión y el primer recurso o descarga que falla para ese cliente. |
| Todos los jugadores en un servidor | Consola FXServer/txAdmin, despliegue reciente, inicio de recursos y estado de la base de datos/dependencias. |
| Solo después de un cambio en la pantalla de carga personalizada | Manifiesto de la pantalla de carga, consola del navegador y ciclo de vida de apagado manual. |
Comprobaciones del lado del jugador
- Registra el servidor exacto, la hora, el texto de carga y cualquier error visible.
- Pulsa F8 y captura el primer error relevante en lugar de las líneas repetidas que le siguen. Cfx.re documenta F8 en su referencia de la consola del cliente.
- Prueba con otro servidor que funcione. Si eso también falla, sigue la guía de problemas del cliente de Cfx.re.
- Reinicia FiveM y Windows una vez para liberar los procesos bloqueados.
- Si la evidencia apunta a activos del servidor cacheados, usa el procedimiento reversible en la guía de caché de FiveM. No elimines todo el directorio de datos de la aplicación.
Comprobaciones del propietario del servidor
- Congela las implementaciones y exporta el registro relevante de FXServer/txAdmin en torno a una conexión fallida.
- Comprueba si el problema comenzó inmediatamente después de un cambio en un recurso, artefacto, configuración o base de datos.
- Utiliza la Consola en Vivo y los controles de recursos de txAdmin para identificar la primera dependencia fallida. txAdmin se incluye con FXServer y sus funciones de monitoreo actuales se documentan en la guía oficial de txAdmin.
- Verifica los servicios requeridos y el acceso a la base de datos sin imprimir credenciales.
- Revierte el último cambio que hiciste o desactiva solo el recurso aislado en una instancia de desarrollo.
Comprueba el inicio de recursos y las dependencias
Un recurso puede detener la incorporación cuando espera indefinidamente una exportación, un resultado de base de datos, un objeto de framework o un evento de cliente. Revisa el registro del servidor en busca de «no se pudo encontrar la dependencia», errores de análisis y tiempos de espera. Haz que el orden de inicio sea explícito con dependency en fxmanifest.lua o una secuencia correcta; ensure no ocultes el fallo con esperas arbitrarias.
En un servidor de desarrollo, refresh vuelve a escanear los manifiestos y ensure resource-name inicia o reinicia un recurso. Estos comandos se definen en la referencia de comandos del servidoroficial. Evita reiniciar una dependencia de producción sin comprender qué sesiones activas la utilizan.
Fallos de la pantalla de carga personalizada
Si el juego está listo pero una pantalla personalizada no se cierra, comprueba si el recurso utiliza loadscreen_manual_shutdown 'yes'. Este modo requiere que un script de cliente llame a ShutdownLoadingScreenNui() cuando se cumpla una condición real de disponibilidad. Elimina la directiva de cierre manual para recuperar el comportamiento automático durante la depuración. El ciclo de vida compatible y los eventos de progreso se documentan en la guía de pantalla de carga de Cfx.re.
Evita las correcciones genéricas inseguras
- No copies
sv_*valores de seguridad no documentados de una guía de errores no relacionada. - No desactives la protección antivirus o de firewall de forma permanente.
- No elimines una base de datos activa, el directorio de datos de txAdmin o una instalación completa de FiveM antes de guardar una copia de seguridad.
- No añadas reintentos de cliente repetidos que otorguen objetos, dinero o permisos más de una vez.
- No llames a un tiempo de espera de carga más largo una solución cuando el recurso subyacente sigue fallando.
Verifica la reparación
Repite la misma conexión en el cliente afectado, un segundo cliente limpio y después de un reinicio completo del servidor. Confirma que el primer error de consola ha desaparecido, el jugador alcanza un estado utilizable, los recursos requeridos se iniciaron una vez y no ocurrieron acciones duplicadas de derechos o inventario. Mantén el rollback hasta que el resultado sobreviva al reinicio.