Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría son de configuración, no fallos, y con Config.Debug = true las consolas del servidor y F8 indican lo que hace el recurso en cada paso.
Instalación y acceso#
Sigue apareciendo la pantalla de carga predeterminada de FiveM
El recurso no está iniciado. Comprueba que ensure qs-loadingscreen esté en server.cfg, que la carpeta se llame exactamente qs-loadingscreen y que la consola del servidor no muestre ningún error suyo al iniciar. Otro recurso que declare una pantalla de carga también ocupa su lugar: elimínalo.
"You are not allowed to open the loading screen creator"
Ninguna de las dos vías coincidió. Comprueba la línea ACE (add_ace group.admin command.loadingcreator allow) y que tu identificador esté en ese grupo, o que tu grupo del framework esté en Config.Creator.adminGroups.
La respuesta se recuerda durante la sesión: después de corregirlo, reconéctate antes de volver a intentarlo.
"The creator UI is not ready yet"
La interfaz no había terminado de cargar cuando se ejecutó el comando, algo habitual en los primeros segundos tras conectarse. Espera un momento y vuelve a ejecutar /loadingcreator. Si nunca se abre, busca en la consola F8 un error de qs-loadingscreen: el creador libera el ratón por sí solo cuando su ventana no llega a aparecer.
La pantalla de carga en el juego#
La pantalla sigue visible mucho después de que el mundo haya cargado
Nada la cerró, así que esperó al límite de seguridad: Config.MaxDuration (45 s) después de que aparezca el jugador, o Config.MaxDurationHandoff (3 min) mientras Multicharacter está en ejecución. La consola del cliente muestra loading screen safety timeout (… ms), forcing close cuando ocurre.
Haz que tu script de multicharacter o de spawn llame a exports['qs-loadingscreen']:CloseLoadingScreen() cuando esté listo, o reduce el límite. Consulta Integraciones.
El jugador ve el mundo vacío antes de la selección de personaje
El límite se agotó antes de que la siguiente pantalla estuviera lista; normalmente, un PC lento con un multicharacter que no está en Config.HandoffResources. Añade tu multicharacter a esa lista para que reciba el límite de tres minutos, y asegúrate de que cierre la pantalla por sí mismo.
Los jugadores ven el tema predeterminado en lugar del mío
El tema está guardado pero no activo. Pulsa Set live: la lista de temas muestra una insignia Live en el que reciben los jugadores.
Si ya lo está, lee la consola del servidor al iniciar. data/themes.json is corrupt, starting from scratch significa que el archivo se editó a mano y quedó como JSON no válido: restáuralo desde una copia de seguridad antes de guardar nada, o el siguiente guardado lo reemplazará.
El fondo de vídeo se ve negro
El clip es un .mp4. El navegador de FiveM no puede reproducir H.264, así que conviértelo a WebM (VP9) y colócalo en videos/. El creador marca los archivos .mp4 como will not play.
El vídeo no se mueve para algunos jugadores
Es el comportamiento correcto. Los PC con cuatro núcleos de CPU o menos, o con 4 GB de memoria o menos, reciben el clip detenido en su primer fotograma para que el juego cargue más rápido. Consulta Rendimiento en PC lentos.
No hay música
Comprueba que la banda sonora esté activada y tenga pistas, y que cada pista apunte a un archivo que todavía exista en song/. Después, comprueba que el jugador no la haya silenciado: el Sound toggle se recuerda entre conexiones, así que un jugador que la silenció una vez la mantiene silenciada hasta que lo vuelva a pulsar.
El nombre del servidor o el número de jugadores es incorrecto
El nombre viene de sv_hostname sin sus códigos de color, salvo que la pestaña Settings del tema lo sobrescriba. Los jugadores en línea y las plazas vienen del servidor (las plazas, de sv_maxclients) y se actualizan cada diez segundos.
El creador y los medios#
Mis archivos no aparecen en los desplegables
Las carpetas se leen cuando se inicia el recurso: ejecuta restart qs-loadingscreen después de añadir archivos. Después, comprueba:
Que la extensión sea una de las que sirve el recurso:
song/mp3, ogg, wav, m4a ·videos/webm, mp4 ·images/png, jpg, jpeg, webp, gif.Que la carpeta
images/exista: no viene con el recurso.Que la consola del servidor no diga
could not read song/ (io.readdir is missing…). Si lo dice, los artifacts de tu servidor son demasiado antiguos para listar carpetas: actualízalos.
"Could not save the theme"
El servidor lo rechazó. Los motivos habituales: ya hay 50 temas guardados (limit_reached: elimina uno o aumenta Config.MaxThemes), el tema supera los 512 KB (too_large) o el servidor no puede escribir data/themes.json (write_failed: un archivo o host de solo lectura). La lista completa está en Códigos de error, más abajo.
Un tema importado muestra entradas "external URL"
El código apunta a archivos que no están en este servidor. Copia los mismos archivos en song/, videos/ o images/ y reinicia el recurso, o elige un reemplazo en cada desplegable.
"That code is not a valid theme"
El código se cortó o se modificó por el camino. Los códigos empiezan por QSLS1: y son una sola línea larga: vuelve a copiar todo el cuadro con Ctrl + A, Ctrl + C y evita las apps que acortan los mensajes largos.
Delete no funciona en un tema integrado
Es el comportamiento correcto. Un tema integrado que nunca has guardado vive dentro de la interfaz y no se puede eliminar. Una vez que guardas cambios en uno, Delete elimina tu versión y recupera el original.
Códigos de error#
Guardar, eliminar y activar un tema responden con uno de estos cuando fallan:
Código | Significado |
|---|---|
| El jugador no es administrador por ACE ni por grupo. |
| El tema llegó al servidor mal formado; normalmente, una importación dañada. |
| El tema supera los 512 KB una vez codificado. Recorta listas largas o módulos sin usar. |
|
|
| El servidor no pudo escribir |
| Eliminar un tema que no está guardado en el servidor: uno integrado que nunca cambiaste. |
| El servidor no respondió en 15 segundos. |
¿Sigues atascado? Abre un ticket e incluye la consola de tu servidor con
Config.Debug = true, la consola F8 de un jugador que se conecte, tu framework y el multicharacter o selector de spawn que usas.