Skip to main content

​
⚙️ Configurações Client

Estas configurações controlam toda a experiência visual e sonora do jogador durante as corridas. Localizadas em config/client/config.lua.

​
🎮 Recursos Gerais

Configurações básicas de gameplay do cliente. 
-- Ativa animação de câmera ao iniciar a corrida
Config.raceStartCamAnim = true

-- Ativa modo fantasma (desativa colisões entre jogadores)
Config.ghostMode = false

-- Mostra distância até o próximo checkpoint durante a corrida
Config.showDistanceText = true

-- Mostra nome dos jogadores acima dos veículos
Config.showHeadNameTags = true

-- Mostra blips dos jogadores no mapa
Config.showPlayerBlips = true

raceStartCamAnim

PropriedadeValor
Tipoboolean
Padrãotrue
Quando ativado, exibe uma sequência cinematográfica de câmera ao iniciar a corrida, mostrando o veículo de diferentes ângulos antes da largada.
Desative se os jogadores reclamarem de delay no início da corrida.
PropriedadeValor
Tipoboolean
Padrãofalse
Quando ativado, desativa as colisões entre jogadores durante a corrida. Útil para evitar trolling e acidentes propositais.
Recomendamos manter desativado, pois o item coletável FANTASMA já oferece essa funcionalidade temporariamente, de maneira mais competitiva.
PropriedadeValor
Tipoboolean
Padrãotrue
Exibe a distância em metros até o próximo checkpoint na tela durante a corrida.
PropriedadeValor
Tipoboolean
Padrãotrue
Mostra o nickname dos jogadores acima de seus veículos durante a corrida.

​
🔊 Configurações de Sons

Sistema de sons para eventos da corrida. 
Config.Sounds = {
    reach_checkpoint = {
        enabled = true,
        name = "CHECKPOINT_NORMAL",
        set = "HUD_MINI_GAME_SOUNDSET"
    },
    finish_success = {
        enabled = true,
        name = "Checkpoint_Finish",
        set = "DLC_Stunt_Race_Frontend_Sounds",
    },
    regressive_countdown = {
        enabled = true,
        name = "5s",
        set = "MP_MISSION_COUNTDOWN_SOUNDSET",
    },
}

​
Estrutura SoundParams

PropriedadeTipoDescrição
enabledbooleanAtiva/desativa este som
namestringNome do som do GTA V
setstringConjunto (soundset) do som

​
Sons Disponíveis

Evento: Jogador passa por um checkpoint (exceto o último)Padrão:
  • Som: CHECKPOINT_NORMAL
  • Set: HUD_MINI_GAME_SOUNDSET
Consulte a lista completa de sons do GTA V em: Pastebin - GTA V Sounds

​
👁️ Configurações de Preview

Configurações do modo de pré-visualização de rotas. 
Config.Preview = {
    stopControl = 194,
    stopControlDisplay = "BACKSPACE",
}
PropriedadeTipoDescrição
stopControlnumberID do controle para fechar o preview
stopControlDisplaystringTexto exibido na interface
Consulte os IDs de controles em: FiveM Controls

​
✨ Partículas e Blips

Configurações padrão para efeitos visuais nos checkpoints.

​
Partículas

local particlesConfig = {
    enabled = true,
    dict = 'core',
    name = 'ent_amb_steam',
    scale = 1.5,
}
PropriedadeTipoDescrição
enabledbooleanAtiva/desativa partículas
dictstringDicionário de partículas
namestringNome da partícula
scalenumberTamanho da partícula

​
Blips no Mapa

local mapBlips = {
    enabled = true,
    sprite = 271,
    colour = 4,
    scale = 0.6,
}
PropriedadeTipoDescrição
enabledbooleanAtiva/desativa blips
spritenumberÍcone do blip
colournumberCor do blip
scalenumberTamanho do blip

Sprites de Blip

Lista completa de sprites disponíveis

Cores de Blip

Lista completa de cores disponíveis

​
🏗️ Configuração de Props

