Agency-Blackmarket : créer une économie clandestine sans déstabiliser le serveur

Pourquoi la plupart des scripts de marché noir échouent

Un script de marché noir mal conçu est le moyen le plus rapide de ruiner l’économie d’un serveur. Trop bon marché et tout le monde devient criminel. Trop cher et personne ne l’utilise. Trop sûr et il n’y a aucun risque. Trop risqué et les joueurs se lassent. Agency-Blackmarket a été conçu en donnant la priorité à l’équilibre économique, avant la liste des fonctionnalités.

Tarification dynamique selon la demande

Le prix de chaque article évolue en fonction du nombre de joueurs qui l’ont acheté récemment. L’offre et la demande se régulent automatiquement : si tout le serveur achète des AR-15, le prix double en quelques heures. Quand la demande baisse, les prix reviennent lentement à la normale. Cela crée des rythmes de marché naturels au lieu de listes de prix fixes.

Le facteur risque

Chaque visite au marché noir peut, selon une probabilité configurable, déclencher une alerte de la police, une embuscade ou une rencontre avec un PNJ rival. Le risque augmente en fonction du montant de l’achat. Les joueurs prudents apprennent à répartir les gros achats sur plusieurs visites. Les moins prudents se font attraper et perdent leur butin. C’est cette tension qui rend le RP illégal intéressant.

Outils d’administration

Chaque transaction est enregistrée avec l’ID du joueur, l’article, le prix et l’horodatage. Les administrateurs peuvent consulter en un coup d’œil l’économie parallèle du serveur, définir des prix planchers ou désactiver temporairement certains articles. C’est grâce à ces outils que les communautés RP professionnelles nous font confiance pour leurs scripts économiques essentiels : nous ne vendons pas seulement des fonctionnalités, nous fournissons la couche de gestion qui permet de les faire fonctionner à grande échelle.

Intégration à tes métiers

Agency-Blackmarket expose des événements auxquels Agency-Minerjob, Agency-Admin et tes scripts de police peuvent réagir. L’écosystème se renforce : chaque script est utile individuellement, mais ensemble, ils créent des comportements émergents systémiques impossibles à scripter manuellement.

Installation & configuration

Agency-Blackmarket nécessite oxmysql pour l’enregistrement des transactions et la persistance des prix dynamiques. Importe blackmarket.sql, dépose le dossier de la ressource et ajoute ensure agency-blackmarket à server.cfg. Les coordonnées des emplacements sont définies dans config.luaLa ressource inclut six coordonnées par défaut pour le marché noir sur la carte GTA V par défaut, que tu peux remplacer par les positions de tes MLO personnalisés.

Les articles proposés à la vente doivent exister dans le registre d’articles de ton framework. La configuration inclut une liste d’articles par défaut, et l’ajout ou la suppression d’articles se fait en modifiant directement une table de configuration.

Options de configuration

Le config.lua te donne un contrôle total sur l’économie et les paramètres de risque :

• Catalogue d’articles, définis chaque article, son prix de base, son prix plancher, son prix plafond et son facteur d’élasticité de la demande.
• Période de demande, le nombre d’heures d’historique des achats pris en compte par l’algorithme de tarification. Par défaut : 6 heures.
• Événements à risque, configure les chances de déclenchement d’une alerte de police, d’une embuscade et de l’apparition de PNJ rivaux selon le montant de chaque achat.
• Rotation des emplacements, les emplacements du marché noir peuvent changer selon un calendrier, ce qui pousse les joueurs à rester attentifs aux réseaux d’information en jeu pour trouver l’emplacement actuel.
• Ajustement manuel des prix par les admins, les admins seniors peuvent définir temporairement un prix plancher ou plafond pour chaque article lors d’événements économiques.
• Conservation du journal des transactions, nombre de jours pendant lesquels l’historique des achats est conservé. Par défaut : 30 jours.

Compatibilité avec les frameworks

Les adaptateurs QBCore et ESX sont fournis avec le package. Pour standalone, implémente quatre fonctions de configuration : donner un objet, retirer de l’argent, déclencher une alerte à la police et, en option, restreindre l’accès en fonction du métier. Le moteur de tarification, le système d’événements à risque, la gestion des lieux et les outils d’administration sont entièrement indépendants des frameworks.

Pourquoi c’est important pour le roleplay

Une économie illégale qui fonctionne sans risque finit par ressembler à une simple virée shopping. Le système de risque d’Agency-Blackmarket est conçu spécifiquement pour que chaque achat important ressemble à une décision, et non à une transaction. Le joueur qui passe dix minutes à planifier un gros achat d’armes, à repérer les lieux, à choisir le bon moment et à décider s’il doit venir avec des renforts fait un meilleur RP que celui qui ouvre simplement un menu et clique sur Acheter.

