Config (CfgConvert)
Un mod DayZ déclare ce qu'il ajoute au jeu dans une config (config.cpp) : chaque objet,
arme ou véhicule est une classe avec des propriétés, et la plupart des classes héritent d'une
classe du jeu. Cette page fait deux choses. Convertir et vérifier trouve les erreurs de votre
config.cpp et le convertit en config.bin, la forme binaire que le jeu charge, ou retransforme
un config.bin en texte lisible ; il remplace CfgConvert des DayZ Tools. Navigateur de config
du jeu montre toutes les classes du jeu avec leurs valeurs héritées, pour voir de quoi une
classe est faite et partir de celle-ci pour créer la vôtre. Le navigateur et la vérification de
requiredAddons demandent que le dossier DayZ soit défini dans les Paramètres ;
vérifier la syntaxe et convertir ne demandent rien. La vérification signale aussi quand votre
fichier redéfinit une classe du jeu (class WoodenCrate { … } dans CfgVehicles) : cela modifie
l'objet du jeu sur tous les serveurs qui chargent le mod ; héritez plutôt une nouvelle classe,
sauf si c'est voulu (cette alerte demande aussi le dossier DayZ).
L'écran
- Onglets : Convertir et vérifier et Navigateur de config du jeu.
- Convertir et vérifier
- Entrée : un
config.cpp,.hpp,.h,.rvmatouconfig.bin. - Convertir en : Binaire (.bin) ou Texte (.cpp). Suit l'extension de l'entrée.
- Sortie : où le résultat est écrit. Remplie avec le nom de l'entrée et l'autre extension.
- Vérifier : analyse l'entrée et liste ses problèmes. N'écrit rien.
- Convertir : vérifie, puis écrit la sortie. Rien n'est écrit s'il y a des erreurs.
- Problèmes : une ligne par problème, avec fichier, ligne et colonne, et après une flèche ce qu'il faut faire. Un clic ouvre le fichier à cette ligne dans l'Éditeur de scripts.
- Résultat : la config en texte, après application des
#includeet des macros. - Navigateur de config du jeu
- Recherche (à gauche) : un nom de classe cherche dans toutes les sections ;
CfgVehicles/liste cette section ;CfgVehicles/cancherche à l'intérieur. Les boutons dessous listent les sections usuelles. - Classes (à gauche) : les correspondances, sous forme de chemins comme
CfgVehicles/Canteen. 300 au maximum. - Classe (à droite) : son chemin, une ligne sur le rôle de la section, la chaîne
d'héritage (cliquez sur un parent pour l'ouvrir), l'Addon qui la définit, une image de
l'objet telle que l'inventaire l'affiche quand la classe a un modèle, et toutes ses
propriétés avec l'héritage appliqué. Les clés soulignées (
scope,itemSize,hiddenSelections…) ont une infobulle. - Nouvelle classe à partir de celle-ci : une boîte de dialogue qui écrit une classe héritant de celle affichée.
Premiers pas
- Ouvrez Config (CfgConvert) dans la barre latérale et cliquez sur Navigateur de config du jeu. La première fois, les configs de tous les PBO du jeu (ses archives empaquetées) sont fusionnées ; cela prend quelques secondes.
- Saisissez
canteendans la zone de recherche. - Cliquez sur
CfgVehicles/Canteen. - Lisez la chaîne à côté de Héritage :
Bottle_Base → Edible_Base → Inventory_Base → …. Tout ce que la gourde ne définit pas elle-même vient de ces parents. - Lisez Addon :
DZ_Gear_Drinks. Un mod qui hérite deCanteenindique ce nom dans sonrequiredAddons[]. - Survolez
scopeetitemSizedans les propriétés pour lire ce qu'ils signifient.
Suivre la visite guidée (dans l'app)
Tâches courantes
Vérifier un config.cpp
- Dans Convertir et vérifier, choisissez votre
config.cppcomme Entrée. - Appuyez sur Vérifier.
- Cliquez sur un problème pour ouvrir le fichier à sa ligne. Corrigez, enregistrez : la vérification se relance toute seule quand le fichier change sur le disque.
Visite : vérifier et convertir (dans l'app)
Convertir config.cpp en config.bin
- Choisissez le
config.cpp. Convertir en est réglé sur Binaire (.bin) et Sortie surconfig.binà côté. - Appuyez sur Convertir. La ligne « Wrote … » confirme le fichier.
Le Packer PBO peut binariser les configs d'un mod pendant qu'il empaquette, vous avez donc rarement besoin de le faire à la main.
Lire un config.bin
- Choisissez un
config.bin(par exemple extrait d'un autre mod que vous avez le droit d'étudier). - Appuyez sur Vérifier pour le lire dans la zone de résultat, ou sur Convertir pour
écrire un
config.cpp.
Trouver de quoi hériter
- Dans le navigateur, cherchez quelque chose de proche de ce que vous voulez créer (
akm,barrel,hatchback). - Ouvrez-le et suivez ses parents : une classe
…_Baseou une classe avecscope = 0est généralement celle destinée à être héritée. - Notez l'Addon pour votre
requiredAddons[].
Créer une classe à partir d'une classe du jeu
- Sélectionnez la classe parente et appuyez sur Nouvelle classe à partir de celle-ci.
- Donnez un nom à la classe (lettres, chiffres et
_). - Dans Écrire dans, choisissez un
config.cppde votre mod (ceux de vos workspaces sont listés), Autre fichier… ou Copier dans le presse-papiers. - Cochez ce que la classe doit définir. chemin de modèle provisoire désactivé garde le
modèle du parent (un retexture) ; activé, il écrit un chemin à remplacer par votre propre
.p3d. - Lisez l'aperçu, puis appuyez sur Créer et ouvrir. La classe est ajoutée à sa section, son
nom à la liste CfgPatches, l'addon du parent à
requiredAddons[], et le fichier s'ouvre.
Exemples
- Un objet : la gourde (dans l'app) :
CfgVehicles/Canteen. Regardezscope,itemSize,weight, et les parents jusqu'àInventory_Base. - Une arme : l'AKM (dans l'app) :
CfgWeapons/AKM. La plupart des valeurs viennent deAKM_BaseetRifle_Base; cliquez sur les parents pour voir où chacune est définie. - Un véhicule : l'Ada 4x4 (dans l'app) :
CfgVehicles/OffroadHatchback. Des classes imbriquées décrivent ses sièges, portes, moteur et zones de dégâts. - CfgPatches d'un addon du jeu (dans l'app) :
CfgPatches/DZ_Gear_Drinks, avec sesunits[],weapons[]etrequiredAddons[].
Concepts
- Classe et héritage :
class Canteen: Bottle_Base { … };définitCanteenavec tout ce queBottle_Basepossède, plus ou à la place de ce qui est écrit entre les accolades. Le navigateur montre le résultat ;$baseest le parent direct. - Sections : les classes de premier niveau regroupent les choses par type.
CfgVehiclescontient tous les objets que l'on peut placer ou porter (objets, vêtements, bâtiments, voitures),CfgWeaponsles armes à feu,CfgMagazinesles chargeurs et piles de munitions,CfgAmmoles projectiles,CfgModsles scripts d'un mod. - CfgPatches : chaque addon (PBO) se déclare par une classe dans
CfgPatches: les classes qu'il ajoute (units[],weapons[]) et les addons qui doivent se charger avant lui (requiredAddons[]). Voir https://community.bistudio.com/wiki/CfgPatches. - requiredAddons : le jeu charge les configs dans l'ordre qu'imposent ces listes. Si votre
classe hérite de
Canteenmais que votre CfgPatches ne requiert pasDZ_Gear_Drinks, votre config peut se charger en premier et le parent manque. Utilisez l'Addon affiché par le navigateur. - scope : 2 = la classe peut apparaître en jeu et être listée dans
types.xml; 1 = cachée mais utilisable ; 0 = classe de base uniquement, destinée à être héritée. - Texte et binaire :
config.cppest du texte avec#includeet#define.config.binest le même contenu binarisé (« rapifié ») : sans commentaires ni macros, plus rapide à charger. La conversion ici donne les mêmes octets que CfgConvert. - Déclaration anticipée : avant d'hériter d'une classe d'un autre addon, une config la nomme
(
class Bottle_Base;) dans la même section. Une déclaration manquante est signalée comme une classe de base non définie. - hiddenSelections : parties nommées d'un modèle dont une classe remplace la texture ou le
matériau avec
hiddenSelectionsTextures[]/hiddenSelectionsMaterials[]. C'est ainsi qu'un retexture fonctionne sans nouveau modèle.
Pièges
- Une entrée de
requiredAddons[]qui n'est pas une classe CfgPatches du jeu est signalée par Vérifier, avec l'endroit où chercher le bon nom. La vérification est ignorée, et le dit, tant que la config du jeu est en cours de fusion ou que le dossier DayZ n'est pas défini. __EVAL(…)avec autre chose qu'une arithmétique simple reste une chaîne dansconfig.bin; Vérifier vous dit d'écrire le nombre.- Une classe d'un mod qui n'est pas dans vos workspaces apparaît comme un parent ou un addon inconnu. Ajoutez le dossier du mod aux workspaces dans les Paramètres.
- Convertir un
config.binen texte ne ramène ni commentaires, ni macros, ni includes : ils avaient disparu à la binarisation. - Quand le fichier de sortie existe, Convertir avertit d'abord ; cliquez de nouveau dans les
10 secondes pour le remplacer. Vérifiez le chemin de Sortie quand l'entrée est un
.hppou un.rvmat: il est vide tant que vous n'en choisissez pas un. - Le navigateur montre la config fusionnée du jeu, pas celle de votre mod. Pour voir vos propres
classes, vérifiez votre
config.cppet lisez le résultat. - Nouvelle classe à partir de celle-ci modifie le
config.cppchoisi sur place. Lisez d'abord l'aperçu, et remplacez ensuite les chemins et textes provisoires. Quand l'addon du parent ne peut pas être déterminé, la boîte de dialogue le dit et vous l'ajoutez vous-même àrequiredAddons[].
Pour les agents
Outils de dzt qui font le même travail sans la fenêtre :
config_check: prétraite et analyse unconfig.cpp/.hpp(ou lit unconfig.bin) ; renvoie des diagnostics avec fichier, ligne et colonne (syntaxe, classes de base non définies,requiredAddonsinconnus du jeu) et un résumé CfgPatches / CfgMods.config_convert: texte vers binaire ou l'inverse ; l'extension de sortie choisit (.bin= binaire).game_config_search: noms de classes dans la config fusionnée du jeu ; renvoie des chemins de classes.game_config_class: une classe avec ses propriétés résolues et sa chaîne d'héritage (CfgVehicles/Canteen).item_preview: rend le modèle d'une classe tel que l'inventaire l'affiche, en PNG.vfs_read: lit unconfig.bindu jeu par chemin virtuel, en texte.
Fichiers : Convertir et vérifier lit l'entrée et ses includes (à côté du fichier, et sur le
lecteur projet défini dans les Paramètres) et n'écrit que le fichier de Sortie. Le navigateur
lit le config.bin de chaque PBO du jeu et n'écrit rien. Nouvelle classe à partir de
celle-ci écrit le config.cpp choisi ou le presse-papiers.
Ce que la page dit à l'assistant : sur Convertir et vérifier, l'onglet, le fichier d'entrée, le chemin de sortie et les problèmes de la dernière vérification avec leurs indications ; elle propose aussi la demande « vérifier cette config ». Sur le navigateur, l'onglet, le texte de recherche, le chemin de la classe sélectionnée, sa chaîne d'héritage et l'addon CfgPatches qui la définit.
Les exemples arrivent sur la page sous forme de requêtes : req:class:<path>
(class:CfgWeapons/AKM) sélectionne une classe dans le navigateur ; req:tab:convert et
req:tab:browser affichent un onglet.
Ancres pour studio_guide : config-tabs, config-tab-convert, config-tab-browser,
config-input, config-direction, config-output, config-check, config-convert,
config-problems, config-explorer, config-search, config-sections, config-classes,
config-detail, config-inheritance, config-properties, config-new-class.
Voir aussi
- Éditeur de scripts : modifie
config.cpp; les problèmes s'y ouvrent. - Packer PBO : empaquette le mod et binarise ses configs.
- Modèles : le
.p3dqu'une classe nomme dansmodel, et ses sélections nommées. - Textures (PAA) : textures et matériaux utilisés par
hiddenSelections. - Central Economy :
types.xml, où l'on fait apparaître une classe avecscope = 2. - Premiers pas