Agency-Minerjob : à quoi devrait vraiment ressembler un script de métier

Pourquoi les métiers semblent généralement sans intérêt

La plupart des scripts de métier FiveM suivent une boucle répétitive : aller à X, appuyer sur E, attendre, vendre à Y. Les joueurs le font une fois pour gagner de l’argent, ne s’y investissent jamais en roleplay et passent à autre chose. Agency-Minerjob a été conçu pour rendre un seul métier captivant pendant des dizaines d’heures, grâce à la progression, à la richesse des interactions sociales et à une production variable.

Une progression de compétences qui a du sens

Les mineurs progressent du rang de novice à celui de maître en environ 30 heures de jeu. Chaque palier débloque de nouveaux sites miniers, de meilleurs outils, des minerais plus rares et une extraction plus rapide. La progression ne se résume pas à un multiplicateur de revenus, elle débloque un gameplay réellement différent à chaque étape.

Mécaniques environnementales

La production minière dépend de la qualité du site, de l’heure, de la météo et de l’état des outils. La mine d’or, la nuit, par temps clair et avec une pioche bien entretenue, produit des résultats différents de ceux d’un filon de charbon sous la pluie avec un outil usé. Ces variables ne sont pas évidentes pour les nouveaux joueurs, mais les mineurs expérimentés apprennent à les optimiser. C’est précisément ce type de maîtrise émergente qui rend les métiers intéressants sur le long terme.

Richesse des interactions sociales

Le minage permet de former des groupes de 2-6 joueurs avec des réserves d’XP partagées et des multiplicateurs bonus. Les grands groupes gagnent davantage, mais attirent plus l’attention des groupes qui cherchent à les braquer. Cela crée de véritables interactions sociales en jeu, où la coordination compte et où la confiance entre les joueurs devient une monnaie en jeu.

L’impact sur l’économie

Les minerais bruts alimentent des chaînes de transformation dont dépend le reste de l’économie du serveur. Les fabricants d’armes ont besoin de métaux. Les constructeurs ont besoin de matériaux de construction. Agency-Minerjob n’est pas une boucle répétitive isolée, c’est un rôle de fournisseur au sein d’un système économique plus vaste. C’est ce qui donne une réelle importance à un métier pour le serveur.

Installation & configuration

Agency-Minerjob nécessite oxmysql pour les données de progression des joueurs et le suivi du rendement des minerais. Importe minerjob.sql, dépose le dossier de la ressource et ajoute ensure agency-minerjob à server.cfgLes coordonnées des sites miniers, les définitions des types de minerais et les objets de la chaîne de raffinage sont tous définis dans config.luala configuration par défaut comprend huit sites miniers répartis sur la carte GTA V d’origine.

Les objets minerais et les objets de matériaux raffinés doivent exister dans le registre d’objets de ton framework. La configuration inclut des définitions complètes d’objets pour QBCore et ESX. Les configurations standalone gèrent l’ajout et le retrait des objets via des hooks de configuration.

Options de configuration

Le config.lua offre un contrôle approfondi des mécaniques du métier :

• Qualité des siteschaque site minier possède un modificateur de rendement de base. Les sites de meilleure qualité offrent un meilleur rendement par action, mais peuvent nécessiter un niveau de compétence plus élevé pour y accéder.
• Seuils des paliers de compétencedéfinis l’XP requise pour chaque palier et les éléments déverrouillés à chaque palier (sites, outils, types de minerais).
• Modificateurs environnementauxactive ou désactive les effets de la météo et de l’heure sur le rendement, et définis la plage de multiplicateurs.
• Durabilité des outilsdéfinis le nombre d’actions de minage qu’un outil peut effectuer avant de devoir être réparé. Désactive cette option pour un gameplay plus simple.
• Bonus de groupedéfinis le multiplicateur d’XP et de rendement pour chaque membre supplémentaire du groupe, ainsi que la taille maximale du groupe.
• Système d’embuscadeactive les embuscades de PNJ ou de joueurs et définis les seuils de taille du groupe qui les déclenchent.
• Chaîne de raffinagedéfinis quels minerais bruts sont transformés en quels matériaux, selon quel ratio et avec quel temps de traitement.

Compatibilité avec les frameworks

Des adaptateurs complets pour QBCore et ESX sont inclus. Pour une configuration standalone, implémente cinq fonctions de configuration : ajout/retrait d’objets, ajout d’argent, vérification du métier (pour l’accès aux zones minières) et stockage de l’XP. Le moteur de progression des compétences, le système de groupe, les mécaniques environnementales et la chaîne de raffinage sont tous indépendants du framework.

Pourquoi c’est important pour le roleplay

