⚙️ 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

Propriedade	Valor
Tipo	`boolean`
Padrão	`true`

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.

ghostMode

Propriedade	Valor
Tipo	`boolean`
Padrão	`false`

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.

showDistanceText

Propriedade	Valor
Tipo	`boolean`
Padrão	`true`

Exibe a distância em metros até o próximo checkpoint na tela durante a corrida.

showHeadNameTags

Propriedade	Valor
Tipo	`boolean`
Padrão	`true`

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

Propriedade	Tipo	Descrição
`enabled`	`boolean`	Ativa/desativa este som
`name`	`string`	Nome do som do GTA V
`set`	`string`	Conjunto (soundset) do som

Sons Disponíveis

reach_checkpoint
finish_success
regressive_countdown

Evento: Jogador passa por um checkpoint (exceto o último)Padrão:

Som: CHECKPOINT_NORMAL
Set: HUD_MINI_GAME_SOUNDSET

Evento: Jogador cruza a linha de chegadaPadrão:

Som: Checkpoint_Finish
Set: DLC_Stunt_Race_Frontend_Sounds

Evento: Contagem regressiva antes da largadaPadrão:

Som: 5s
Set: MP_MISSION_COUNTDOWN_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",
}

Propriedade	Tipo	Descrição
`stopControl`	`number`	ID do controle para fechar o preview
`stopControlDisplay`	`string`	Texto 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,
}

Propriedade	Tipo	Descrição
`enabled`	`boolean`	Ativa/desativa partículas
`dict`	`string`	Dicionário de partículas
`name`	`string`	Nome da partícula
`scale`	`number`	Tamanho da partícula

Blips no Mapa

local mapBlips = {
    enabled = true,
    sprite = 271,
    colour = 4,
    scale = 0.6,
}

Propriedade	Tipo	Descrição
`enabled`	`boolean`	Ativa/desativa blips
`sprite`	`number`	Ícone do blip
`colour`	`number`	Cor do blip
`scale`	`number`	Tamanho 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,
}

Propriedade	Tipo	Descrição
`enabled`	`boolean`	Ativa/desativa props
`model`	`string`	Modelo do prop
`offsetDistance`	`number`	Distância do centro para esquerda/direita
`alpha`	`number`	Transparência (0-255)
`solo`	`boolean`	Se `true`, spawna apenas o prop esquerdo
`collision`	`boolean`	Ativa 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

preview
racing
racing_next
racing_last

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
},

Quando: Checkpoint atual durante a corrida

racing = {
    checkpoint = {
        model = 18,
        offset = vector3(0.0, 0.0, 6.0),
    },
    color = {255, 255, 255, 100},
    blips = mapBlips,
    prop = propConfig,
},

Quando: Próximo checkpoint (preview do seguinte)

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,
    },
},

Quando: Linha de chegada

racing_last = {
    checkpoint = {
        model = 21,
        offset = vector3(0.0, 0.0, 6.0),
    },
    color = {0, 250, 0, 100},
    blips = {
        enabled = true,
        sprite = 315,
        -- ...
    },
},

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,
        },
    },
}

Informações Gerais

Scripts

Configurações Client

⚙️ Configurações Client

🎮 Recursos Gerais

🔊 Configurações de Sons

Estrutura SoundParams

Sons Disponíveis

👁️ Configurações de Preview

✨ Partículas e Blips

Partículas

Blips no Mapa

Sprites de Blip

Cores de Blip

🏗️ Configuração de Props

🎯 Configuração de Checkpoints

Estados de Checkpoint

Estrutura do Checkpoint

Estrutura de Cor

📝 Exemplo Completo

​⚙️ Configurações Client

​🎮 Recursos Gerais

​🔊 Configurações de Sons

​Estrutura SoundParams

​Sons Disponíveis

​👁️ Configurações de Preview

​✨ Partículas e Blips

​Partículas

​Blips no Mapa

Sprites de Blip

Cores de Blip

​🏗️ Configuração de Props

​🎯 Configuração de Checkpoints

​Estados de Checkpoint

​Estrutura do Checkpoint

​Estrutura de Cor

​📝 Exemplo Completo

⚙️ Configurações Client

🎮 Recursos Gerais

🔊 Configurações de Sons

Estrutura SoundParams

Sons Disponíveis

👁️ Configurações de Preview

✨ Partículas e Blips

Partículas

Blips no Mapa

🏗️ Configuração de Props

🎯 Configuração de Checkpoints

Estados de Checkpoint

Estrutura do Checkpoint

Estrutura de Cor

📝 Exemplo Completo