Agency-Repairkit : des réparations simples que les joueurs utilisent vraiment

Le problème des réparations sur le terrain

Ton véhicule est endommagé en pleine mission. Le garage de mécanique est à 10 minutes. Ce trajet casse le rythme de la séquence d’action en cours. Mais une réparation instantanée par le conducteur semble injuste. Agency-Repairkit propose un juste milieu avec des outils de réparation utilisables, mais limités.

Trois niveaux de kits

Les kits basiques réparent rapidement les dégâts légers. Les kits avancés réparent les dégâts moyens plus lentement. Les kits professionnels prennent en charge les dégâts importants, mais leur application prend nettement plus de temps. Ces différents niveaux donnent aux joueurs des choix intéressants selon leur inventaire et la situation.

Des animations réalistes

Chaque réparation utilise une animation visible à l’endroit endommagé du véhicule. Les joueurs ne peuvent pas réparer instantanément depuis le siège conducteur, ils doivent sortir, se rendre jusqu’à la zone endommagée et effectuer l’animation de réparation. Cela évite les abus de réparation sur le terrain pendant les combats et donne du poids à l’action.

L’interruption compte

Subir des dégâts ou être touché pendant une réparation l’interrompt et consomme le kit. Les réparations s’effectuent hors combat, pas en plein affrontement. Les poursuites ne se transforment ainsi pas en jeu de tape-taupe où rien ne dure.

Intégration à l’économie

Les kits de réparation peuvent être fabriqués par les PNJ mécaniciens ou les mécaniciens joueurs grâce à la chaîne d’approvisionnement en métaux d’Agency-Minerjob. Toute l’économie automobile, extraction minière, fabrication, réparations sur le terrain et réparations en garage, devient un réseau interconnecté. Les kits ne sont pas des objets isolés, ils sont un maillon d’un système plus vaste.

Installation & configuration

Télécharge Agency-Repairkit depuis ta bibliothèque Tebex et dépose le dossier dans ton répertoire resources. Ajoute ensure agency-repairkit à server.cfg. La ressource nécessite oxmysql si tu veux que le suivi des kits soit conservé après les redémarrages, sans cela, les quantités de kits sont temporaires et sont réinitialisées au redémarrage du serveur.

Les objets kit doivent être enregistrés dans la liste d’objets de ton framework. La configuration inclut les noms d’objets corrects pour QBCore et ESX. Pour les configurations standalone, le hook d’enregistrement des objets est un simple appel de fonction dans config.lua.

Options de configuration

Le config.lua offre un contrôle complet sur le comportement des kits :

• Niveaux de kits, définis autant de types de kits que tu le souhaites, chacun avec une réparation maximale, une vitesse de réparation et une durée d’animation.
• Verrouillage en combat", si les réparations peuvent être lancées lorsque le joueur est signalé comme étant en combat. Par défaut : désactivé pendant les combats.
• Seuil de dégâts entraînant l’interruption, le montant de dégâts reçus qui annule une réparation en cours. Définis cette valeur sur 0 pour que le moindre coup l’annule.
• Animation selon la zone endommagée, différentes animations sont jouées pour les dégâts au moteur, à la carrosserie et aux pneus.
• Intégration à l’économie, active le hook d’événement de fabrication pour que les métaux produits par Agency-Minerjob puissent servir à fabriquer des kits.

Compatibilité avec les frameworks

Agency-Repairkit inclut des adaptateurs intégrés pour QBCore et ESX. La détection du framework est automatique : dépose la ressource, elle détectera celui que tu utilises. Pour les serveurs standalone :

• Implémente Config.GetItem et Config.RemoveItem pour connecter ton système d’objets.
• Implémente Config.GetVehicleHealth et Config.SetVehicleHealth pour ta couche de dégâts des véhicules.
• Tout le reste (animations, interface, logique d’interruption) fonctionne sans modification.

Pourquoi c’est important pour le roleplay

Les dégâts aux véhicules sont l’une des sources de friction RP les plus fréquentes. Quand une mission tourne mal à 15 minutes du garage le plus proche, les joueurs doivent choisir : avancer péniblement et gâcher le rythme, abandonner et se téléporter, ou disposer d’une solution viable sur le terrain. Les kits de réparation offrent une troisième option qui se mérite, sans être gratuite.

