FiveM atrapado en la pantalla de carga: causas y cómo depurar

Los jugadores se conectan, la barra se llena, y luego nada: la pantalla de carga permanece arriba para siempre, o el juego se congela en una pantalla negra. Esta guía va a través de las causas en el orden que es más rápido descartar, y muestra cómo usar F8 y la consola del servidor para encontrar la que tienes.

#Primero: ¿es para todos o para un jugador?

• Todos están atrapados. La causa está en el servidor: un recurso, el framework, o una pantalla de carga.
• Un jugador está atrapado. Mira el cliente de ese jugador: caché, una conexión lenta, mods, o una compilación de juego antigua. Comienza con limpiar la caché de FiveM.

Únete una vez tú mismo y presiona F8. Esto funciona en la pantalla de carga también. Lee lo que se imprime allí, y mantén la consola del servidor abierta al otro lado.

#1. Un error de script en el cliente

F8 lista errores de cliente. Cualquier línea como esta durante la carga es una fuerte pista:

SCRIPT ERROR: @my_script/client/main.lua:25: attempt to index a nil value (global 'ESX')

Un script de cliente que falla en su thread de inicio puede dejar el flujo de aparición sin terminar. Arregla el script nombrado en el error: las guías para leer un error de script, ESX nil y QBCore nil cubren los comunes. Luego reinicia el recurso y vuelve a unirte.

Prueba por eliminación si nada se imprime: detén el recurso más recientemente añadido o cambiado, vuelve a unirte, y ve si la carga termina.

#2. Nadie hace aparecer al jugador

Después de cargar, algo debe hacer aparecer al jugador y apagar la pantalla de carga. Normalmente:

• spawnmanager lo hace en un servidor simple.
• Los multicharacter y selectores de spawn de un framework lo hacen en ESX y QBCore.

Comprueba que estos recursos se inician, en el orden correcto, y que solo uno de ellos maneja la aparición. Un conflicto típico es un spawnmanager predeterminado que hace aparecer automáticamente al jugador mientras un recurso multicharacter también quiere hacerlo. Asegúrate de que los recursos base se inician antes del framework, como en el orden de ensure correcto:

ensure oxmysql
ensure ox_lib
ensure es_extended        # or qb-core / qbx_core
ensure spawnmanager
ensure esx_multicharacter # or qb-multicharacter / qbx_core's own

Si un recurso multicharacter se detiene, busca en la consola del servidor un error de base de datos de él: la carga de personajes lee la base de datos, y un fallo SQL deja al jugador esperando. Consulta error de conexión de oxmysql y la tabla SQL no existe.

#3. Una pantalla de carga personalizada que nunca se cierra

Las pantallas de carga del servidor son recursos declarados en su manifiesto:

fx_version 'cerulean'
game 'gta5'

loadscreen 'html/index.html'
loadscreen_manual_shutdown 'yes'

files { 'html/**/*' }

Con loadscreen_manual_shutdown 'yes', FiveM no cierra la pantalla de carga por sí solo. Un script de cliente tiene que hacerlo, llamando a los nativos de apagado una vez que el jugador esté listo:

ShutdownLoadingScreen()
ShutdownLoadingScreenNui()

Si un recurso de pantalla de carga tiene la opción de apagado manual y nadie llama a estos, la pantalla permanece arriba para siempre. O elimina loadscreen_manual_shutdown, o asegúrate de que tu flujo de aparición los llame. Prueba deteniendo el recurso de pantalla de carga y volviendo a unirte.

Una pantalla de carga que está rota, que carga un archivo externo que es inalcanzable, o que toca un video muy grande también puede bloquear o ralentizar la pantalla. Mantenla ligera y local.

#4. Streaming grande y descargas

Unirse descarga todos los archivos transmitidos que el jugador aún no tiene. Un servidor con muchos vehículos grandes, mapas y paquetes de ropa puede tomar minutos en la primera conexión, y la pantalla de carga no muestra nada sucediendo si la descarga es lenta. Señales:

• F8 o la pantalla de carga muestran descargas en progreso.
• Funciona para jugadores que regresan pero no para nuevos.
• El problema empeora después de que añades un paquete de activos.

Soluciones: reduce el tamaño y la cantidad de activos transmitidos (consulta activos de gran tamaño), aloja el servidor en una conexión con suficiente ancho de banda, y pide a los jugadores que esperen a que termine la primera descarga.

#5. Problemas de compilación del juego o versión del servidor

Si el servidor fuerza una compilación del juego, un jugador en una compilación más antigua o diferente puede fallar en unirse limpiamente. Comprueba sv_enforceGameBuild en server.cfg contra el DLC que tus activos necesitan. Consulta sv_enforceGameBuild. Un artefacto de servidor obsoleto también puede causar uniones extrañas: actualiza tus artefactos.

#6. El framework no carga el personaje

Los jugadores aparecen, pero el framework nunca termina de cargar al jugador. En la consola del servidor busca:

• un error de base de datos mientras se carga el jugador o personaje
• un error de es_extended, qb-core o qbx_core en el evento player-loaded
• un script que enganche ese evento y lance, deteniendo otros manejadores

Si ves un error allí, arréglalo, y vuelve a unirte. Un inventario roto o un script de trabajo roto también pueden fallar dentro del flujo de player-loaded, así que verifica los más recientemente añadidos primero.

#Una rutina de depuración

1. Únete y presiona F8. Anota cada error.
2. Lee la consola del servidor durante la unión.
3. Detén el recurso más recientemente cambiado, vuelve a unirte.
4. Detén el recurso de pantalla de carga, vuelve a unirte.
5. Aún atrapado para todos: comienza con solo los recursos base y añade el resto de vuelta en grupos.

Consejo: si añades recursos en grupos de cinco o diez, encuentras el malo con pocos reinicios en lugar de probar 80 recursos uno por uno.

#Lista de verificación