Marchands
Marchands lit la configuration des marchands d'un serveur DayZ : quel PNJ vend quoi, à quel prix
d'achat et de vente, avec quel stock. Vous l'utilisez quand vous faites tourner un serveur avec
TraderX, TraderPlus ou Expansion Market et que vous voulez trouver les erreurs que les joueurs peuvent exploiter,
modifier des prix, rééquilibrer tout le catalogue à partir de la rareté du loot, ou passer de
TraderPlus à TraderX. Il vous faut un dossier de profil serveur (le dossier donné au serveur avec
-profiles=, contenant TraderX/, TraderPlus/ ou ExpansionMod/) ; un profil d'exemple est fourni quand vous
n'en avez pas. Pour les vérifications de classes, il faut le dossier DayZ défini dans les
Paramètres, et pour les vérifications de rareté un dossier de mission.
La page ne lit que des fichiers de configuration. Elle n'ouvre jamais les données des joueurs :
comptes bancaires, coffres, garages, assurances ou registres de licences indexés par SteamID
(TraderXDatabase/, TraderPlusDatabase/), ni les journaux. Dans ExpansionMod/, elle ne lit
que Market/ et Traders/ : les comptes ATM, les groupes et le stockage personnel voisins ne
sont pas touchés.
L'écran
- En-tête : des badges pendant qu'un chargement est en cours, le nombre de modifications pas encore écrites, Suivi des enregistrements (recharge quand les fichiers sont enregistrés dans un autre éditeur), Recharger, et Vérifier et écrire, la seule façon d'écrire quoi que ce soit.
- Mod de marchands (ligne sous la barre d'outils) : les mods de marchands que la page connaît. TraderX, TraderPlus et Expansion Market sont pris en charge ; Trader de Dr_J0nes ne l'est pas encore. Celui du profil ouvert est marqué avec son format de fichiers ; survolez un nom pour voir ce que la page en fait et quel dossier elle cherche. Sans profil ouvert, un tableau donne la même chose par mod, et après l'ouverture d'un dossier que la page ne sait pas lire, un message dit ce qu'elle a cherché et quel autre mod de marchands elle y a trouvé.
- Barre d'outils : les profils récents, Ouvrir un profil…, Importer TraderPlus…,
Rareté depuis (la mission dont le
types.xmldonne la rareté, et un bouton dossier pour en choisir une autre), le nombre de classes du jeu et de mods chargés, un badge avec le mod et le format de catalogue détectés, et les onglets. - Onglet Produits : à gauche, Tous les produits, Sans catégorie, puis chaque marchand avec ses catégories et les catégories qu'aucun marchand ne liste. Au centre, une zone de recherche, la ligne de prix groupés et le tableau (icône, nom en jeu, achat, vente, stock max, coefficient, quantité ; un badge compte les problèmes du produit). À droite, l'inspecteur du produit sélectionné : rareté, fichier et ligne, catégories, constats, et les achat, vente et stock max modifiables.
- Onglet Audit : chaque constat avec sa gravité, son code de contrôle, son message, sa correction et son emplacement. Filtrez par gravité ou par contrôle. Un clic sur une ligne ouvre le produit ; Ouvrir ouvre le fichier à la ligne dans votre éditeur externe.
- Onglet Plan : l'objectif économique à gauche, Calculer le plan, et le résultat : les produits qui changent avec anciennes et nouvelles valeurs et la raison, les produits conservés et pourquoi.
- Onglet Paramètres : les fichiers de paramètres du mod à gauche, un formulaire pour le fichier sélectionné à droite (réglages généraux, monnaies, banque, garage, verrouillage de voiture, zones sûres...).
- Onglet Sauvegardes : une ligne par écriture, avec les fichiers qu'elle a remplacés et Restaurer.
Premiers pas
- Ouvrez la page et cliquez sur Ouvrir un profil…, puis choisissez le dossier de votre profil serveur. Sans serveur, cliquez sur Ouvrir le profil d'exemple sur la page vide.
- À côté de Rareté depuis, choisissez la mission de votre serveur (ou choisissez son dossier avec le bouton dossier).
- Dans le volet de gauche, cliquez sur une catégorie d'un marchand. Le tableau montre ses produits.
- Cliquez sur un produit. Dans l'inspecteur, saisissez un nouveau prix d'achat. La ligne reçoit un badge modifié et l'en-tête compte une modification non écrite.
- Ouvrez l'onglet Audit et lisez d'abord les erreurs.
- Arrêtez le serveur, cliquez sur Vérifier et écrire, relisez le diff, puis Écrire.
Suivre la visite guidée (dans l'app)
Tâches courantes
Trouver et corriger ce que les joueurs peuvent exploiter
- Ouvrez le profil et choisissez la mission.
- Ouvrez l'onglet Audit et cliquez sur Erreurs.
- Cliquez sur un constat pour ouvrir son produit, ou sur Ouvrir pour modifier le fichier dans votre éditeur.
- Corrigez le prix dans l'inspecteur, puis Vérifier et écrire.
Augmenter ou baisser beaucoup de prix d'un coup
- Dans l'onglet Produits, cliquez sur une catégorie ou lancez une recherche, et cochez les produits à modifier (ou n'en cochez aucun et utilisez la portée « produits affichés »).
- Dans la ligne Prix, choisissez la portée, achat / vente / achat et vente,
+ %ou= fixer, et un nombre (-10baisse de 10 %). - Cliquez sur Appliquer : les prix sont préparés. Les prix de
-1sont conservés. - Vérifier et écrire.
Rééquilibrer le catalogue à partir de la rareté
- Choisissez la mission, ouvrez l'onglet Plan.
- Définissez l'objectif : argent de départ, part de référence, ratio de vente ; laissez le reste à sa valeur par défaut au début.
- Calculer le plan, lisez les changements et les produits conservés.
- Vérifier et écrire dans l'en-tête du plan. Visite de ce flux de travail (dans l'app)
Changer un paramètre (frais de banque, zone sûre, position d'un marchand)
- Ouvrez l'onglet Paramètres et cliquez sur le fichier.
- Modifiez un champ : survolez son nom pour voir le sens, le type et la valeur par défaut tirés du code du mod. Dans une liste, la corbeille retire un élément et Ajouter ajoute une copie du dernier.
- Vérifier et écrire.
Convertir un profil TraderPlus en TraderX
- Cliquez sur Importer TraderPlus…, choisissez le dossier du profil TraderPlus, puis un dossier de profil cible qui n'a pas encore de configuration TraderX.
- Lisez l'aperçu : les fichiers à créer et les notes.
- Cliquez sur Créer. Rien n'est écrasé et les fichiers TraderPlus ne sont pas modifiés.
Annuler une écriture
- Ouvrez l'onglet Sauvegardes.
- Cliquez sur Restaurer sur la ligne de cette écriture. Les fichiers actuels sont d'abord sauvegardés.
Partir d'une recette
Son état vide montre les recettes de cette page en puces (Boutique de marchand, Configurer un marchand, Vendre de nouveaux objets au marchand) : un clic en lance une dans Beans Assistant, qui pose quelques questions, propose un plan et avance étape par étape avec des vérifications. Toutes les recettes ouvre tout le catalogue. Le panneau d'aide (F1) les liste aussi.
Exemples
- Un profil d'exemple (dans l'app) : un petit profil TraderX (format LEGACY) écrit dans
<temp>/beans-examples/trader-sample/: un marchand, quatre catégories, onze objets vanilla. Regardez comment un marchand liste des catégories et une catégorie des produits. Il est réécrit à chaque ouverture de l'exemple, donc les modifications que vous lui faites sont perdues. - L'audit sur l'exemple (dans l'app) : le même profil sur l'onglet Audit. Ses lunettes de
vision nocturne se vendent 450 et coûtent 300 (
sell-above-buy). Avec une mission choisie, des constats de rareté peuvent s'ajouter. - Formulaires de paramètres sur l'exemple (dans l'app) : le même profil sur l'onglet Paramètres : format du catalogue, réglages généraux (le PNJ marchand), monnaies.
Concepts
- Profil serveur : le dossier passé au serveur avec
-profiles=. Les mods y gardent leur configuration et leurs données. Vous pouvez aussi donner le dossierTraderX/TraderPlusou son dossier de config : le profil en est déduit. - Mods pris en charge : TraderX (version de contrat 1.0.2), TraderPlus V1 (2.5) et Expansion
Market (fichiers de catégories version 12, fichiers de traders version 13) : lecture, audit,
modification. Trader de Dr_J0nes (
Trader/TraderConfig.txt) est reconnu et nommé, mais ses fichiers ne sont pas lus : la page ne peut pas encore l'ouvrir. - Organisation d'Expansion Market, sous
ExpansionMod/:Market/<Nom>.json, une catégorie par fichier avec sesItems, etTraders/<Nom>.json, un type de marchand par fichier avec les catégories qu'il échange (noms des fichiers deMarketsans.json, avec en optionNom:0achat seul,Nom:1achat et vente,Nom:2vente seule) et les monnaies qu'il accepte. Un fichier de catégorie avec"IsExchange": 1définit les monnaies : ses objets sont de l'argent, qui vaut leur prix. - Prix et stock d'Expansion Market : un objet a une fourchette de prix et une fourchette de
stock. Son prix est
MaxPriceThresholdquand le marchand en détientMinStockThresholdet descend jusqu'àMinPriceThresholdàMaxStockThreshold. Des seuils de stock égaux et supérieurs à 0 donnent un stock statique : toujours disponible, àMinPriceThreshold. Ici, le prix d'achat estMinPriceThreshold(le prix d'un objet en stock) ; quand vous le modifiez,MaxPriceThresholdsuit dans la même proportion. Le prix de vente est un pourcentage du prix d'achat (SellPricePercent) : le modifier écrit ce pourcentage.-1renvoie au pourcentage de la zone de marchands ou au pourcentage global, que la page ne lit pas et compte pour 75. Le stock max estMaxStockThreshold; illimité s'écrit en stock statique (les deux à 1). - Non lu pour Expansion Market : les zones de marchands et leur stock courant, le
MarketSettings.jsonglobal et les PNJ marchands. Ils sont dans le dossier de mission (expansion/traderzones,expansion/settings), pas dans le profil. - Organisation de TraderX, sous
TraderX/TraderXConfig/:SourceConfig.json(preferredFormat),TraderXGeneralSettings.json(marchands, licences, états d'objets acceptés),TraderXCurrencySettings.json, et le catalogue dans l'un de trois formats : LEGACY (Products/prod_<name>_NNN.json,Categories/cat_<name>_NNN.json, le nom de fichier est l'id), CSV (Source/*.csv, compilé par le serveur au démarrage) ou COMPILED (Compiled/*_compiled.json). AussiTraderXPresets/presets_*.json, les parkings de véhicules, et les paquetsTraderXBanking/,TraderXGarage/,TraderXCarLock/,TraderXSafeZone/. - Organisation de TraderPlus, sous
TraderPlus/TraderPlusConfig/:TraderPlusPriceConfig.json(catégories avec des lignes de produitsClassName,Coefficient,MaxStock,TradeQuantity,BuyPrice,SellPrice),TraderPlusGeneralConfig.json,TraderPlusIDsConfig.json, et les réglages des véhicules, assurances, garage, banque, zone sûre et journalisation. Les ids de produits sont affichés sous la forme<category>/<class>. - Marchand, catégorie, produit : un marchand (un PNJ) liste des catégories ; une catégorie
liste des produits ; un produit est une classe du jeu avec un prix d'achat (ce que paie le
joueur), un prix de vente (ce que reçoit le joueur), un stock max et un coefficient (comment le
prix évolue avec le stock ; 1 = constant).
-1signifie non vendu, non achetable par le marchand, ou stock illimité. - Rareté : le
db/types.xmlde la mission (Central Economy) donne à chaque objet un nominal (combien le serveur en garde dans le monde), des tiers et des usages. L'audit considère comme rare un nominal de 1 à 5 (ou militaire en Tier4 seul jusqu'à 10). - Audit : vérifie les règles et références propres au mod, les classes face aux données du jeu, les boucles d'argent (vente au-dessus de l'achat, achat ici et revente là, chargeurs ou boîtes moins chers que leurs cartouches) et, avec une mission, les prix et le stock face à la rareté. Gravité : erreur (cassé ou exploitable), avertissement (probablement faux), info.
- Plan et application : un plan est un essai à blanc calculé à partir du profil, des données du jeu, de la mission et de l'objectif ; la même entrée donne le même plan. L'écrire passe par la même vérification que les modifications manuelles.
- Écritures : seules les valeurs modifiées sont écrites, le reste de chaque fichier garde sa
mise en forme ; les fichiers remplacés sont copiés dans
<profile>/TraderX/.beans-trader-backups/<UTC time>/(TraderPlus/pour TraderPlus), les 20 plus récents sont gardés.
Pièges
- Modifier pendant que le serveur tourne : le serveur enregistre sa propre copie par-dessus les fichiers. La boîte de dialogue de vérification vous rappelle de l'arrêter d'abord.
- Lire un audit court comme un profil sain : sans le dossier DayZ, les classes ne sont pas vérifiées ; sans mission, la rareté n'est pas vérifiée. L'onglet Audit dit quelles données manquent.
- Des classes de mods signalées comme inconnues : ajoutez les mods que fait tourner le serveur dans Central Economy → Mods ; l'audit utilise cette liste.
- Modifier dans un autre éditeur avec des modifications préparées ici : la page avertit au lieu de recharger. Écrivez ou abandonnez vos modifications, puis Recharger.
- Un prix de vente supérieur au prix d'achat, n'importe où, même entre deux marchands, est de l'argent gratuit : ce sont des erreurs dans l'audit.
- L'import n'écrase jamais un fichier : choisissez un profil cible sans configuration TraderX.
- Le profil d'exemple vit dans le dossier temporaire et est réinitialisé quand vous le rouvrez : n'y gardez aucun travail.
Pour les agents
- Outils de
dzt:trader_detect(mod, format, comptes d'un profil),trader_audit(constats ;mission,mods,other_mods,codes,min_severity,max),trader_plan(essai à blanc d'un objectif, avec le diff),trader_apply(écrit un plan, ou deschanges,values,arraysexplicites),trader_import(TraderPlus vers TraderX),trader_schemas(schémas JSON pour l'édition manuelle). Liés :ce_missions(dossiers de mission),server_report(inclut l'audit des marchands). Commandes :dzt trader-check <profile>,dzt trader-schemas <profile>. - Fichiers lus : les fichiers que le contrat du mod liste sous
<profile>/TraderX/ou<profile>/TraderPlus/(les organisations ci-dessus), les fichiers types de la mission pour la rareté, et les données du jeu déjà chargées pour Central Economy. Les données des joueurs, les journaux et les sauvegardes ne sont pas lus. - Fichiers écrits : seulement par Vérifier et écrire, Importer (nouveaux fichiers) et
Restaurer : les fichiers du contrat et le dossier de sauvegarde
.beans-trader-backups/. L'exemple est écrit dans<temp>/beans-examples/trader-sample/. Les paramètres gardent les profils récents et la mission. - L'assistant voit : le chemin du profil, le mod de marchands et sa version de contrat, l'onglet courant, le texte de recherche, le produit sélectionné (id et classe), le nombre de modifications en attente et les avertissements et erreurs de l'audit. Il propose l'action « Auditer mes marchands ».
- Ancres pour
studio_guide:traders-open,traders-mission,traders-tab-audit,traders-reviewet les autres listées dans le fichier de guide de la page. - La référence des formats, les codes d'audit et la formule de prix sont dans
docs/TRADERS.md.
Voir aussi
- Central Economy : le types.xml de la mission et la liste de mods que l'audit utilise.
- Launcher : les instances de serveur ; arrêtez le serveur avant d'écrire.
- Paramètres : le dossier DayZ et l'éditeur externe.
- Le Workbench