Instalación

1. Dependencias

Todos estos recursos son obligatorios y deben arrancar antes que FR Intro:

Recurso	Estado	Para qué
spawnmanager	Obligatorio	Recurso stock de FiveM (cfx-server-data). FR Intro lo desactiva en runtime, pero debe estar presente y arrancado.
oxmysql	Obligatorio	Persistencia de personajes. La tabla fiverank_intro_characters se crea sola en el primer arranque.
MySQL / MariaDB	Obligatorio	Configurado con set mysql_connection_string antes de ensure oxmysql.
ESX / QBCore / qbx_core	Opcional	Si lo tienes, FR Intro lo detecta automáticamente. Si no, funciona en modo standalone.

2. Copia el recurso

Mueve la carpeta fiverank_intro/ a resources/[fiverank]/ (o donde organices tus scripts).

resources/
└── [fiverank]/
    └── fiverank_intro/
        ├── fxmanifest.lua
        ├── config.lua
        ├── client/
        ├── server/
        ├── shared/
        ├── loadingscreen/
        └── ui/

3. Añade al server.cfg

⚠️ Importante: FR Intro debe arrancar antes que tu framework (ESX/QBCore/qbx) para que pueda interceptar el spawn del jugador.

# Dependencias
ensure spawnmanager
ensure oxmysql

# FR Intro PRIMERO
ensure fiverank_intro

# Después tu framework
ensure es_extended
# o
ensure qb-core
# o
ensure qbx_core

4. Reinicia el servidor

La tabla fiverank_intro_characters se crea sola en el primer arranque. No necesitas ejecutar ningún SQL a mano.

# En la consola del servidor:
restart fiverank_intro

5. Verifica

Conéctate al servidor. Deberías ver:

• ✅ El loadingscreen con la barra de progreso animada
• ✅ El menú principal con el botón "JUGAR"
• ✅ Al pulsar JUGAR, los 5 slots vacíos de personaje

Si algo falla, consulta Solución de problemas.

Estructura de archivos

fiverank_intro/
├── fxmanifest.lua                 # Manifiesto del recurso
├── config.lua                     # ⚙️ TODA la configuración
├── README.md
├── shared/
│   ├── framework.lua              # Auto-detección ESX/QB/qbx
│   └── utils.lua
├── server/
│   ├── database.lua               # Schema MySQL auto-creado
│   └── main.lua                   # CRUD personajes + handshake
├── client/
│   ├── main.lua                   # Orquestador
│   ├── camera.lua                 # Primitivas de cámara
│   ├── charselect.lua             # Preview ped + escena
│   └── cinematic.lua              # Descenso desde el cielo
├── loadingscreen/
│   ├── index.html                 # Página de carga
│   ├── style.css
│   └── script.js
└── ui/
    ├── index.html                 # Menú + char select NUI
    ├── style.css
    ├── script.js
    └── assets/                    # Tus imágenes / música
        ├── logo.png
        └── music/

Siguiente paso

➡️ Configuración