Script de Veículos FiveM — Garagem e Controle de Frota

Gerencie veículos no seu servidor FiveM com garagem pessoal, compra e venda, spawner configurável e controle de propriedade por personagem.

O módulo de Veículos oferece um sistema completo de garagem para o seu servidor FiveM. Os jogadores podem guardar, retirar e gerenciar seus veículos, com suporte a múltiplas garagens, sistema de propriedade vinculado ao personagem e integração com o sistema de economia.

Funcionalidades

• Garagem pessoal por personagem
• Múltiplas localizações de garagem configuráveis
• Compra e venda de veículos (integração com Economia)
• Spawner de veículos para jobs específicos
• Histórico de veículos impoundados
• Blips automáticos no mapa para garagens
• Compatível com ox_target para interação por proximidade

Configuração de Garagens

Defina todas as garagens do servidor em config.lua. O campo type controla quem pode acessar cada garagem: 'public' é aberta a todos, 'job' é restrita aos empregos listados em jobs, e 'private' requer que o jogador seja dono de um imóvel vinculado.

config.lua

Config.Garages = {
    ['garagem_central'] = {
        label = 'Garagem Central',
        type = 'public',            -- 'public', 'job' ou 'private'
        spawnPoint = vector4(-323.5, -816.9, 29.4, 248.5),
        blip = { sprite = 357, color = 3, label = 'Garagem Central' },
    },
    ['garagem_policia'] = {
        label = 'Garagem da Polícia',
        type = 'job',
        jobs = { 'police', 'sheriff' },
        spawnPoint = vector4(456.2, -1015.2, 28.0, 90.0),
        blip = { sprite = 357, color = 29, label = 'Garagem PM' },
    },
}

Spawner de Veículos para Jobs

Permita que membros de jobs específicos spawnem veículos oficiais conforme o cargo. Cada número de grade libera os modelos listados — um jogador de grade superior herda os veículos de grades inferiores.

config.lua

Config.JobVehicles = {
    ['police'] = {
        [0] = { 'police', 'police2' },                 -- Grade 0: viaturas básicas
        [3] = { 'police', 'police2', 'policeb' },      -- Grade 3+: motos incluídas
        [4] = { 'fbi', 'fbi2', 'police', 'policeb' },  -- Capitão: acesso a SUVs
    },
    ['ambulance'] = {
        [0] = { 'ambulance' },
        [2] = { 'ambulance', 'lguard' },
    },
}

Configuração de Propriedade

Controle o comportamento dos veículos próprios de cada personagem, incluindo o que acontece após a morte e os limites de frota.

config.lua

Config.VehicleOwnership = {
    storeOnDeath       = true,   -- Guarda o veículo automaticamente ao morrer
    maxOwnedVehicles   = 5,      -- Máximo de veículos por personagem (0 = ilimitado)
    allowSharing       = true,   -- Permite que outros jogadores retirem o veículo do dono
    impoundFee         = 500,    -- Taxa em R$ para retirar veículo do pátio
}

Interação por Target

Para substituir os menus de aproximação pelo sistema de target (ox_target), ative a opção abaixo no config.lua:

config.lua

Config.UseTarget = true  -- false por padrão; requer ox_target instalado

Com Config.UseTarget = true, o jogador interage com a garagem mirando nela e pressionando a tecla de interação do ox_target, em vez de abrir um menu automático ao se aproximar.

Comandos do Módulo Veículos

Comando	Permissão	Descrição
/garagem	Qualquer jogador	Abre a garagem mais próxima
/tempveh [modelo]	vehicles.admin	Spawna um veículo temporário (sem registro)
/delveh	vehicles.admin	Remove o veículo mais próximo do mundo
/impound [placa]	vehicles.moderator	Apreende um veículo pelo número de placa

API — Integrações via Exports e Eventos

Verificar se jogador tem veículo estacionado (servidor)

local count = exports['veiculos']:GetPlayerVehicleCount(source)
-- Retorna o número de veículos registrados para o personagem

Spawnar veículo por script (servidor)

exports['veiculos']:SpawnVehicle(source, 'police', vector4(441.1, -982.1, 30.7, 90.0))
-- Parâmetros: source, modelo (string), posição (vector4 com heading)

Evento disparado ao guardar veículo (cliente)

AddEventHandler('veiculos:onVehicleStored', function(plate)
    print('Veículo ' .. plate .. ' guardado na garagem.')
end)

Evento disparado ao retirar veículo (cliente)

AddEventHandler('veiculos:onVehicleSpawned', function(plate, model)
    print('Veículo ' .. model .. ' (' .. plate .. ') retirado da garagem.')
end)

Resolução de Problemas

Problema	Causa provável	Solução
Garagem não aparece no mapa	Blip não configurado ou recurso não iniciado	Confirme que o campo blip está preenchido e reinicie o recurso
Veículo não retorna após morte	storeOnDeath = false	Ative storeOnDeath = true em Config.VehicleOwnership
Spawner de job não funciona	Modelo de veículo inválido	Confirme o nome do modelo usando o nome interno do GTA V
Interação por target não funciona	ox_target não instalado	Instale e inicie o ox_target antes de ativar Config.UseTarget