Script de trading CodeM (ESX/QB)

Script de trading CodeM – Système sécurisé d'échange d'objets et de devises entre joueurs

CodeM Trading Script permet des échanges sécurisés et intuitifs entre joueurs sur votre serveur FiveM. Ce système d'échange complet propose l'échange d'objets en temps réel, les transactions de devises, une double confirmation, une protection anti-fraude, l'historique des échanges, une interface utilisateur moderne, les échanges basés sur la distance et une intégration complète au framework, créant ainsi un marché sécurisé où les joueurs peuvent échanger directement objets, véhicules et argent sans intervention de l'administrateur ni risque de drop trading.

Ce qui est inclus

Ce pack d'échange complet comprend une interface de fenêtre d'échange sécurisée affichant les offres des deux parties, l'échange d'objets prenant en charge tous les articles de l'inventaire avec des contrôles de quantité, le commerce d'argent avec des limites configurables, un système de double confirmation exigeant l'acceptation des deux joueurs, des mises à jour d'échange en temps réel à mesure que des objets sont ajoutés ou supprimés, l'annulation d'un échange permettant à l'une ou l'autre des parties d'annuler l'échange, des protections anti-fraude empêchant la duplication d'objets et les exploits, un historique des échanges suivant les transactions terminées, le commerce basé sur la distance exigeant une proximité physique, des mécanismes de délai d'expiration empêchant les échanges ouverts indéfiniment et une journalisation complète pour la résolution des litiges.

Caractéristiques principales

