Config (CfgConvert)

Tutoriel (en anglais) · 2:51

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

Premiers pas

  1. 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.
  2. Saisissez canteen dans la zone de recherche.
  3. Cliquez sur CfgVehicles/Canteen.
  4. 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.
  5. Lisez Addon : DZ_Gear_Drinks. Un mod qui hérite de Canteen indique ce nom dans son requiredAddons[].
  6. Survolez scope et itemSize dans 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

  1. Dans Convertir et vérifier, choisissez votre config.cpp comme Entrée.
  2. Appuyez sur Vérifier.
  3. 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

  1. Choisissez le config.cpp. Convertir en est réglé sur Binaire (.bin) et Sortie sur config.bin à côté.
  2. 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

  1. Choisissez un config.bin (par exemple extrait d'un autre mod que vous avez le droit d'étudier).
  2. 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

  1. Dans le navigateur, cherchez quelque chose de proche de ce que vous voulez créer (akm, barrel, hatchback).
  2. Ouvrez-le et suivez ses parents : une classe …_Base ou une classe avec scope = 0 est généralement celle destinée à être héritée.
  3. Notez l'Addon pour votre requiredAddons[].

Créer une classe à partir d'une classe du jeu

  1. Sélectionnez la classe parente et appuyez sur Nouvelle classe à partir de celle-ci.
  2. Donnez un nom à la classe (lettres, chiffres et _).
  3. Dans Écrire dans, choisissez un config.cpp de votre mod (ceux de vos workspaces sont listés), Autre fichier… ou Copier dans le presse-papiers.
  4. 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.
  5. 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

Concepts

Pièges

Pour les agents

Outils de dzt qui font le même travail sans la fenêtre :

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