O problema com o acesso padrão a veículos no FiveM
Por padrão, GTA V e FiveM permitem que qualquer jogador entre e dirija qualquer veículo sem restrições. Não há chaves, não há mecânicas de propriedade, não há consequências por entrar no carro de um estranho e sair. Para servidores casuais isso mal importa, mas para qualquer comunidade séria de roleplay esse comportamento padrão é um quebrador de imersão fundamental. Todo carro vira um táxi comunitário. Roubo de veículo perde todo o significado. Estacionar o carro perto do banco enquanto você faz um trabalho vira uma aposta contra outros jogadores que simplesmente pegam o carro.
Um script de chaves de veículo para FiveM resolve esse problema no nível do framework. Ele vincula a propriedade e chaves físicas a cada veículo spawnado ou comprado no servidor, exigindo que os jogadores tenham o item de chave correto no inventário para desbloquear, dar partida e dirigir um carro. Veículos sem chave ficam trancados — um jogador que tenta entrar simplesmente é recusado. Para dirigir um carro que não é seu, você precisa pedir a chave emprestada, usar a mecânica de hotwire ou forçar a fechadura. Essas três mecânicas juntas transformam a interação com veículos de um não-evento em uma camada significativa de fricção de roleplay.
Em 2026, Agency-Vehiclekeys é a escolha de destaque para servidores que querem implementar esse sistema de forma limpa, com integração profunda a QBCore e ESX, um mini-game de hotwire envolvente e um preço único muito acessível. Este guia cobre tudo o que você precisa saber.
O que o Agency-Vehiclekeys oferece
Agency-Vehiclekeys é construído em torno de cinco pilares principais que juntos fazem a propriedade de veículos parecer real:
1. Itens de chave físicos
Quando um jogador spawna ou compra um veículo, um item de chave único é colocado em seu inventário. Esse item é o único modo de desbloquear e dar partida naquele veículo específico — está vinculado ao ID de rede ou placa do veículo. A chave pode ser fisicamente entregue a outro jogador, jogada no chão, guardada em um depósito ou perdida. Se você perder sua chave, não pode dar partida no carro sem usar hotwire ou chamar um chaveiro (uma mecânica de cargo que você pode configurar). Essa única decisão de design — transformar chaves em itens reais de inventário — cria uma cascata de cenários autênticos de roleplay que o FiveM padrão simplesmente não consegue proporcionar.
2. Compartilhamento de chaves
O sistema de compartilhamento de chaves permite ao dono do veículo criar uma cópia e entregá-la a qualquer outro jogador. Isso é essencial para veículos co-proprietários, carros da família, oficinas mecânicas que precisam mover veículos, e grupos criminosos compartilhando um carro de fuga. O compartilhamento é feito por meio de uma interação simples no jogo — aponte para o jogador, selecione "Dar chave do veículo", e a cópia aparece no inventário dele. O proprietário mantém a sua chave; o destinatário recebe uma cópia funcional idêntica ao original. Os proprietários também podem revogar todas as chaves compartilhadas a qualquer momento, bloqueando o acesso de qualquer um que tivesse acesso anteriormente.
3. Mini-game de hotwire
Quando um jogador tenta entrar em um veículo bloqueado para o qual não tem chave, recebe a opção de fazer hotwire. Agency-Vehiclekeys inclui um polido mini-game NUI de hotwire — um desafio de combinação de fios cronometrado que exige habilidade do jogador em vez de uma simples rolagem de dados. Completar o mini-game com sucesso dá partida no carro mas dispara eventos no lado do servidor que outros scripts podem interceptar: alertar o dono do carro, notificar a polícia, registrar o incidente no MDT. A dificuldade e o limite de tempo do mini-game são totalmente configuráveis, e você pode definir diferentes níveis de dificuldade com base na classe do veículo (carros econômicos mais fáceis, supercars mais difíceis).
4. Sistema de lockpick
O sistema de lockpick cobre a etapa de desbloqueio da porta separadamente do hotwire. Um jogador com um item de gazua no inventário pode tentar forçar a fechadura da porta de um veículo. Isso é um pré-requisito para entrar no veículo quando for fazer hotwire — você força a porta e depois faz hotwire. A abertura de fechaduras tem seu próprio mini-game e sua própria taxa de sucesso configurável além de chance de consumo do item. Tentativas falhas podem quebrar a gazua (configurável) e opcionalmente enviar uma notificação para jogadores próximos ou para a polícia. Esse processo de duas etapas — forçar a fechadura e depois fazer hotwire — torna o roubo de veículos significativamente arriscado e demorado, exatamente como deveria ser em RP sério.
5. Integração profunda com QBCore e ESX
Agency-Vehiclekeys integra diretamente com o inventário QBCore (compatível com ox_inventory) e o inventário ESX. Itens de chave aparecem como objetos de inventário adequados com ícones e metadados. A propriedade do veículo se vincula ao banco de dados de propriedade de veículos do QBCore (player_vehicles) e seu equivalente ESX. Quando um jogador busca o carro na concessionária ou no depósito, a chave é gerada automaticamente e colocada no inventário. Todas as notificações — confirmações de bloqueio/desbloqueio, alertas de hotwire, tentativas de lockpick — usam o sistema de notificação nativo do seu framework para combinar com o resto da interface do servidor.
Funcionalidades adicionais
Além dos cinco pilares principais, Agency-Vehiclekeys inclui várias mecânicas de qualidade de vida:
- Animações de bloqueio/desbloqueio: O personagem realiza uma animação realista de extensão do braço ao bloquear ou desbloquear um veículo, com um som de clique audível.
- Bloqueio por proximidade: Bloqueie e desbloqueie de uma distância configurável usando um atalho de teclado ou opção de menu radial — sem precisar ficar bem ao lado da porta.
- Alarme de veículo: Acione opcionalmente um alarme de carro quando uma tentativa de lockpick ou hotwire for feita. O alarme chama a atenção de jogadores próximos e pode notificar o dono por notificação telefônica (se Agency Phone estiver instalado).
- Veículos isentos por cargo: Defina uma lista de veículos de serviço (carros de polícia, ambulâncias, guindastes) que são isentos do sistema de chaves — agentes podem entrar em veículos de serviço livremente sem precisar de um item de chave.
- Integração com depósito: Quando um veículo vai para o depósito, a chave associada é automaticamente invalidada. Quando o veículo é retirado do depósito, uma nova chave é gerada.
- API de exportação: Uma API de exportação limpa permite que outros scripts verifiquem a propriedade de chaves, gerem chaves programaticamente ou revoguem chaves — útil para scripts de mecânico, concessionária e integrações de cargos personalizados.
Instalação: passo a passo
Passo 1 — Comprar Agency-Vehiclekeys
Acesse shop.agencyg.de/pt/products/vehiclekeys e conclua a compra única de €5,99. Após o pagamento você recebe acesso ao download pelo portal da loja Agency Scripts. Sem assinatura, sem renovação — você o possui permanentemente.
Passo 2 — Colocar o recurso
Extraia o arquivo baixado e coloque a pasta agency-vehiclekeys no diretório resources do seu servidor (ou em uma subpasta como resources/[scripts]/).
Passo 3 — Adicionar ao server.cfg
Abra seu server.cfg e adicione a linha ensure após os recursos do seu framework e inventário:
ensure agency-vehiclekeys
Passo 4 — Configurar Config.lua
Abra agency-vehiclekeys/config/Config.lua e defina seu framework, sistema de inventário e preferências de funcionalidades. Consulte o exemplo abaixo para uma configuração representativa.
Passo 5 — Adicionar itens de chave ao seu inventário
Se usar QBCore ou ESX, adicione a definição do item de chave ao seu arquivo de itens compartilhados. A definição exata do item é fornecida na documentação em docs.agencyg.de/vehiclekeys. Para usuários de ox_inventory, adicione o item ao seu items.lua.
Passo 6 — Reiniciar e testar
Reinicie o servidor. Spawne um veículo, confira o inventário para ver o item de chave, trave o veículo, afaste-se, volte e tente entrar sem a chave. Depois teste a entrega de chave a outro jogador, a interação de lockpick e o mini-game de hotwire.
Exemplo de Config.lua
Abaixo está uma configuração representativa mostrando as opções mais importantes do Agency-Vehiclekeys:
-- Agency-Vehiclekeys: Config.lua
Config = {}
-- Framework: "qbcore" or "esx"
Config.Framework = "qbcore"
-- Inventory system: "qb-inventory", "ox_inventory", or "esx"
Config.Inventory = "ox_inventory"
-- Item name for vehicle keys in your inventory
Config.KeyItem = "vehicle_key"
-- Item name for lockpicks
Config.LockpickItem = "lockpick"
-- Distance (metres) from which player can lock/unlock their vehicle
Config.LockDistance = 8.0
-- Enable vehicle alarm on hotwire/lockpick attempt
Config.EnableAlarm = true
Config.AlarmDuration = 30 -- seconds
-- Hotwire mini-game settings
Config.Hotwire = {
enabled = true,
timeLimit = 20, -- seconds to complete mini-game
difficulty = "medium", -- "easy", "medium", "hard"
-- Per-class overrides (GTA vehicle class numbers)
classOverrides = {
[6] = "easy", -- off-road: easier
[7] = "hard", -- supercars: harder
[14] = "hard", -- military: very difficult
},
}
-- Lockpick settings
Config.Lockpick = {
enabled = true,
breakChance = 0.25, -- 25% chance lockpick breaks on failure
alertPolice = true, -- send notification to online police on attempt
alertRadius = 30.0, -- metres within which police are notified
}
-- Job-exempt vehicles (these jobs can enter any vehicle without a key)
Config.ExemptJobs = { "police", "ambulance", "mechanic", "tow" }
-- Notification system: "qb", "esx", "okok", "ox"
Config.NotifySystem = "qb"
-- Enable export API for other scripts to interact with the key system
Config.EnableExports = true
Compatibilidade de framework e inventário
Agency-Vehiclekeys suporta as seguintes combinações desde o primeiro momento:
- QBCore + qb-inventory: Integração completa — chaves aparecem na interface de inventário QBCore, propriedade do veículo sincroniza com
player_vehicles - QBCore + ox_inventory: Integração completa — chaves renderizadas como itens ox com metadados, compatíveis com todos os recursos do ox_inventory
- ESX + inventário ESX: Integração completa — chaves no sistema de inventário ESX, propriedade sincronizada com a tabela de veículos ESX
Se você usa um sistema de inventário diferente, a API de exportação e o código Lua aberto facilitam adicionar uma bridge personalizada. A documentação inclui um template de bridge.
Documentação
A documentação completa — todas as opções de configuração, definições de itens de inventário, referência da API de exportação, configuração de cargos isentos e perguntas frequentes — está disponível em docs.agencyg.de/vehiclekeys. A documentação é mantida atualizada a cada lançamento e inclui definições de itens prontas para copiar e colar para QBCore, ESX e ox_inventory.
Preço: €5,99 pagamento único
Agency-Vehiclekeys custa €5,99 como pagamento único através da loja Agency Scripts. Sem assinatura, sem renovação, sem taxa por servidor. Pague uma vez e tenha para sempre — todas as atualizações futuras da versão principal atual estão incluídas sem custo adicional. A menos de seis euros, é um dos scripts FiveM premium mais rentáveis do mercado. Um sistema de chaves de veículo comparável de outro desenvolvedor em modelo de assinatura custaria isso em um único mês; Agency-Vehiclekeys oferece a mesma qualidade ou melhor por um preço único que a maioria dos donos de servidores gasta em café em uma semana.
Para quem é o Agency-Vehiclekeys?
Agency-Vehiclekeys é a escolha certa para:
- Servidores de RP sérios que querem que a propriedade de veículos tenha peso real — chega de entrar em qualquer carro que você vê
- Comunidades de RP criminal que querem mecânicas autênticas de hotwire e lockpick que tornam o roubo de veículos uma atividade habilidosa e arriscada
- Servidores com concessionárias de carros — a integração perfeita significa que a geração de chaves é automática no ponto de venda
- Servidores de RP policial — alertas de alarme e notificações à polícia em tentativas de lockpick/hotwire criam cenários genuínos de resposta
- Servidores QBCore e ESX que buscam uma solução de chaves bem mantida e pronta para uso que respeita as convenções existentes do framework
Resumo
Chaves de veículo são uma mecânica fundamental para qualquer servidor que leva o roleplay a sério. Agency-Vehiclekeys entrega o pacote completo — itens de chave físicos, compartilhamento de chaves, um mini-game de hotwire baseado em habilidades, um sistema de lockpick em duas etapas, alarmes de veículo e integração profunda de framework — por um pagamento único de €5,99. É, objetivamente, uma das compras com melhor custo-benefício que você pode fazer para o seu servidor FiveM. Visite a loja, adquira e transforme hoje mesmo como os veículos funcionam no seu servidor.