Navigation: page “Mission Maker” du site de documentation VEAF

🚧 TRAVAUX EN COURS 🚧

La documentation est en train d’être retravaillée, morceau par morceau. En attendant, vous pouvez consulter l’ancienne documentation.

Table des matières

Introduction

Une QRA (Quick Reaction Alert)[https://fr.wikipedia.org/wiki/Quick_Reaction_Alert] est un vol d’appareils de chasse prêt à décoller pour intercepter tout appareil ou missile de croisière menaçant une zone (typiquement une base aérienne, ou une zone sensible).

Grâce à ce module, vous pourrez facilement définir une ou plusieurs zones, circulaires ou polygonales, qui déclencheront le décollage d’un ou plusieurs groupes d’interception si elles sont violées par un pilote humain.

Le but de ce qui suit est de fournir toutes les informations nécessaires pour configurer une QRA (Quick Reaction Alert) dans une mission utilisant les scripts VEAF.

(Veuillez lire Mission Maker).

Principes

Une zone de QRA (que nous appelerons QRA à partir d’ici) est constituée de :

La zone a un état qui correspond à son activité :

Ceci est le schéma standard. En pratique, des dizaines d’options (décrites plus loin) vous permettent d’adapter le comportement des QRA comme vous les souhaitez.

Les QRA peuvent également être liées à une base aérienne et subir des contraintes logistiques (nombre de respawn réduit, ou incapacitation en cas de destruction de la base, par exemple)

Mise en place dans l’éditeur DCS

Tout d’abord, le groupe QRA doit exister au sein de la mission. Tout type d’aéronef (démarrage en vol ou au sol) peut être utilisé et leur charge utile/plan de vol existant sera conservé.

Cette étape est similaire à toute autre mission, placez le groupe de votre choix, configurez-le, enclenchez l’activation différée et donnez-lui un nom facilement reconnaissable car il sera utilisé par la suite.

De plus, vous devrez créer une zone de déclenchement. Avec un nom reconnaissable (qui peut être identique à celui du groupe d’aéronefs) que nous utiliserons aussi par la suite.

Ceci est simplement pour avoir un point de référence pour la zone de déploiement du QRA, son rayon dans DCS n’a pas d’importance et sera défini ultérieurement.

Comment configurer une QRA

Concernant la partie script, tout commence dans le fichier de configuration de la mission missionConfig.lua, qui est situé dans le répertoire src/scripts de votre mission.

Ce dernier est un fragment de code source (LUA)[https://fr.wikipedia.org/wiki/Lua] qui permet de choisir la manière dont les scripts VEAF sont activés et configurés. Nous vous conseillons d’utiliser Notepad++ ou Visual Studio Code pour l’éditer.

Par défaut, si vous avez utilisé le convertisseur de mission existante pour préparer votre dossier de mission VEAF, il contient déjà un modèle de configuration QRA que vous pourrez trouver en cherchant “– initialize QRA”.

Le principe de configuration est simple.

Tout d’abord on crée un “objet” de type VeafQRA en appelant VeafQRA:new(). Cet appel renvoie une instance de VeafQRA, qu’on peut stocker dans une variable (local maQra = VeafQRA:new()) ou utiliser tout de suite avec une (désignation chaînée)[https://fr.wikipedia.org/wiki/D%C3%A9signation_cha%C3%AEn%C3%A9e] (en enchainant les appels aux méthodes de configuration qui renvoient toutes la même instance de VeafQRA).

Exemple de chainage:

VeafQRA:new()
    :setName("QRA_Minevody")
    :setTriggerZone("QRA_Minevody")
    :setZoneRadius(106680)

L’avantage de cette méthode est sa simplicité.

Exemple d’utilisation d’une variable:

local qraMinevody = VeafQRA:new()
qraMinevody:setName("QRA_Minevody")
qraMinevody:setTriggerZone("QRA_Minevody")
qraMinevody:setZoneRadius(106680)

L’avantage de la seconde méthode est qu’on peut, plus loin dans le fichier missionConfig.lua, utiliser une référence à la variable qu’on a définie pour accéder à l’instance de VeafQRA (par exemple, dans la définition d’un alias, d’une commande “mission maker”, ou dans un menu radio).

Vous pouvez utiliser l’option suivante pour activer (false) ou désactiver (true) l’envoi de messages par la QRA:

VeafQRA.ToggleAllSilence(*false or true*) --Activera tous les messages QRA visibles par le joueur si l'argument est "true" et désactivera tous les messages QRA si l'argument est "false".

Structure d’une déclaration de QRA

Options Générales

VeafQRA.new()

Création d’une nouvelle instance de QRA: une instance définit une zone et son comportement; exemple: la QRA de Minevody.

:setName("QRA_Minevody") -- Définit le nom de la QRA pour les scripts (principalement à des fins d'affichage)

Définition du nom technique de la QRA: ce nom sert à retrouver la QRA avec la commande veafQraManager.get(); exemple: veafQraManager.get("QRA_Minevody")

:setTriggerZone("QRA_Minevody_triggerzone") -- Indique aux scripts quelle zone de déclenchement est utilisée référence de la zone de déploiement de la QRA.

Définition de la zone via une trigger zone DCS

:setZoneCenterFromCoordinates("U37TCL5297") -- U=UTM (MGRS); 37T=grid number; CL=square; 52000=latitude; 97000=longitude
:setZoneRadius(50000) -- Définit le rayon de la zone de déploiement (en mètres)

Utilisation de coordonnées (MGRS ou Latitude/Longitude) et d’un rayon pour définir la zone

:setCoalition("red") -- Définit la coalition à laquelle la QRA appartiendra

Définition de la coalition qui gère la QRA (en général, ce sont les ennemis des joueurs, souvent les rouges).

Valeurs acceptées:

:addEnnemyCoalition("blue") -- Ajoute une coalition dont les avions déclencheront le déploiement de la QRA.

Les joueurs qui font partie de cette ou ces coalitions seront surveillés, et la QRA sera déclenchée s’ils entrent dans la zone.

On accepte les mêmes valeurs que pour setCoalition()

:setReactOnHelicopters() --Définit si la QRA réagit aux hélicoptères qui entrent dans la zone

:setSilent() --Désactive les messages de cette QRA uniquement. VeafQRA.ToggleAllSilence doit être "false" pour que cela ait un effet.

:setDelayBeforeRearming(LeDelai) --Délai entre la mort d'une QRA et le réarmement de nouveau avions

:setNoNeedToLeaveZoneBeforeRearming() --La QRA réapparaîtra même si des joueurs sont toujours dans la zone (zone de déploiement) après son réarmement

:setResetWhenLeavingZone() --La QRA sera désactivée (et réarmée immédiatement) lorsque tous les joueurs quittent la zone. Sinon, la QRA patrouillera jusqu'à ce qu'elle
                           --retourne à la base après activation, moment où elle sera désactivée lors de l'atterrissage et réaarmée immédiatement.

:setDelayBeforeActivating(LeDelai) --Délai d'activation entre l'entrée d'unités dans la zone de la QRA et le déploiement de la QRA

:setMinimumAltitudeInFeet(L_AltitudeMini) --Défini l'altitude minimale pour la détection d'un appareil et donc le déploiement de la QRA

:setMaximumAltitudeInFeet(L_AltitudeMax) --Défini l'altitude maximale pour la détection d'un appareil et donc le déploiement de la QRA

:addGroup("qra_Mig29") -- Vous pouvez utiliser ceci pour ajouter un ou plusieurs groupes d'avions à la QRA (syntaxe #1)

:addGroup({ "qra_Mig29", "qra_Mig30", "qra_Mig31", "qra_Mig32",... }) -- Vous pouvez utiliser ceci pour ajouter un ou plusieurs groupes d'avions à la QRA (syntaxe #2)

Options pour le comportement d’une QRA Multi-Groupe

Concernant l’utilisation de multiples groupes dans une QRA :

    :addRandomGroup(*groups*, *number*, *bias*) --Ajoute aléatoirement *number* groupes pris parmis la liste des *groups* (liste avec le format suivant : {"*NameOfQRA_1*",
                                                --"*NameOfQRA_2*", ...} ) avec un biais vers l'élément numéro *bias*

    :setGroupsToDeployByEnemyQuantity(*enemyNb*, *groupsToDeploy*) --Lorsque *enemyNb* appareils sont détéctés dans la zone de la QRA, ceci fait que les groupes de la liste
                                                                   --*groupsToDeploy* (liste avec le format suivant : {"*NameOfQRA_1*", "*NameOfQRA_2*", ...} ) seront
                                                                   --déployés.

    :setRandomGroupsToDeployByEnemyQuantity(*enemyNb*, *groups*, *number*, *bias*) --Lorsque *enemyNb* appareils sont détéctés dans la zone de la QRA, ceci fait que
                                                                                   --aléatoirement, *number* des groupes parmis la liste *groups* (liste avec le format
                                                                                   --suivant : {"*NameOfQRA_1*", "*NameOfQRA_2*", ...} ) seront déployés.
                                                                                   --Avec un biais vers l'élément numéro *bias* de la liste.

Options Logistique

De plus, il est possible de contrôler étroitement la logistique de la QRA. Vous pouvez :

    :setQRAcount(LeNombreSurTarmac) --Supérieur ou égal à -1 : Nombre actuel d'ensembles d'avions disponibles pour le déploiement. Par défaut, cela est réglé sur -1, ce qui                                     --signifie qu'un nombre infini de groupes est disponible, aucune logistique ne prend place n'est effectué.

-> C’est votre “master arm” pour le reste de ces options.

    :setQRAmaxCount(LeNombreMaxSurTarmac) --Supérieur ou égal à -1 : Nombre maximal d'ensembles d'avions déployables à tout moment pour la QRA. Par défaut, cela est réglé
                                          --sur -1, ce qui signifie qu'un nombre infini d'avions peut être accumulé pour le déploiement.

-> Exemple : Une QRA a 2 places sur 6 de remplies et prêtes pour le déploiement, 6 correspond au maxQRAcount, 2 au QRAcount actuel.

    :setQRAmaxResupplyCount(LeNombreTotalDeStock) --Supérieur ou égal à -1 : Nombre total de groupes d'avions pouvant être provisionnés à la QRA. Par défaut, cela est réglé                                                   --sur -1, ce qui signifie qu'une quantité infinie de stock est disponible. 0 signifie qu'aucun stock n'est disponible,                                                       --aucun réapprovisionnement ne se produira, c'est votre "master arm" pour les réapprovisionnements.

-> Prenons l’exemple précédent : nous avons besoin de 4 groupes (4 “places de parking” vides) mais nous n’en avons que 3 en stock pour réapprovisionner la QRA, 3 correspond au QRAmaxResupplyCount.

    :setQRAminCountforResupply(LeSeuilPourLeResup) --Égal à -1 ou supérieur à 0 : Nombre d'ensembles d'avions que la QRA doit avoir à tous temps, sinon un                                                                      --réapprovisionnement sera lancé. Par défaut, cela est réglé sur -1, ce qui signifie qu'un réapprovisionnement sera lancé                                                    --dès qu'un ensemble d'avions est perdu.

-> Prenons l’exemple précédent : le nombre minimum d’ensembles d’avions déployables que nous souhaitons avoir en tout temps pour notre QRA est de 1, mais nous en avons 2, donc aucun réapprovisionnement ne se produira pour le moment. 1 correspond au minCountforResupply.

    :setResupplyAmount(LaQté) --Supérieur ou égal à 1 : Nombre de groupes d'avions qui seront fournis à la QRA lorsqu'un réapprovisionnement se produit. 
                              --Par défaut, cela est égal à 1.

-> Prenons l’exemple précédent : nous venons de perdre nos deux znsembles, ce qui signifie que nous n’en avons plus, cela déclenchera un réapprovisionnement, qui apportera soit le nombre désiré d’ensembles soit le nombre d’avions que nous avons en stock si cette quantité est inférieure. Le réapprovisionnement sera également limité par le nombre maximum d’ensembles que nous pouvons avoir en même temps.

    :setQRAresupplyDelay(LeTempsDeResup) --Supérieur ou égal à 0 : Temps nécessaire pour effectuer un réapprovisionnement

Plusieurs choses à noter ici :

Options pour le lien avec un aéroport / une base

Enfin, il est possible de lier les mécanismes de déploiement et de logistique de la QRA à la possesion (ou non) d’une base aérienne, d’un FARP, d’un navire ou d’un bâtiment par la coalition de la dite QRA :

    :setAirportLink("Le Nom de la base") --Nom de l'unité / de la base aérienne : la QRA sera liée à cette base et cessera de fonctionner si la base est perdue (il peut
                                         --s'agir d'un FARP (utilisez le nom de l'unité du FARP), d'un navire (utilisez le nom de l'unité du navire), d'un aérodrome 
                                         --(utilisez le nom sur la carte de DCS en anglais) ou d'un bâtiment (plateformes pétrolières, etc.))

Non fonctionnel à ce jour :

    :setAirportMinLifePercent(LeSeuilDeVie) --Comprise entre 0 et 1 : pourcentage minimum de vie de l'aéroport lié pour que le QRA fonctionne. Les aéroports (pistes) et les
                                            --navires ne devraient perdre de la vie que lorsqu'ils sont bombardés, cela nécessite des tests manuels pour savoir ce qui 
                                            --fonctionne le mieux.

Plusieurs choses à noter ici :

Dernière étape

Après avoir enchaîné ces options, vous pouvez ajouter cela :

    :start()

Comme son nom l’indique, cela démarre la QRA. Sinon, elle restera inactive.

Ou si vous souhaitez la démarrer ultérieurement dans l’un de vos scripts :

    if QRA_LeNomDeMaQRA then QRA_LeNomDeMaQRA:start() end

Vous pouvez également utiliser pour faire l’action inverse :

    if QRA_LeNomDeMaQRA then QRA_LeNomDeMaQRA:stop() end --utilisez ceci si vous souhaitez arrêter la QRA à un moment donné (dans un déclencheur, etc.). Elle peut être
                                                         --redémarrée en utilisant la méthode précédemment mentionnée.

Cela rend inactif la QRA (stop toute vérification d’aéroport, toutes les opérations de logistique, etc.).

Options Avancées

En plus de ce qui a été dit précedemment, il est possible de modifier certaines options de “bas niveau”.

Messages Joueur

Cette section concerne la modification des messages affichés aux joueurs des coalitions qui deuvent déclencher la QRA selon ses états :

    :setMessageStart("Mon Message") --Lorsque :start() est utilisé

    :setMessageDeploy("Mon Message") --Lorsque la QRA est déployée

    :setMessageDestroyed("Mon Message") --Lorsque la QRA est détruite

    :setMessageReady("Mon Message") --Lorsque la QRA est de nouveau prête au déploiement

    :setMessageOut("Mon Message") --Lorque la QRA est à court d'ensembles d'avions

    :setMessageResupplied("Mon Message") --Lorsque la QRA possède de nouveau des avions

    :setMessageAirbaseDown("Mon Message") --Lorsque la QRA perd sa base

    :setMessageAirbaseUp("Mon Message") --Lorsque la QRA regagne sa base

    :setMessageStop("Mon Message") --Lorsque :stop() est utilisé

Contacts

Si vous avez besoin d’aide, ou si vous voulez suggérer quelque chose, vous pouvez :