Skip to main content

Solución de problemas

El loadingscreen no aparece​

Causa habitual: otro recurso ya define un loadscreen y se está sobrescribiendo.

Solución:

  • Asegúrate de no tener otro recurso con loadscreen en su fxmanifest.lua.
  • Si tienes loadscreen-extras o similar, deshabilítalo.
  • Confirma que fiverank_intro se ejecuta antes que el framework.

El menú no aparece después del loadingscreen​

Posibles causas:

  1. spawnmanager no está iniciado → el cliente se cuelga porque no puede llamar a exports.spawnmanager.

    ensure spawnmanager

  2. La NUI no se inyectó. Revisa la consola del cliente (F8):

    [fiverank_intro] Framework detected: ...

    Si no aparece, el resource no arrancó. Mira restart fiverank_intro y la consola del servidor.

  3. Caché de NUI corrupta. Borra la carpeta cache/ del cliente de FiveM y vuelve a conectar.

Los personajes no se guardan​

Causa habitual: oxmysql no está conectado a la base de datos.

Solución:

  • Verifica que oxmysql arranque correctamente (mira la consola del server al iniciar).
  • Confirma tu set mysql_connection_string en server.cfg.
  • Comprueba que la tabla existe: 
    SHOW TABLES LIKE 'fiverank_intro_characters';
    Si no existe, activa Config.Debug = true y reinicia. Deberías ver [fiverank_intro] schema OK.

El framework no se detecta correctamente​

Activa debug:

Config.Debug = true

Y mira la consola del cliente al conectar. Deberías ver:

[fiverank_intro] Framework detected: qb  (o esx, qbx, standalone)

Si detecta standalone pero estás usando un framework, fuérzalo:

Config.Framework = 'qb'   -- o 'esx', 'qbx'

La cámara cinemática se queda colgada en el cielo​

Causa habitual: el chunk del mapa no terminó de cargar y la entrega de control se cortó.

Solución:

  • Aumenta Config.Spawn.duration (más tiempo para cargar el LOD).
  • Revisa la consola del cliente por errores de "collision not loaded".
  • Si tienes mapas custom muy pesados, considera bajar skyHeight para acortar el descenso.

El jugador aparece debajo del suelo​

Causa: el defaultPoint está mal o las colisiones no cargaron.

Solución:

  • Verifica las coordenadas con /save en un punto seguro y conocido.
  • Asegúrate de que la Z es realista (no demasiado alta ni cero).
  • Si usas un MLO custom, espera a que el script de carga del MLO esté listo antes de meter al jugador.

No suena la música​

Causas:

  1. Política de autoplay del navegador NUI. Algunas builds de FiveM bloquean autoplay sin interacción. El audio empieza al primer click en el menú.
  2. Ruta incorrecta. Las rutas son relativas a ui/: 
    tracks = { 'assets/music/theme1.ogg' }  -- ✅
    tracks = { '/ui/assets/music/theme1.ogg' }  -- ❌
  3. Archivo no está en files {}. El wildcard del manifest cubre ui/assets/*, pero subcarpetas (music/) necesitan otra entrada: 
    files {
        'ui/assets/music/*.ogg',
        -- ...
    }

El contador de jugadores online dice "Servidor activo" en vez del número real​

Causa: la NUI no puede resolver el endpoint del servidor automáticamente.

Solución: especifica el endpoint público en config.lua:

Config.MainMenu.serverEndpoint = '123.45.67.89:30120'

O desactívalo:

Config.MainMenu.showLiveStats = false

Comportamiento esperado: FiveM muestra una confirmación in-game antes de abrir un link externo. El jugador debe aceptarla. Si lo rechaza, no pasa nada.

Si el botón no hace nada en absoluto:

  • Confirma que url no está vacío en Config.Social.
  • Mira la consola del cliente (F8) por errores de la NUI.

Conflictos con multichar de QBCore/ESX​

FR Intro desactiva el spawnmanager por defecto. Si tu framework tiene su propio sistema multichar (qb-multicharacter, esx_multicharacter):

Opción A — usa solo FR Intro: Quita el recurso multichar del framework del server.cfg.

Opción B — usa solo el del framework: Quita FR Intro.

Opción C — combinarlos: Edita selectCharacter en server/main.lua para que llame al Login() del framework con el citizenid correcto. Ver Flujo y eventos → Integración.

Sigo sin poder resolverlo​

  1. Activa Config.Debug = true.
  2. Reinicia el resource y reproduce el problema.
  3. Captura la consola del servidor y del cliente (F8).
  4. Abre un ticket en nuestro Discord con esos logs y la versión de tu framework.

➡️ Discord de FiveRank