Scripts 2026-04-14

Agency-Vehiclekeys: comment un peu de friction rend les voitures vivantes

TDYSKY

TDYSKY

Founder & Lead Developer at Agency Scripts

L'anti-fonctionnalité qui n'en est pas une

Demander une clé pour démarrer un véhicule ressemble à une anti-fonctionnalité. Qui veut plus d'étapes avant de conduire? Mais le RP immersif est souvent bâti exactement sur ce genre de friction qui a du sens. Le vol de voiture devient du vol-avec-enjeux. Verrouiller sa caisse devient une vraie action. Le démarrage fil-à-fil devient une compétence à apprendre.

Des états de clé qui comptent

Agency-Vehiclekeys modélise trois états de clé par véhicule: possédé (tu as un item clé physique), partagé (quelqu'un t'a donné une copie), fil-à-fil (accessible temporairement avec un risque de trace policière). Chaque état a ses propres sons, animations de démarrage et comportement moteur. Les joueurs qui empruntent les voitures de leurs potes se sentent différents des voleurs - et c'est normal.

Mini-jeu de crochetage

On livre un mini-jeu de crochetage simple à 3 niveaux qui se cale sur la classe du véhicule. Un Sultan RS prend plus de temps et rate plus souvent qu'un Faggio. Le mini-jeu est basé sur la compétence mais pas punitif - échouer coûte du temps et des outils, pas de la progression de personnage. C'est la bonne courbe de difficulté pour un mécanisme qui doit être un outil de tension, pas un videur.

Intégrations de frameworks

La propriété de véhicule QBCore, les garages ESX et les registres standalone custom se branchent tous via un seul ensemble de hooks. Les clés sont stockées comme items d'inventaire, donc elles interagissent naturellement avec les drops, les échanges et les fouilles d'inventaire. Rien n'a de cas spécial.

Impact économique

L'accès aux véhicules par clé crée des rôles économiques réalistes. Les serruriers deviennent un job viable. Les voleurs de voitures deviennent une vraie menace. Les assurances deviennent utiles. Le roleplay émergent naît de systèmes qui se répondent - Agency-Vehiclekeys est une pièce de ce puzzle.

Installation et configuration

Agency-Vehiclekeys nécessite oxmysql pour persister la propriété des clés entre les redémarrages. Importez vehiclekeys.sql, copiez le dossier sur le serveur et ajoutez ensure agency-vehiclekeys à server.cfg. Les articles de clés doivent être enregistrés dans le système d'articles de votre framework.

Options de configuration

  • Niveaux de crochetage — définir la probabilité de succès et le comportement en cas d'échec par classe de véhicule.
  • Chance de détection de court-circuit — probabilité qu'un court-circuit réussi envoie un ping police par minute d'utilisation active.
  • Coût de duplication de clé — coût en articles et argent pour créer une copie de clé.
  • Verrouillage auto à la sortie — si les véhicules se verrouillent automatiquement quand le conducteur sort. Défaut : désactivé.

Compatibilité avec les frameworks

Les adaptateurs complets QBCore et ESX sont inclus. Pour les configurations autonomes, implémentez quatre fonctions de configuration : recherche propriétaire véhicule, donner/retirer article, déclencheur d'alerte police, et vérification optionnelle de job serrurier.

Pourquoi c'est important pour le roleplay

La possession de véhicule sans contrôle d'accès significatif n'est que cosmétique. Agency-Vehiclekeys rend l'écart entre posséder un véhicule et y accéder réel. Une voiture verrouillée garée devant une banque n'est pas juste un décor — c'est une cible potentielle ou un bien sûr selon qui la regarde. Le système de détection de court-circuit est ce qui fait du vol de véhicule un risque calculé plutôt qu'une action triviale.

Gérer un personnage serrurier