Props são objetos decorativos posicionados nos checkpoints. 
local propConfig = {
    enabled = true,
    model = "prop_offroad_tyres02",
    offsetDistance = 4.0,
    alpha = 255,
    solo = false,
    collision = false,
}
PropriedadeTipoDescrição
enabledbooleanAtiva/desativa props
modelstringModelo do prop
offsetDistancenumberDistância do centro para esquerda/direita
alphanumberTransparência (0-255)
solobooleanSe true, spawna apenas o prop esquerdo
collisionbooleanAtiva colisão do prop
Props populares para checkpoints:
  • prop_offroad_tyres02 - Pilha de pneus
  • prop_roadcone02a - Cone de trânsito
  • prop_barrier_work05 - Barreira de obra

​
🎯 Configuração de Checkpoints

A parte mais importante da configuração visual. Define como os checkpoints aparecem em diferentes estados. 
Config.checkpointsParams = {
    preview = { ... },
    racing = { ... },
    racing_next = { ... },
    racing_last = { ... },
}

​
Estados de Checkpoint

Quando: Modo de pré-visualização de rotas
preview = {
    checkpoint = {
        model = 45,
        scale = 8.0,
    },
    color = {255, 255, 255, 100},
    blips = mapBlips,
    prop = propConfig,
    particles = nil
},

​
Estrutura do Checkpoint

checkpoint = {
    model = 18,                            -- Modelo do checkpoint
    scale = 3.0,                           -- Escala (opcional)
    offset = vector3(0.0, 0.0, 6.0),       -- Offset de posição (opcional)
}
Consulte os modelos de checkpoint em: FiveM Checkpoints

​
Estrutura de Cor

color = {R, G, B, A}
-- R = Red (0-255)
-- G = Green (0-255)
-- B = Blue (0-255)
-- A = Alpha/Transparência (0-255)
Cores populares:
  • Branco: {255, 255, 255, 100}
  • Verde: {0, 250, 0, 100}
  • Vermelho: {255, 0, 0, 100}
  • Azul: {0, 100, 255, 100}
  • Amarelo: {255, 255, 0, 100}

​
📝 Exemplo Completo

Config.checkpointsParams = {
    -- Checkpoints no modo preview
    preview = {
        checkpoint = {
            model = 45,
            scale = 8.0,
        },
        color = {255, 255, 255, 100},
        blips = {
            enabled = true,
            sprite = 271,
            colour = 4,
            scale = 0.6,
        },
        prop = {
            enabled = true,
            model = "prop_offroad_tyres02",
            offsetDistance = 4.0,
            alpha = 255,
            solo = false,
            collision = false,
        },
        particles = nil
    },

    -- Checkpoint atual durante corrida
    racing = {
        checkpoint = {
            model = 18,
            offset = vector3(0.0, 0.0, 6.0),
        },
        color = {255, 255, 255, 100},
        blips = {
            enabled = true,
            sprite = 271,
            colour = 4,
            scale = 0.6,
        },
        prop = {
            enabled = true,
            model = "prop_offroad_tyres02",
            offsetDistance = 4.0,
            alpha = 255,
            solo = false,
            collision = false,
        },
    },

    -- Próximo checkpoint (semi-transparente)
    racing_next = {
        checkpoint = {
            model = 20,
            offset = vector3(0.0, 0.0, 6.0),
        },
        color = {255, 255, 255, 20},
        blips = {
            enabled = true,
            sprite = 270,
            scale = 0.5,
            colour = 4,
        },
        prop = {
            enabled = true,
            model = "prop_offroad_tyres02",
            offsetDistance = 4.0,
            alpha = 180,
            solo = false,
            collision = false,
        },
    },

    -- Linha de chegada (verde)
    racing_last = {
        checkpoint = {
            model = 21,
            offset = vector3(0.0, 0.0, 6.0),
        },
        color = {0, 250, 0, 100},
        blips = {
            enabled = true,
            sprite = 315,
            colour = 2,
            scale = 0.8,
        },
        prop = {
            enabled = true,
            model = "prop_offroad_tyres02",
            offsetDistance = 4.0,
            alpha = 255,
            solo = false,
            collision = false,
        },
    },
}