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 sepas que funciona 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 otro servidor que sepas que funciona. Si también falla, sigue exactamente las indicaciones actuales de Cfx.re sobre problemas del cliente.
- 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 bloquear el proceso de entrada si espera indefinidamente un export, un resultado de la base de datos, un objeto del framework o un evento del cliente. Busca en el registro del servidor mensajes como «could not find dependency», errores de análisis y tiempos de espera agotados. Define explícitamente el orden de inicio con dependency en fxmanifest.lua o una secuencia correcta de ensure; no ocultes el fallo con pausas arbitrarias.
En un servidor de desarrollo, refresh vuelve a examinar los manifiestos y ensure resource-name inicia o reinicia un recurso. Estos comandos se definen en la referencia oficial de comandos del servidor. Evita reiniciar una dependencia de producción sin saber qué sesiones activas la utilizan.
Fallos de la pantalla de carga personalizada
Si el juego está listo pero una pantalla personalizada nunca 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 valores de seguridad
sv_*no documentados de una guía sobre otro error. - 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.