Configuración

Todo se configura desde config.lua. Reinicia el recurso (restart fiverank_intro) después de cualquier cambio.

General

Config.Locale        = 'es'                -- 'es' | 'en' | 'pt' | 'fr' | 'de'
Config.Debug         = false               -- Logs extra en consola
Config.ServerName    = 'FiveRank RP'
Config.ServerTagline = 'GTA RP Rankings — Bienvenido al ecosistema'

Framework

Config.Framework = 'auto'   -- 'auto' | 'esx' | 'qb' | 'qbx' | 'standalone'

• auto → detecta en orden: qbx_core → qb-core → es_extended → standalone.
• Fuerza un valor si tu setup es atípico.

Personajes

Config.MaxSlots      = 5       -- Slots por jugador (1–10 recomendado)
Config.AllowDelete   = true    -- Permitir borrar personajes
Config.DeleteConfirm = true    -- Pedir escribir el nombre completo para borrar

Escena de selección

La cámara orbita alrededor del ped en estas coordenadas. Por defecto, azotea de Vinewood Hills.

Config.PreviewScene = {
    pedCoords   = vector4(-1383.62, 458.34, 113.12, 211.7),
    camCoords   = vector3(-1382.27, 456.10, 114.20),
    camFov      = 35.0,
    orbitSpeed  = 6.0,         -- deg/s. 0 = cámara estática
    forceHour   = 19,
    forceMin    = 30,
    forceWeather= 'EXTRASUNNY',  -- nil para no tocar
}

Tip: para encontrar un buen sitio, en el juego ejecuta /save o usa cualquier coords menu.

Modelos por defecto

Config.DefaultMaleModel   = 'mp_m_freemode_01'
Config.DefaultFemaleModel = 'mp_f_freemode_01'

Spawn cinemático

Controla el descenso desde el cielo.

Config.Spawn = {
    defaultPoint    = vector4(-1037.7, -2737.8, 20.17, 327.3), -- LSIA por defecto
    enabled         = true,    -- false = fade-in simple, sin cinemática
    skyHeight       = 650.0,   -- altura inicial sobre el target
    skyOffset       = vector3(120.0, -180.0, 0.0), -- offset XY desde el target
    duration        = 7500,    -- ms de descenso
    fadeOutFinalMs  = 1200,    -- fundido final cuando se entrega el control
    showHud         = false,   -- HUD durante la cinemática
}

Ajustes recomendados

Estilo	skyHeight	duration	skyOffset
Clásico GTA (default)	650	7500	(120, -180, 0)
Rápido	400	4000	(80, -100, 0)
Épico largo	900	12000	(200, -300, 50)
Sin cinemática	enabled = false	—	—

Menú principal

Config.MainMenu = {
    background     = 'parallax',         -- 'image' | 'video' | 'parallax'
    backgroundFile = 'assets/bg.webp',
    backgroundMp4  = 'assets/bg.mp4',

    showLiveStats  = true,               -- Contador de jugadores online
    serverEndpoint = 'self',             -- 'self' o 'ip:port'

    showChangelog  = true,
    showCredits    = true,
    showSettings   = true,
}

Redes sociales

Aparecen en el menú principal y en el footer del loadingscreen.

Config.Social = {
    { id = 'discord',   label = 'Discord',   url = 'https://discord.gg/...' },
    { id = 'youtube',   label = 'YouTube',   url = 'https://youtube.com/@...' },
    { id = 'tiktok',    label = 'TikTok',    url = 'https://tiktok.com/@...' },
    { id = 'instagram', label = 'Instagram', url = 'https://instagram.com/...' },
    { id = 'twitter',   label = 'X',         url = 'https://x.com/...' },
    { id = 'website',   label = 'Web',       url = 'https://...' },
}

• Pon url = '' para ocultar una entrada sin borrarla.
• El orden del array se respeta.
• FiveM mostrará una confirmación al jugador antes de abrir links externos.

Música

Config.Music = {
    enabled = true,
    volume  = 0.35,                 -- 0.0 – 1.0
    tracks  = {
        'assets/music/theme1.ogg',
        'assets/music/theme2.ogg',
    },
    shuffle = true,
}

• Los archivos van en ui/assets/music/ y deben estar listados en files {} del fxmanifest.lua (ya cubierto con el wildcard).
• Formato recomendado: OGG (mejor compresión) o MP3.
• Tamaño recomendado: < 5 MB por pista.

Theme (paleta visual)

Los colores se inyectan como variables CSS al cargar la UI.

Config.Theme = {
    primary    = '#FFB627',   -- Oro GTA
    secondary  = '#E63946',   -- Crimson de acento
    accent     = '#7CD7E6',   -- Cyan suave
    background = '#0a0a0a',
    text       = '#f4f4f5',
    textMuted  = '#a1a1aa',
    logoUrl    = 'assets/logo.png',
}

Presets sugeridos

Cyberpunk neón:

primary='#00f0ff', secondary='#ff00aa', accent='#9d00ff'

Mafia clásico:

primary='#c9a961', secondary='#8b0000', accent='#2c3e50'

Militar / Tactical:

primary='#4a5d23', secondary='#8b6f47', accent='#1a1a1a'

Changelog y créditos

Config.Changelog = {
    {
        version = '1.5.12',
        date    = '2026-05-31',
        notes   = {
            'Soporte completo en 5 idiomas (es / en / pt / fr / de)',
            'Editor de personajes con cámara orbital y zoom por categoría',
            'Selección de hasta 5 personajes con preview 3D',
        }
    },
}

Config.Credits = {
    { name = 'FiveRank Team', role = 'Diseño y desarrollo', url = 'https://fiverank.gg' },
}

Siguiente paso

➡️ Flujo y eventos