La tarification dynamique crée une pénurie naturelle sans intervention des admins. Quand tout le serveur se prépare à un conflit planifié, la hausse du prix des armes est visible pour tous les joueurs qui consultent le marché. Les criminels avisés apprennent à acheter avant que la demande n’augmente. Ce comportement économique émergent ajoute une profondeur stratégique que des menus à prix fixes et prédéfinis ne peuvent jamais offrir.

Le tableau de bord des transactions pour les admins, c’est à ça que ressemble une gestion responsable de l’économie RP. Quand l’économie illégale d’un serveur manque de transparence, les admins ne peuvent pas savoir si elle est équilibrée ou déréglée avant que les joueurs commencent à se plaindre. Avec une visibilité complète sur les transactions, tu peux voir en temps réel si un joueur ou un groupe achète de façon disproportionnée, et intervenir avant que le déséquilibre ne nuise à l’écosystème criminel du serveur.

Questions fréquentes

Puis-je réserver certains objets à des organisations criminelles spécifiques ?

Oui. Chaque objet du catalogue peut avoir un champ requiredFlag facultatif. Les joueurs disposant de ce statut (géré via Agency-Admin ou ton propre système) peuvent voir et acheter l’objet ; pour les autres, il apparaît grisé avec la mention « restreint ». Cela permet de créer un marché noir à plusieurs niveaux, où les rôles criminels de haut rang ont accès à un meilleur inventaire.

Comment fonctionne l’événement d’embuscade ?

Lorsqu’une embuscade se déclenche, un groupe de PNJ hostiles apparaît sur le lieu du marché noir et attaque immédiatement le joueur. Le nombre de PNJ et leur équipement varient selon le montant de l’achat qui a déclenché l’événement. Les joueurs qui survivent à l’embuscade gardent leur achat ; ceux qui n’y survivent pas le perdent au profit du système de butin. C’est volontairement impitoyable, le risque doit être réel.

Les données de tarification peuvent-elles être exportées pour une analyse externe ?

Le journal des transactions dans oxmysql peut être interrogé directement. Nous proposons aussi un export côté serveur exports['agency-blackmarket']:GetPriceHistory(item, hours) qui renvoie un tableau d’instantanés des prix. Connecte-le à l’outil de tableau de bord externe de ton choix pour visualiser l’évolution de l’économie illégale de ton serveur au fil du temps.

Comment empêcher un joueur de manipuler le système de demande pour faire varier les prix à son avantage ?

Définis Config.PerPlayerDemandCap = true et Config.MaxPlayerDemandWeight = 0.3. Cela limite l’influence de l’historique des achats d’un seul joueur sur le prix global. Un acheteur peut toujours manipuler la demande, mais il lui faut une coordination soutenue entre plusieurs joueurs pour faire varier les prix de façon significative.

Prérequis

• Serveur FiveM (QBCore, ESX ou standalone)
• oxmysql
• Compte cfx.re avec une licence Agency-Blackmarket valide
• Facultatif : Agency-Admin (pour intégrer le tableau de bord de suivi des transactions)

Événements économiques saisonniers via les contrôles de prix admin

Les outils de tarification admin d’Agency-Blackmarket permettent de concevoir une économie rythmée par des événements. Voici quelques idées qui fonctionnent bien :

Course aux armements : Baisse les prix des armes de 30% pendant 48-hour et annonce-le en jeu via des bulletins d’information diffusés par des PNJ. Cela crée une courte période d’activité criminelle accrue, à laquelle la police peut se préparer. La période prend fin avant que l’économie ne se déséquilibre.

Choc d’approvisionnement : Désactive temporairement une catégorie d’objets (aucun explosif disponible pendant une semaine). La pénurie entraîne de la thésaurisation, des échanges au marché noir entre joueurs et du RP autour de la rupture de stock. Rétablis la disponibilité et regarde le marché se normaliser.

Introduction d’une nouvelle contrebande : Lance un nouvel objet à prix élevé avec une faible baisse de la demande. Les premiers acheteurs paient le prix fort. À mesure que les autres joueurs le découvrent, la demande augmente et les prix grimpent avant de se normaliser. L’historique des prix raconte comment ta communauté a adopté le nouvel objet.

Ces événements économiques ne nécessitent pas de programmer une logique personnalisée, il s’agit de modifications de configuration effectuées par les admins. C’est tout l’intérêt : les admins de serveur qui ne sont pas développeurs peuvent organiser des événements économiquement intéressants en utilisant uniquement le panneau d’administration d’Agency-Blackmarket.