Le problème avec l'accès aux véhicules par défaut dans FiveM
Par défaut, GTA V et FiveM permettent à n'importe quel joueur d'entrer dans n'importe quel véhicule et de le conduire sans restriction. Il n'y a pas de clés, pas de mécanique de propriété, pas de conséquences à sauter dans la voiture d'un inconnu et à partir. Pour les serveurs occasionnels, cela importe peu, mais pour toute communauté de roleplay sérieuse, ce comportement par défaut est un brise-immersion fondamental. Chaque voiture devient un taxi communautaire. Le vol de véhicule perd tout son sens. Garer sa voiture près de la banque pendant un boulot devient un pari contre d'autres joueurs qui s'en emparent.
Un script de clés de véhicule FiveM résout ce problème au niveau du framework. Il associe la propriété et des clés physiques à chaque véhicule spawné ou acheté sur le serveur, exigeant que les joueurs aient le bon objet clé dans leur inventaire pour déverrouiller, démarrer et conduire une voiture. Les véhicules sans clé sont verrouillés — un joueur qui tente d'y entrer est simplement refusé. Pour conduire une voiture qui ne vous appartient pas, vous devez soit emprunter la clé, utiliser la mécanique de démarrage à chaud (hotwire), soit crocheter la serrure. Ces trois mécaniques ensemble transforment l'interaction avec les véhicules d'un non-événement en une couche significative de friction de roleplay.
En 2026, Agency-Vehiclekeys est le choix de référence pour les serveurs qui souhaitent implémenter ce système proprement, avec une intégration profonde à QBCore et ESX, un mini-jeu de démarrage à chaud engageant, et un prix unique très abordable. Ce guide couvre tout ce que vous devez savoir.
Ce qu'offre Agency-Vehiclekeys
Agency-Vehiclekeys repose sur cinq piliers fonctionnels qui, ensemble, donnent à la propriété de véhicule un caractère authentique :
1. Objets clés physiques
Lorsqu'un joueur spawne ou achète un véhicule, un objet clé unique est placé dans son inventaire. Cet objet est le seul moyen de déverrouiller et de démarrer ce véhicule spécifique — il est lié à l'ID réseau ou à la plaque du véhicule. La clé peut être physiquement remise à un autre joueur, déposée au sol, rangée dans un coffre ou perdue. Si vous perdez votre clé, vous ne pouvez pas démarrer votre voiture sans utiliser le hotwire ou appeler un serrurier (une mécanique de job que vous pouvez configurer). Cette seule décision de design — transformer les clés en véritables objets d'inventaire — crée une cascade de scénarios de roleplay authentiques que FiveM par défaut ne peut tout simplement pas prendre en charge.
2. Partage de clés
Le système de partage de clés permet au propriétaire du véhicule de créer un double et de le remettre à n'importe quel autre joueur. C'est essentiel pour les véhicules co-possédés, les voitures familiales, les garages mécaniques qui doivent déplacer des véhicules, et les équipes criminelles qui partagent une voiture de fuite. Le partage se fait via une interaction in-game simple — ciblez le joueur, sélectionnez « Donner la clé du véhicule », et le double apparaît dans son inventaire. Le propriétaire conserve sa clé ; le destinataire reçoit une copie fonctionnelle identique à l'originale. Les propriétaires peuvent également révoquer toutes les clés partagées à tout moment, verrouillant l'accès de toute personne qui en avait précédemment.
3. Mini-jeu de démarrage à chaud
Quand un joueur tente d'entrer dans un véhicule verrouillé pour lequel il n'a pas de clé, il a la possibilité de démarrer à chaud (hotwire). Agency-Vehiclekeys inclut un mini-jeu NUI de hotwire soigné — un défi de correspondance de fils chronométré qui requiert de l'habileté du joueur plutôt qu'un simple jet de dés. Réussir le mini-jeu démarre la voiture mais déclenche des événements côté serveur que d'autres scripts peuvent intercepter : alerter le propriétaire de la voiture, notifier la police, consigner l'incident dans le MDT. La difficulté et la limite de temps du mini-jeu sont entièrement configurables, et vous pouvez définir différents niveaux de difficulté selon la classe du véhicule (voitures économiques plus faciles, supercars plus difficiles).
4. Système de crochetage de serrure
Le système de lockpick couvre l'étape de déverrouillage de la portière séparément du démarrage à chaud. Un joueur avec un objet crochet dans son inventaire peut tenter de crocheter la serrure d'une portière de véhicule. C'est un prérequis pour entrer dans le véhicule du tout lors du hotwire — vous crochetez la portière, puis démarrez à chaud. Le crochetage a son propre mini-jeu et son propre taux de réussite configurable ainsi qu'une chance de consommation d'objet. Les tentatives échouées peuvent casser le crochet (configurable) et optionnellement envoyer une notification aux joueurs proches ou à la police. Ce processus en deux étapes — crocheter, puis démarrer à chaud — rend le vol de véhicule significativement risqué et chronophage, exactement comme il se doit dans le RP sérieux.
5. Intégration profonde à QBCore et ESX
Agency-Vehiclekeys s'intègre directement à l'inventaire QBCore (compatible ox_inventory) et à l'inventaire ESX dès le départ. Les objets clés apparaissent comme de vrais objets d'inventaire avec des icônes et des métadonnées. La propriété du véhicule est liée à la base de données de propriété de véhicules de QBCore (player_vehicles) et à son équivalent ESX. Lorsqu'un joueur récupère sa voiture chez le concessionnaire ou à la fourrière, sa clé est automatiquement générée et placée dans son inventaire. Toutes les notifications — confirmations de verrouillage/déverrouillage, alertes de hotwire, tentatives de crochetage — utilisent le système de notification natif de votre framework pour correspondre au reste de l'interface de votre serveur.
Fonctionnalités supplémentaires
Au-delà des cinq piliers principaux, Agency-Vehiclekeys comprend plusieurs mécaniques de qualité de vie :
- Animations de verrouillage/déverrouillage : Le personnage joue une animation réaliste d'extension du bras lors du verrouillage ou du déverrouillage d'un véhicule, avec un son de clic audible.
- Verrouillage à distance : Verrouillez et déverrouillez depuis une distance configurable via un raccourci clavier ou une option du menu radial — pas besoin de se trouver juste à côté de la portière.
- Alarme de véhicule : Déclenchez optionnellement une alarme de voiture lors d'une tentative de crochetage ou de démarrage à chaud. L'alarme attire l'attention des joueurs proches et peut notifier le propriétaire par notification téléphonique (si Agency Phone est installé).
- Véhicules exemptés par job : Définissez une liste de véhicules de service (voitures de police, ambulances, dépanneuses) exemptés du système de clés — les agents peuvent entrer dans les véhicules de service librement sans avoir besoin d'un objet clé.
- Intégration fourrière : Quand un véhicule est mis en fourrière, la clé associée est automatiquement invalidée. Quand le véhicule est récupéré en fourrière, une nouvelle clé est générée.
- API d'export : Une API d'export propre permet à d'autres scripts de vérifier la propriété des clés, de générer des clés par programmation ou de révoquer des clés — utile pour les scripts de mécanicien, de concessionnaire et les intégrations de jobs personnalisés.
Installation : étape par étape
Étape 1 — Acheter Agency-Vehiclekeys
Rendez-vous sur shop.agencyg.de/fr/products/vehiclekeys et finalisez l'achat unique de 5,99 €. Après le paiement, vous recevez l'accès au téléchargement via le portail de la boutique Agency Scripts. Pas d'abonnement, pas de renouvellement — vous le possédez définitivement.
Étape 2 — Placer la ressource
Extrayez l'archive téléchargée et déposez le dossier agency-vehiclekeys dans le répertoire resources de votre serveur (ou un sous-dossier comme resources/[scripts]/).
Étape 3 — Ajouter au server.cfg
Ouvrez votre server.cfg et ajoutez la ligne ensure après les ressources de votre framework et d'inventaire :
ensure agency-vehiclekeys
Étape 4 — Configurer Config.lua
Ouvrez agency-vehiclekeys/config/Config.lua et définissez votre framework, votre système d'inventaire et vos préférences de fonctionnalités. Voir l'exemple ci-dessous pour une configuration représentative.
Étape 5 — Ajouter les objets clés à votre inventaire
Si vous utilisez QBCore ou ESX, ajoutez la définition de l'objet clé à votre fichier d'objets partagés. La définition exacte est fournie dans la documentation sur docs.agencyg.de/vehiclekeys. Pour les utilisateurs d'ox_inventory, ajoutez l'objet à votre items.lua.
Étape 6 — Redémarrer et tester
Redémarrez votre serveur. Spawner un véhicule, vérifiez votre inventaire pour l'objet clé, verrouillez le véhicule, éloignez-vous, revenez et essayez d'y entrer sans la clé. Testez ensuite la remise de clé à un autre joueur, l'interaction de crochetage et le mini-jeu de hotwire.
Exemple de Config.lua
Voici une configuration représentative montrant les options les plus importantes d'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
Compatibilité framework et inventaire
Agency-Vehiclekeys prend en charge les combinaisons suivantes dès le départ :
- QBCore + qb-inventory : Intégration complète — les clés apparaissent dans l'interface d'inventaire QBCore, la propriété du véhicule se synchronise avec
player_vehicles - QBCore + ox_inventory : Intégration complète — les clés rendues comme objets ox avec métadonnées, compatibles avec toutes les fonctionnalités d'ox_inventory
- ESX + inventaire ESX : Intégration complète — les clés dans le système d'inventaire ESX, propriété synchronisée avec la table de véhicules ESX
Si vous utilisez un système d'inventaire différent, l'API d'export et le code Lua ouvert permettent d'ajouter facilement un bridge personnalisé. La documentation inclut un modèle de bridge.
Documentation
La documentation complète — toutes les options de configuration, les définitions d'objets d'inventaire, la référence de l'API d'export, la configuration des jobs exemptés et la FAQ — est disponible sur docs.agencyg.de/vehiclekeys. Les docs sont mises à jour à chaque version et incluent des définitions d'objets prêtes à copier pour QBCore, ESX et ox_inventory.
Tarif : 5,99 € paiement unique
Agency-Vehiclekeys coûte 5,99 € en paiement unique via la boutique Agency Scripts. Pas d'abonnement, pas de renouvellement, pas de frais par serveur. Payez une fois et possédez-le pour toujours — toutes les mises à jour futures de la version majeure actuelle sont incluses sans frais supplémentaires. À moins de six euros, c'est l'un des scripts FiveM premium les plus rentables du marché. Un système de clés de véhicule comparable d'un autre développeur sur un modèle d'abonnement coûterait autant en un seul mois ; Agency-Vehiclekeys vous offre la même qualité ou mieux pour un prix unique que la plupart des propriétaires de serveurs dépensent en café dans une semaine.
À qui s'adresse Agency-Vehiclekeys ?
Agency-Vehiclekeys est le bon choix pour :
- Les serveurs RP sérieux qui veulent que la propriété de véhicule ait un vrai poids — plus question de monter dans n'importe quelle voiture que vous voyez
- Les communautés de RP criminel qui veulent des mécaniques authentiques de hotwire et de crochetage faisant du vol de véhicule une activité habile et risquée
- Les serveurs avec des concessionnaires automobiles — l'intégration transparente signifie que la génération de clés est automatique au point de vente
- Les serveurs de RP police — les alertes d'alarme et les notifications de police lors des tentatives de crochetage/hotwire créent de véritables scénarios d'intervention
- Les serveurs QBCore et ESX à la recherche d'une solution de clés bien maintenue et clé en main qui respecte les conventions existantes du framework
En résumé
Les clés de véhicule sont une mécanique fondamentale pour tout serveur qui prend le roleplay au sérieux. Agency-Vehiclekeys livre le package complet — objets clés physiques, partage de clés, mini-jeu de hotwire basé sur les compétences, système de crochetage en deux étapes, alarmes de véhicule et intégration profonde au framework — pour un paiement unique de 5,99 €. C'est, objectivement, l'un des achats à meilleur rapport qualité-prix que vous puissiez faire pour votre serveur FiveM. Visitez la boutique, procurez-le, et transformez dès aujourd'hui le fonctionnement des véhicules sur votre serveur.