Le problème de la réparation sur le terrain
Ton véhicule prend des dégâts au milieu d'une mission. Le garage est à 10 minutes. Te taper ce trajet casse le rythme de toute la séquence d'action dans laquelle tu étais. Mais une auto-réparation instantanée, ça paraît injuste. Agency-Repairkit trouve le juste milieu avec des outils de réparation sur le terrain utilisables mais limités.
Trois niveaux de kits
Les kits basiques réparent vite les petits dégâts. Les kits avancés réparent les dégâts moyens plus lentement. Les kits professionnels gèrent les gros dégâts mais prennent nettement plus de temps à appliquer. Cette hiérarchie donne aux joueurs des choix réels selon leur inventaire et la situation dans laquelle ils se trouvent.
Intégrité de l'animation
Chaque réparation utilise une animation visible au niveau de la zone endommagée du véhicule. Impossible de réparer en vitesse depuis le siège conducteur — tu dois sortir, marcher jusqu'aux dégâts et t'engager dans l'animation de réparation. Ça empêche l'abus de réparation sur le terrain pendant les combats et donne à l'action un côté mérité.
L'interruption compte
Prendre des dégâts ou se faire toucher pendant une réparation l'interrompt et consomme le kit. Les réparations se font hors combat, pas en plein milieu. Ça évite que les courses-poursuites ne deviennent un jeu de taupes où rien ne tient.
Intégration avec l'économie
Les kits de réparation sont fabricables par des PNJ mécaniciens ou par des mécaniciens joueurs via la chaîne d'approvisionnement en métaux d'Agency-Minerjob. Toute l'économie automobile — minage, craft, réparations sur le terrain, réparations en atelier — devient un réseau connecté. Les kits ne sont pas un objet isolé: ils sont un nœud dans un système plus vaste.
Installation et configuration
Téléchargez Agency-Repairkit depuis votre bibliothèque Tebex et copiez le dossier dans votre répertoire de ressources. Ajoutez ensure agency-repairkit à server.cfg. La ressource nécessite oxmysql si vous voulez un suivi persistant des kits entre les redémarrages. Les articles de kits doivent être enregistrés dans la liste d'articles de votre framework.
Options de configuration
- Niveaux de kits — définissez autant de types de kits que vous voulez, chacun avec un montant de réparation maximal, une vitesse de réparation et une durée d'animation.
- Verrouillage de combat — si les réparations peuvent être initiées pendant que le joueur est en combat. Défaut : désactivé pendant le combat.
- Seuil d'interruption — combien de dégâts entrants annulent une réparation active.
- Animation par zone de dégâts — différentes animations pour les dégâts moteur, carrosserie et pneus.
Compatibilité avec les frameworks
Agency-Repairkit est livré avec des adaptateurs intégrés pour QBCore et ESX. La détection du framework est automatique. Pour les serveurs autonomes, implémentez Config.GetItem, Config.RemoveItem, Config.GetVehicleHealth et Config.SetVehicleHealth.
Pourquoi c'est important pour le roleplay
Les dégâts de véhicule sont l'une des sources les plus constantes de friction RP. Quand une mission tourne mal à 15 minutes du mécanicien le plus proche, les joueurs ont un choix. Les kits de réparation offrent une troisième voie qui semble méritée sans être gratuite. Le système de verrouillage de combat est particulièrement important pour le RP de poursuite — sans lui, un joueur chassé pourrait se réparer en pleine poursuite, ce qui dégonfle complètement la tension.
Équilibrer les kits dans l'économie du serveur
La question économique que les serveurs posent le plus sur Agency-Repairkit est : quelle doit être la rareté des kits ? Si votre serveur a des garages de mécaniciens actifs avec du bon roleplay, rendez les kits basiques et avancés raisonnablement disponibles mais les kits professionnels rares ou réservés aux mécaniciens. Cela repousse les grosses réparations vers les garages tout en permettant les petites réparations de terrain.
Foire aux questions
Les mécaniciens peuvent-ils vendre des kits depuis leur menu ?
Oui. Agency-Repairkit exporte un événement côté serveur agency-repairkit:giveKit que n'importe quel script mécanicien peut appeler.
Le kit fonctionne-t-il sur les bateaux et avions ?
Oui. Le système de dégâts utilise les propriétés natives de santé de véhicule de FiveM qui s'appliquent à tous les types de véhicules.
Prérequis
- Serveur FiveM (QBCore, ESX ou autonome)
- oxmysql (optionnel, pour le suivi persistant des kits)
- Compte cfx.re avec licence Agency-Repairkit valide
Équilibrer les kits de réparation dans l'économie de votre serveur
L'un des défis de conception d'un serveur RP est de décider à quel point les réparations de véhicules doivent être accessibles. Trop faciles, et les accidents n'ont aucune conséquence. Trop difficiles, et les joueurs se frustrent d'être bloqués avec un véhicule endommagé.
Agency-Repairkit vous donne les outils pour trouver cet équilibre. Vous pouvez configurer :
- Prix d'achat — rendez les kits de base bon marché mais les kits premium coûteux
- Disponibilité — vendez-les dans les magasins normaux ou uniquement dans des emplacements spéciaux
- Quantité de réparation — les kits bon marché réparent 20%, les kits premium 80%
- Cooldown d'utilisation — empêche le spam de kits pour réparer instantanément les dommages majeurs
Intégration avec les mécaniques de garage
Agency-Repairkit fonctionne bien aux côtés des garages RP traditionnels. Les joueurs peuvent utiliser des kits sur le terrain pour des réparations d'urgence, mais les réparations majeures nécessitent encore un garage. Cela crée une boucle de gameplay naturelle : les kits sont pour survivre jusqu'au prochain garage, pas pour remplacer les mécaniciens.
Animations et feedback visuel
L'utilisation d'un kit déclenche une animation réaliste de réparation. Votre personnage sort les outils et travaille sur le véhicule pendant que la barre de progression augmente. Ce délai est intentionnel — il empêche l'utilisation de kits en plein combat et donne aux autres joueurs la possibilité de voir ce que vous faites.
Cas d'utilisation avancés
Au-delà des réparations simples, les administrateurs de serveur peuvent créer des scénarios plus complexes. Par exemple, les mécaniciens peuvent avoir accès à des kits plus puissants que les civils ordinaires. Ou certaines zones de la carte peuvent être désignées comme zones de réparation où les kits fonctionnent plus efficacement, encourageant les joueurs à se regrouper dans des endroits spécifiques.
À 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.