Aller au contenu

Le build

Ce que c'est

Une commande qui recompose le .miz depuis le dossier de mission. Elle fait toujours les mêmes quatre choses, puis exécute les étapes optionnelles dont elle trouve le fichier.

Le .\ est obligatoire. Le terminal Windows par défaut est PowerShell, qui ne cherche pas dans le dossier courant — exprès. cmd.exe accepte les deux formes, donc .\ marche partout. Voir PowerShell ou invite de commandes ?.

.\veaf-tools.exe build Ma-Mission.miz
  1. lit src/mission/ (la mission DCS décompressée) ;
  2. génère src/scripts/veaf-config.lua depuis mission.yaml, et annonce les modules qu'il y a lus — avec leur nombre d'entrées pour ceux qui portent une liste, par exemple COMBATZONE (1) ; un module que vous venez d'ajouter et qui n'apparaît pas n'a pas été lu ;
  3. retire les déclencheurs VEAF existants, puis en injecte de neufs qui chargent les scripts VEAF et les vôtres au démarrage ;
  4. écrit le .miz.

Vous n'ajoutez jamais un déclencheur VEAF à la main dans l'éditeur DCS. Et comme l'étape 3 nettoie avant d'injecter, reconstruire dix fois de suite produit dix fois le même résultat.

Les étapes du pipeline

Chacune s'exécute si son fichier est présent, dans cet ordre :

Étape Fichier Fiche
presets src/presets.yaml préréglages radio
spawnable_aircrafts src/spawnables.yaml groupes spawnables
dynamic_slot_templates src/dynamic-slot-templates.yaml slots dynamiques
waypoints src/waypoints.yaml —
warehouses src/warehouses.yaml slots dynamiques
spawn_data src/spawn-groups.yaml —
weather src/versions.yaml variantes météo

Pour en couper une :

pipeline:
  weather: false

Vérifier avant de construire

.\veaf-tools.exe validate

Elle relit la configuration et la mission ensemble, et signale ce qui ne collera pas — une zone de combat dont la trigger zone n'existe pas, des préréglages radio sans appareil joueur à qui les appliquer. Elle sort en erreur s'il y a une erreur ; --strict la fait aussi sortir sur un simple avertissement.

Le nom du fichier produit

Ce que vous tapez Ce que vous obtenez
build Ma-Mission.miz Ma-Mission.miz
build Ma-Mission (sans .miz) Ma-Mission_AAAAMMJJ.miz — la date du jour est ajoutée
build (rien) le nom vient de mission.name dans mission.yaml

Le piège

Un dossier fraîchement créé produit deux fichiers. src/versions.yaml est livré avec une variante « midi », donc l'étape météo s'exécute et écrit en plus missions/Ma-Mission_noon.miz. Le fichier à la racine est la mission de base ; celui de missions/ est la variante. Voir variantes météo.

Pour aller plus loin