• Fenêtre de négociation sécurisée – Interface à écran partagé affichant vos offres d'un côté et celles de votre partenaire de l'autre, avec une séparation visuelle claire.
• Échange d'articles – Échangez n'importe quel article de votre inventaire avec sélection de la quantité, vérification du poids et conservation des métadonnées (accessoires d'armes, durabilité, etc.).
• Trading d'argent – Échangez de l'argent liquide et des articles avec des limites de transaction minimales/maximales configurables et une prise en charge de l'argent noir (ESX)
• Double confirmation – Les deux joueurs doivent cliquer sur Accepter pour que la transaction soit exécutée, afin d'éviter les transactions précipitées ou accidentelles.
• Mises à jour en temps réel – La fenêtre d'échange se met à jour instantanément lors de l'ajout ou de la suppression d'articles, affichant les offres actuelles avant la confirmation finale.
• Annulation des transactions Chacune des parties peut annuler la transaction à tout moment avant la confirmation finale, avec retour automatique de l'article.
• Protection contre la duplication – La validation côté serveur empêche les exploits de duplication d'objets et la manipulation des inventaires.
• Exigences de distance – Les joueurs doivent se trouver à une distance configurable pour initier et maintenir des échanges, ce qui empêche les tentatives d'escroquerie à distance.
• Demandes d'échange – Envoyer des demandes d'échange aux joueurs à proximité en leur indiquant qu'ils peuvent accepter ou refuser.
• Historique commercial – Un registre complet de toutes les transactions effectuées, avec horodatage, articles échangés et participants, pour le règlement des litiges.
• Système de temporisation – Les transactions sont automatiquement annulées après une période d'inactivité configurable, évitant ainsi les transactions en suspens indéfiniment.
• Vérification du poids – Vérifie que les deux joueurs disposent d'une capacité d'inventaire suffisante avant d'autoriser l'exécution de l'échange.
• Système de liste noire – Configurer les objets qui ne peuvent pas être échangés (outils d'administration, objets spéciaux, objets de quête)
• Délais de recharge des échanges – Périodes de refroidissement optionnelles entre les transactions pour empêcher le spam et la manipulation de marché
• Bruitage – Retour audio pour les demandes d'échange, les ajouts d'articles, les confirmations et les finalisations

Parfait pour

• Serveurs économiques – Permet une économie gérée par les joueurs avec échange direct d'objets et de devises sans marchands PNJ
• Serveurs de jeu de rôle – Prend en charge des scénarios commerciaux réalistes tels que les jeux de rôle de marchand, les transactions commerciales et la vente d'objets personnels
• Serveurs de survie – Essentiel pour le commerce des ressources, les échanges d'équipements et la coopération communautaire
• Serveurs publics – Empêche les escroqueries liées au drop trading en fournissant un mécanisme d'échange sécurisé et transparent
• Communautés sur liste blanche – Facilite l'interaction et le commerce entre les joueurs au sein de communautés fermées.
• Emploi Systèmes – Permet de réaliser des transactions commerciales telles que l'achat de fournitures auprès de grossistes ou la vente de produits aux clients.

Flux de travail du processus de négociation

Initiation des échanges : Un joueur s'approche d'un autre joueur (dans un rayon configurable, généralement de 3 à 5 mètres) et ouvre le menu d'échange en sélectionnant le joueur cible. Ce dernier reçoit une notification avec le nom du vendeur et peut accepter ou refuser l'échange. En cas d'acceptation, une fenêtre d'échange s'ouvre simultanément pour les deux joueurs.

Ajout d'offres : Chaque joueur ajoute indépendamment des objets de son inventaire et/ou de l'argent à son échange. Les objets ajoutés apparaissent en temps réel dans les fenêtres d'échange des deux joueurs. Il est possible de retirer des objets avant la confirmation finale. Un contrôle du poids permet de s'assurer que le joueur recevant l'objet dispose de suffisamment d'espace dans son inventaire.

Phase de confirmation : Lorsque les deux joueurs sont satisfaits des propositions, chacun clique sur le bouton Accepter. La première acceptation affiche le statut « En attente de l'autre joueur ». Une fois les deux acceptations effectuées, un court compte à rebours (3 à 5 secondes) se déclenche pour permettre une dernière vérification. Chaque joueur peut encore annuler pendant ce compte à rebours.

Exécution des transactions : Après le compte à rebours, les objets et l'argent sont transférés simultanément entre les inventaires. Le serveur valide tous les transferts afin d'éviter les doublons. Une notification de réussite s'affiche pour les deux joueurs. La fenêtre d'échange se ferme automatiquement. La transaction est enregistrée dans l'historique.

Annulation: Chaque joueur peut cliquer sur Annuler à tout moment avant la fin du compte à rebours. Tous les objets proposés sont immédiatement restitués à leurs propriétaires d'origine. La fenêtre d'échange se ferme et une notification d'annulation s'affiche.

Protections anti-escroquerie

Validation côté serveur : Toutes les transactions sont exécutées côté serveur avec des contrôles de validation garantissant que les joueurs possèdent bien les objets proposés, qu'ils disposent de suffisamment d'espace dans leur inventaire pour les recevoir, que les montants sont exacts et conformes aux limites, que les objets ne sont pas dupliqués lors du transfert et que les métadonnées sont correctement conservées. L'affichage côté client est vérifié par rapport à l'autorité du serveur afin d'empêcher toute manipulation.

Système de confirmation : L'exigence d'une double confirmation empêche les arnaques par changement rapide d'offre, où les traders modifient leurs propositions à la dernière seconde. Le compte à rebours de 3 à 5 secondes après l'acceptation des deux parties permet une dernière vérification. Les mises à jour en temps réel affichent précisément l'offre de chaque joueur avant l'exécution.

Application des distances : Les échanges sont automatiquement annulés si les joueurs s'éloignent trop l'un de l'autre pendant la transaction, évitant ainsi qu'un joueur ne prenne la fuite. La vérification de proximité est effectuée en continu durant toute la durée de l'échange.

Journalisation des échanges : Les journaux de transactions complets permettent aux administrateurs d'enquêter sur les échanges litigieux, de vérifier les objets échangés, d'identifier les tentatives d'escroquerie et de résoudre les conflits grâce à des preuves. Ces journaux comprennent les identifiants des joueurs, les objets échangés, les quantités, les horodatages et le statut de la transaction (réussite ou annulation).

Spécifications techniques

• Performance: Impact serveur d'environ 0,015 ms, opérations d'inventaire et validation optimisées
• Base de données: Conserve l'historique des transactions avec les données des participants, les articles échangés et les horodatages des transactions.
• Systèmes d'inventaire : Compatible avec ox_inventory, qb-inventory, qs-inventory, esx_inventory et les solutions personnalisées
• Technologie de l'interface utilisateur : Interface utilisateur moderne avec un design adaptatif et une synchronisation en temps réel
• Sécurité: Validation côté serveur de toutes les opérations afin de prévenir les exploits et la duplication
• Taille du fichier: Environ 6 Mo, y compris les éléments d'interface utilisateur, les effets sonores et la configuration.

Installation

1. Téléchargez le package CodeM Trading Script depuis votre confirmation d'achat
2. Extrayez la ressource dans le répertoire des ressources de votre serveur.
3. Importez le fichier SQL fourni pour créer une table de base de données d'historique des transactions.
4. Configurez les paramètres du framework dans config.lua (ESX/QBCore détection)
5. Définissez des limites de distance commerciale, des délais de confirmation et des périodes de refroidissement.
6. Configurer les limites de transfert d'argent et les articles sur liste noire
7. Personnalisez les couleurs et les positions de l'interface utilisateur pour qu'elles correspondent au thème du serveur.
8. Ajouter assurer le commerce de codem vers server.cfg
9. Redémarrez le serveur et testez les échanges entre deux joueurs.
10. Vérifiez que tous les éléments sont transférés correctement avec préservation des métadonnées.

Compatibilité du framework

• ✅ Héritage ESX – Intégration complète avec l'inventaire ESX, les systèmes monétaires (espèces/argent sale) et les données des joueurs
• ✅ QBCore – Prise en charge complète du rôle de quarterback, incluant les métadonnées d'inventaire, la gestion des espèces et la gestion des joueurs
• ✅ QBOX – Compatible avec les fonctionnalités modernes du framework QBOX
• ✅ Autonome – Peut fonctionner avec des frameworks personnalisés via la configuration du pont d'inventaire

Options de configuration

• Distance commerciale : Définir la distance maximale entre les joueurs pour initier et maintenir les échanges (par défaut : 3 à 5 mètres).
• Délai de confirmation expiré : Durée du compte à rebours après l'acceptation des deux parties avant l'exécution (par défaut : 3 à 5 secondes)
• Délai d'inactivité expiré : Annulation automatique des transactions après X minutes d'inactivité (par défaut : 2 à 5 minutes)
• Limites monétaires : Définissez des montants minimum et maximum en espèces par transaction afin d'éviter les microtransactions ou les transferts excessifs.
• Délai de réapprovisionnement des échanges : Exiger un délai de X secondes entre les échanges consécutifs par joueur (optionnel, empêche le spam)
• Articles sur liste noire : Définir les objets qui ne peuvent pas être échangés (outils d'administration, objets de quête, armes spéciales).
• Bruitage: Activer/désactiver le retour audio et personnaliser les fichiers sonores
• Personnalisation de l'interface utilisateur : Ajustez les couleurs, les positions, la transparence et le style pour correspondre à l'esthétique du serveur.

Histoire du commerce et de l'exploitation forestière

Chaque transaction effectuée est enregistrée dans une base de données avec des informations complètes, notamment les identifiants des deux joueurs (licence, Steam, etc.), tous les objets échangés avec leurs quantités, les montants transférés, l'horodatage précis et le statut de la transaction (réussie ou non). Les administrateurs peuvent consulter l'historique des transactions pour enquêter sur les activités suspectes, résoudre les litiges concernant les objets manquants, suivre l'activité du marché et les objets populaires, identifier les failles potentielles ou les comportements inhabituels, et fournir des preuves pour les demandes de suspension ou les signalements.

L'intégration optionnelle d'un webhook Discord envoie des notifications en temps réel des transactions à forte valeur ajoutée (seuil configurable), aidant ainsi les administrateurs à surveiller l'économie afin de détecter toute manipulation ou tentative de RMT (échange d'argent réel).

Possibilités d'intégration

• Scripts de boutique : Les propriétaires d'entreprises peuvent transférer les stocks de leurs magasins sans utiliser les commandes d'administration.
• Systèmes d'emploi : Faciliter les échanges entre professionnels, comme les mécaniciens qui achètent des pièces détachées à des fournisseurs ou les chefs qui achètent des ingrédients.
• Systèmes de gangs : Les membres d'un gang échangent des armes, de la drogue ou des ressources au sein de l'organisation.
• Scénarios de logement : Échangez des meubles, des clés de propriété ou des décorations d'habitation entre joueurs
• Scripts de véhicules : Échangez la propriété du véhicule via le système d'échange (si celui-ci est configuré pour prendre en charge les articles liés aux véhicules).
• Systèmes d'artisanat : Les joueurs échangent des matières premières ou des produits artisanaux pour soutenir les chaînes de production.

Ce qui le distingue

Le script CodeM Trading élimine la pratique dangereuse du « drop trading », où les joueurs déposent des objets au sol en espérant être payés. Cette pratique est facilement exploitable : les joueurs peuvent s'enfuir avec les objets, des tiers peuvent les récupérer, ou des escrocs peuvent prétendre ne jamais les avoir reçus. Ce script offre un système d'échange sécurisé, transparent et simultané, où personne ne peut prendre d'objets sans respecter l'offre convenue. L'interface en temps réel affiche précisément l'offre de chaque joueur avant son exécution, empêchant ainsi les arnaques. La double confirmation avec compte à rebours évite les décisions hâtives. Plus important encore, la validation côté serveur rend les exploits et la duplication impossibles, créant ainsi un environnement d'échange fiable, même sur les serveurs publics.

Amélioration de l'économie

Le système d'échange sécurisé permet une véritable économie gérée par les joueurs, où chacun se spécialise dans la collecte, l'artisanat ou la revente, créant ainsi une dynamique de marché. Les collecteurs de ressources vendent des matières premières aux artisans, qui à leur tour vendent des produits finis aux consommateurs, établissant ainsi des chaînes d'approvisionnement. La fixation des prix se fait naturellement par la négociation, et non par des prix fixes proposés par les PNJ. L'échange favorise les interactions sociales : les joueurs doivent communiquer, négocier et se rencontrer en personne, plutôt que de passer par des salles de vente impersonnelles. Cela génère un jeu de rôle authentique et renforce la cohésion de la communauté.

Exemples de cas d'utilisation

Jeu de rôle marchand : Le joueur crée un stand sur la plateforme et échange avec les clients. Ces derniers consultent les articles, négocient les prix et effectuent des transactions sécurisées. Le vendeur suit les ventes grâce à l'historique des transactions et gère la rotation des stocks.

Trafics de drogue : Un criminel vend de la drogue à un autre joueur via le système d'échange. Les deux parties confirment les quantités et le paiement avant l'exécution. police Interrompre la transaction : l’un ou l’autre peut l’annuler instantanément. Aucune preuve à récupérer.

Ventes d'équipement : Le mécanicien fabrique des pièces automobiles et les vend à ses clients. Le client paie en espèces, reçoit les pièces, la transaction est terminée. Le mécanicien conserve une preuve de vente dans son historique en cas de contestation ultérieure.

Commerce des ressources : Le mineur vend du minerai à l'artisan. L'artisan le transforme en lingots et les vend à l'armurier. L'armurier fabrique des armes à feu et les vend aux membres du gang. Un circuit de production complet, facilité par des échanges sécurisés.

Fonctionnalités d'administration

Les administrateurs de serveur disposent de contrôles spécifiques, notamment la consultation de l'historique complet des échanges, la recherche d'échanges par identifiant de joueur, le filtrage par type ou valeur d'objet, l'exportation des journaux d'échanges pour analyse, la détection des schémas d'échange suspects et la possibilité de bloquer certains joueurs (délai de récupération ou liste noire). Le panneau d'administration fournit des informations sur l'économie du serveur, telles que les objets les plus échangés, la valeur moyenne des transactions et l'activité commerciale par moment de la journée.

Assistance et mises à jour

Inclut des mises à jour à vie avec de nouvelles fonctionnalités, des mises à jour de compatibilité avec le framework, des correctifs de sécurité et des corrections de bugs. Une documentation complète couvre l'installation, la configuration, l'intégration du système d'inventaire, le dépannage et les bonnes pratiques de gestion économique. Assistance active via un système de tickets pour l'assistance technique et la personnalisation. Des mises à jour régulières ajoutent des fonctionnalités demandées par la communauté, comme le commerce de véhicules, les modèles d'échange et le filtrage avancé.

Scripts ESX associés

• Scénario de la plante de marijuana
• Scénario du motel FiveM
• Vol de distributeur automatique de billets (explosion de C4, animation de forage)
• Affichage tête haute V5 de Wais (ESX/QB)