Les kits à plusieurs niveaux créent des choix naturels pour la gestion de l’inventaire et de l’économie. Emportes-tu un kit professionnel « au cas où » et assumes-tu le coût de le transporter ? Ou comptes-tu sur des kits basiques, en acceptant que les dégâts importants nécessiteront un passage au garage ? Ce sont ces micro-décisions importantes qui rendent la gestion de l’inventaire concrète plutôt qu’arbitraire.

L’interruption des réparations en combat est particulièrement importante pour les scènes de poursuite RP. Sans elle, un joueur poursuivi pourrait réparer son véhicule en pleine course, ce qui ferait complètement retomber la tension. Avec cette fonctionnalité, les réparations ont lieu après le conflit ou entre les scènes, et ne peuvent pas servir de bouton d’urgence.

Questions fréquentes

Les mécaniciens peuvent-ils vendre des kits de réparation depuis leur menu ?

Oui. Agency-Repairkit déclenche un événement côté serveur agency-repairkit:giveKit que n’importe quel script de mécanicien peut appeler. Transmets l’ID serveur du joueur, le niveau du kit et la quantité. Il suffit d’ajouter un appel d’événement à la routine de vente de ton script de garage existant.

Le kit fonctionne-t-il sur les bateaux et les avions ?

Oui. Le système de dégâts utilise les propriétés natives de FiveM pour la santé des véhicules, qui s’appliquent à tous les types de véhicules. Pour les avions, l’animation est simplifiée (les joueurs ne peuvent pas se déplacer jusqu’à une zone de dégâts précise en plein vol), et les bateaux se réparent depuis le quai. Ces deux comportements sont configurables.

Puis-je limiter l’utilisation de certains niveaux de kit à certains métiers ?

L’accès aux kits selon le métier est pris en charge dans la définition de l’objet. Définis requiredJob = 'mechanic' sur un type de kit pour que seuls les joueurs de ce métier puissent l’utiliser. C’est pratique si tu veux réserver les kits professionnels aux mécaniciens plutôt que d’en faire un objet disponible à l’achat.

Comment le kit interagit-il avec les scripts de réapparition des véhicules ?

Agency-Repairkit déclenche agency-repairkit:onRepairComplete avec le netId du véhicule et le montant de la réparation lorsqu’un kit est utilisé avec succès. Tout script à l’écoute de cet événement peut réagir en conséquence. Ton script de persistance des véhicules peut, par exemple, signaler que le véhicule a été réparé sur le terrain à des fins de journalisation.

Prérequis

• Serveur FiveM (QBCore, ESX ou standalone)
• oxmysql (facultatif, pour le suivi persistant des kits)
• Compte cfx.re avec une licence Agency-Repairkit valide
• Enregistrement des objets du kit dans le framework

Équilibrer les kits de réparation dans l’économie de ton serveur

La question économique que les serveurs posent le plus souvent à propos d’Agency-Repairkit est : à quel point les kits devraient-ils être rares ? La réponse dépend de l’équilibre actuel de l’économie de ton serveur.

Si ton serveur compte des garages actifs avec un bon roleplay, rends les kits de base et avancés assez accessibles, mais garde les kits professionnels rares ou réservés aux mécaniciens. Les réparations importantes seront ainsi effectuées dans les garages, tandis que les petites réparations sur le terrain resteront possibles, ce qui permet au RP des mécaniciens de rester viable.

Si ton serveur peine à susciter l’intérêt des joueurs pour les métiers de mécanicien, réduis la disponibilité des kits de réparation sur le terrain et assure-toi que les kits fabriqués par les mécaniciens sont meilleurs que ceux disponibles dans le commerce. L’incitation économique à se rendre chez un mécanicien joueur doit être réelle, pas seulement narrative.

Si ton serveur a une économie criminelle bien développée, les kits fabriqués via Agency-Blackmarket ou par les joueurs créent un marché parallèle. Les kits de réparation de qualité militaire vendus au marché noir génèrent un RP logistique intéressant sans nuire au marché des mécaniciens civils.

Le principe essentiel : les réparations sur le terrain doivent être une option utile, pas la meilleure. Si les joueurs ne vont jamais dans les garages, tes kits sont trop puissants ou trop bon marché. Ajuste le rendement et le prix en même temps plutôt que l’un puis l’autre.