Un métier qui ne sert qu’à gagner de l’argent semblera toujours creux. Agency-Minerjob fait du minage une véritable profession, avec une réelle profondeur : un personnage qui mine pendant 30 heures a véritablement développé quelque chose, une connaissance des sites, une maîtrise des outils, un réseau de membres de groupe, des relations avec les raffineurs et les acheteurs. Ce capital accumulé par le personnage rend le RP du métier durable.

Le système de groupe, en particulier, crée un RP social que la plupart des scripts de métier ignorent complètement. Deux joueurs qui minent ensemble ne font pas que doubler leur rendement, ils discutent, développent leur confiance et décident s’ils vont inviter une troisième personne qu’ils ne connaissent pas encore très bien. Le risque d’embuscade dans les groupes plus nombreux impose d’évaluer cette confiance : est-ce que ça vaut le coup d’inviter cet inconnu s’il fait de nous une cible plus visible ?

L’intégration de la chaîne d’approvisionnement est la fonctionnalité qui fait passer Agency-Minerjob de « script de minage » à « couche de l’économie du serveur ». Lorsque les fabricants d’armes, les constructeurs et les fabricants de kits de réparation ont tous besoin de matériaux issus du minage, le métier de mineur devient essentiel à long terme. Les mineurs ne farm pas seuls, ils approvisionnent les autres joueurs et entretiennent des relations avec leurs acheteurs.

Questions fréquentes

Puis-je ajouter des sites miniers à des emplacements personnalisés sur une carte de DLC ou un MLO ?

Oui. Les sites miniers sont définis dans config.lua par des coordonnées et un rayon. Ajoute les coordonnées intérieures de ton MLO avec un indicateur d’intérieur, et Agency-Minerjob détectera automatiquement l’entrée dans l’intérieur. Ajouter des types de minerais personnalisés à des emplacements personnalisés est tout aussi simple.

Comment la progression des compétences est-elle sauvegardée après les redémarrages ?

Les données de compétence sont stockées dans oxmysql et associées à l’identifiant du joueur. La progression est conservée après les redémarrages, les changements de framework et les changements de personnage (avec les systèmes multpersonnages). La progression est réinitialisée uniquement si tu exécutes manuellement la requête SQL de réinitialisation ou si l’identifiant du joueur change.

Puis-je désactiver les mécaniques environnementales pour un serveur plus simple ?

Oui. Définis Config.UseEnvironmentalModifiers = false dans config.lua. Le rendement dépend alors uniquement du palier de compétence, de la qualité de l’outil et de celle du site, pour un système plus simple, mais toujours basé sur des paliers. Tu peux réactiver les mécaniques environnementales plus tard, la progression existante des joueurs sera conservée sans interruption.

Agency-Minerjob est-il équilibré pour les serveurs où le minage est la principale source de revenus, par rapport à ceux où il n’est qu’un métier parmi d’autres ?

La configuration de base part du principe que le minage est l’un des différents choix de métier. Si c’est ta principale source de revenus, augmente les taux de rendement de 40-60 % partout, il existe un Config.GlobalYieldMultiplier conçu exactement dans ce but. Ne modifie pas les taux de chaque emplacement pour compenser, utilise le multiplicateur global afin de préserver l’équilibre relatif.

Prérequis

• Serveur FiveM (QBCore, ESX ou standalone)
• oxmysql
• compte cfx.re avec une licence Agency-Minerjob valide
• Facultatif : Agency-Repairkit (pour l’intégration de fabrication)
• Facultatif : Agency-Blackmarket (pour la connexion à l’économie de vente de minerais)

Gérer une compagnie minière comme une entreprise

Le système de groupe et le suivi de progression d’Agency-Minerjob permettent de gérer de véritables compagnies minières comme des entreprises sur le serveur, plutôt que de simplement miner en solo. Voici à quoi ressemble concrètement une exploitation minière :

Le personnage propriétaire de l’entreprise recrute des travailleurs (d’autres joueurs), les affecte à des sites miniers selon leur niveau de compétence et organise la vente en gros de matériaux raffinés aux fabricants d’armes, aux constructeurs ou au marché noir. La coordination de plusieurs mineurs, la gestion des stocks d’outils (en veillant à ce que tout le monde dispose de bons outils) et la protection des importants chargements de minerai contre les détournements créent une véritable complexité organisationnelle.

Le multiplicateur de bonus de groupe crée une incitation économique à se coordonner, qui n’a pas été conçue artificiellement, elle découle des mécaniques. Cinq mineurs coordonnés gagnent beaucoup plus par heure que cinq mineurs en solo qui font la même chose, ce qui signifie que la coordination du travail a un avantage économique mesurable. C’est la condition de conception qui rend les organisations commerciales viables : l’organisation doit être plus rentable que le travail en solo, sinon les joueurs ne s’embêteront pas avec les contraintes de la coordination.