Éditeur de scripts

Tutoriel (en anglais) · 3:11

L'Éditeur de scripts est l'endroit où vous écrivez le code Enforce Script d'un mod (les fichiers .c) et son config.cpp, et où vous lisez les scripts du jeu pour apprendre comment on fait telle chose. Il vérifie le code pendant la frappe, complète les noms, montre la déclaration de ce que vous survolez, et saute vers n'importe quelle classe ou méthode du jeu ou de votre mod. Il vous faut un dossier de mod (un « workspace ») pour écrire du code, et le dossier DayZ défini dans les Paramètres pour parcourir les scripts du jeu ; lire les scripts du jeu fonctionne sans aucun mod.

L'écran

Premiers pas

  1. Ouvrez la page et cliquez sur l'onglet Vanilla.
  2. Sous scripts, ouvrez 4_World, Entities, ManBase et cliquez sur PlayerBase.c. Il s'ouvre en lecture seule.
  3. Dans la Structure, cliquez sur une méthode pour y aller. Survolez un nom de type pour voir sa déclaration ; appuyez sur F12 (ou Ctrl+clic) sur un nom pour sauter à l'endroit où il est défini.
  4. Cliquez sur l'onglet Symboles, saisissez MissionServer et cliquez sur la classe : un autre fichier du jeu s'ouvre à la déclaration.
  5. Revenez à Explorateur. S'il indique qu'il n'y a pas de workspace, ajoutez le dossier de votre mod ou créez un mod depuis le modèle. Puis cliquez sur +, gardez « modded class », saisissez un nom de fichier et créez-le.
  6. Saisissez du code, surveillez la barre Problèmes en bas, et enregistrez avec Ctrl+S.

Faire la visite (dans l'app)

Tâches courantes

Créer un script dans votre mod

  1. Dans l'Explorateur, cliquez sur + (ou faites un clic droit sur le dossier où le fichier doit aller, puis Nouveau script).
  2. Choisissez le module de script (3_Game, 4_World ou 5_Mission), saisissez le nom du fichier, choisissez le contenu : une modded class (modifier une classe du jeu), une class (une nouvelle classe) ou un fichier vide.
  3. Vérifiez le chemin affiché en bas de la boîte de dialogue, puis Créer.

Le fichier va dans Scripts/<module>/<mod id>/<name>.c du mod (l'orthographe des dossiers existants est conservée). Si le module n'est pas déclaré dans le bloc CfgMods du config.cpp du mod, la page l'ajoute et vous le dit ; sans cette déclaration, le jeu ne charge pas le dossier.

Modifier une classe du jeu (modded class)

  1. Trouvez la classe avec l'onglet Symboles et ouvrez-la.
  2. Lisez la méthode que vous voulez changer et notez sa signature.
  3. Cliquez sur Copier dans mon mod dans le bandeau lecture seule (la copie va dans le même module de script de votre mod ; gardez ensuite seulement ce que vous changez et écrivez modded class devant la classe), ou créez un nouveau script avec le contenu « modded class » et le même nom de classe.
  4. Écrivez l'override de la méthode ; appelez super.<Method>(...) quand l'original doit tout de même s'exécuter.
  5. Enregistrez, puis vérifiez la liste Problèmes.

Faire la visite de cette tâche (dans l'app)

Trouver où quelque chose est défini ou utilisé

  1. Placez le curseur sur un nom. F12 ou Ctrl+clic mène à sa définition (aussi dans les scripts du jeu).
  2. Maj+F12 liste chaque usage dans l'onglet Références du panneau du bas.
  3. Pour un nom que vous n'avez pas à l'écran, utilisez l'onglet Symboles.

Corriger les erreurs de script de la dernière exécution du jeu

  1. Lancez le jeu ou le serveur avec votre mod (page Launcher).
  2. Revenez ici et ouvrez le panneau du bas : sous les problèmes de vos fichiers, la section « Journal du jeu » liste les erreurs de compilation et les exceptions de script du journal le plus récent, chacune avec son nombre.
  3. Cliquez sur l'une d'elles : le fichier de votre mod s'ouvre à la ligne fautive. Corrigez, enregistrez, relancez.

Les avertissements du journal ne sont listés que pour les fichiers de votre propre mod.

Déboguer un script avec des points d'arrêt

  1. Ouvrez l'onglet Débogage du panneau du bas et cliquez sur Écouter (port par défaut 41001).
  2. Lancez la version de diagnostic du jeu, DayZDiag, avec -debuggerPort=<port>, ou utilisez « Attacher le débogueur de scripts » dans le Launcher. Le badge passe à « connecté ».
  3. Cliquez à gauche d'un numéro de ligne (ou appuyez sur F9) pour poser un point d'arrêt. Quand le jeu l'atteint, la ligne est mise en évidence et la pile d'appels et les variables se remplissent.
  4. F5 continue, F10 passe par-dessus, F11 entre dans la fonction, Maj+F11 en sort.
  5. « Rechargement à chaud à l'enregistrement » recompile un script enregistré dans le jeu en cours d'exécution (le jeu doit être lancé avec -filePatching).

Partir d'une recette

Sans fichier ouvert, l'état vide montre les recettes de cette page en puces (Nouveau mod, Téléporter les nouveaux joueurs, Nouvelle recette d'artisanat…) : 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

Concepts

Pièges

Pour les agents

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

Fichiers que la page lit et écrit :

Ce que la page dit à l'assistant (son contexte de page) : le fichier actif (chemin ou clé vfs:), la ligne du curseur, le nombre d'onglets ouverts, si le fichier a des modifications non enregistrées, et ses problèmes sous la forme line N: severity message. Sans fichier ouvert, le contexte est vide. Elle propose une action : relire le fichier ouvert.

Voir aussi