Agency-Vehiclekeys permet une véritable profession de serrurier qui n'existe pas sur les serveurs sans clés. Un serrurier qui propose des services de copie de clé a besoin d'un moyen d'être contacté par les clients (Agency-Phone), d'un espace de travail pour l'animation de découpe de clé, et facture de l'argent pour le service. La dimension de confiance est particulièrement intéressante — un serrurier qui fait des copies non autorisées ou dénonce ses clients à la police est un personnage avec une vraie complexité morale.

Foire aux questions

Les joueurs peuvent-ils donner leur clé à un autre joueur ?

Oui. Les clés sont des articles d'inventaire et peuvent être échangées, lâchées ou données via n'importe quel transfert d'inventaire standard.

Prérequis

  • Serveur FiveM (QBCore, ESX ou autonome)
  • oxmysql
  • Compte cfx.re avec licence Agency-Vehiclekeys valide

Construire une économie de vol de voitures

Avec Agency-Vehiclekeys, le vol de voitures devient un engagement sérieux, pas un raccourci clavier. Ce changement de design crée tout un écosystème RP :

  • Voleurs spécialisés — les joueurs peuvent se spécialiser dans le vol de voitures, avec les outils et compétences pour le faire
  • Propriétaires vigilants — les propriétaires ont des raisons de faire attention à l'endroit où ils garent et qui a leurs clés
  • Mécaniciens corrompus — des PNJ ou joueurs pourraient fabriquer des clés de remplacement moyennant finances
  • Receleurs — quelqu'un doit acheter ces voitures volées, créant une chaîne criminelle entière

Prêt de clés entre joueurs

Le système de clés prend tout son sens dans les scénarios de prêt. Un patron de crime peut donner les clés de sa voiture à un subordonné pour une mission. Si le subordonné trahit le patron, le patron peut révoquer l'accès à distance. Cette simple mécanique crée de vraies dynamiques de confiance entre personnages.

Intégration avec les garages

Agency-Vehiclekeys s'intègre avec les systèmes de garage courants. Quand vous sortez un véhicule du garage, vous recevez automatiquement les clés. Quand vous rangez le véhicule, les clés sont retournées. Cela maintient la cohérence — vous ne pouvez pas conduire un véhicule sorti par quelqu'un d'autre sans ses clés.

Configuration pour différents contextes RP

Différents serveurs ont des besoins différents. Un serveur RP criminel sérieux pourrait vouloir que toutes les voitures nécessitent des clés physiques. Un serveur plus décontracté pourrait vouloir les clés seulement pour les véhicules de haute valeur. Agency-Vehiclekeys supporte ces deux extrêmes et tout ce qui se trouve entre les deux grâce à une configuration granulaire par catégorie de véhicule et par zone de la carte.

À propos d'Agency Scripts

Agency Scripts est une collection de ressources FiveM premium conçues pour les serveurs de roleplay qui prennent l'immersion au sérieux. Chaque ressource est construite avec les mêmes principes : compatibilité multi-framework, performances optimisées, et configuration flexible pour s'adapter à n'importe quel concept de serveur.

Toutes les ressources Agency sont disponibles via le système de licences cfx.re Keymaster. Une fois achetée, vous pouvez déployer la ressource sur n'importe quel serveur que vous possédez, avec un support actif disponible via le Discord Agency Scripts.

Support et communauté

La communauté Agency Scripts comprend des milliers de serveurs FiveM qui utilisent ces ressources. Le Discord officiel est l'endroit où les développeurs partagent leurs configurations, posent des questions, et suggèrent de nouvelles fonctionnalités. Les mises à jour sont régulières et incluent à la fois des corrections de bugs et de nouvelles fonctionnalités basées sur les retours de la communauté.

Pour les questions d'installation, les problèmes de compatibilité ou les demandes de fonctionnalités, le Discord reste le meilleur canal. La documentation est maintenue à jour et couvre tous les paramètres de configuration avec des exemples pratiques.

Share this article

Ready to upgrade your server?

Check out our premium FiveM scripts in the Agency Scripts store or join our Discord community for support and updates.