Référence des scripts — Modules Lua VEAF¶

Tous les modules sont regroupés dans veaf-scripts.lua et chargés au démarrage de la mission. Cette page vous aide à trouver le bon module pour vos besoins.

Trouver un module¶

Par étape du workflow mission-maker¶

Que construisez-vous ? Choisissez l'étape qui correspond.

Étape	Modules	Objectif
Fondation	`veaf.lua`, `veafMarkers`, veafRadio, veafInterpreter, veafCommands, veafI18n, veafUnits, `veafEventHandler`, `veafCacheManager`	Infrastructure de base (toujours chargée)
Mise en place	veafSecurity, veafNamedPoints, veafAirbases	Contrôle d'accès, positions carte, données de bases
Spawning	veafSpawn, veafMove, veafGroundAI	Permettre aux joueurs de créer, déplacer et piloter des unités
Types de mission	veafCasMission, veafCombatMission, veafCombatZone, veafTransportMission, veafQraManager, veafAirWaves, veafCampaign	Scénarios de gameplay structurés
Assets & services	veafAssets, veafCarrierOperations, veafGrass, veafWeather	Ravitailleurs/AWACS/porte-avions gérés, météo
Protection	veafMissileGuardian, veafSanctuary	Défense anti-missiles, zones sûres
Assistance en vol	veafAssist	Checklists guidées : la mission encadre le bon interrupteur dans le cockpit et coche la ligne
Debrief	veafCombatLog	Chaque tir, coup au but et destruction dans un fichier, pour le récap par pilote
Intégrations	veafSkynetIadsHelper	Systèmes IADS tiers

Par interaction joueur¶

Que vivront vos joueurs ?

Action joueur	Module	Ce qui se passe
Place un marqueur avec `_spawn ...`	veafSpawn	Des unités apparaissent à la position du marqueur
Place un marqueur avec `_cas`	veafCasMission	Zone de cibles aléatoire générée
Ouvre F10 → ZONES DE COMBAT → Activer la zone	veafCombatZone	Zone de combat pré-construite activée
Entre dans une zone de vagues aériennes	veafAirWaves	Combat aérien par vagues lancé
Ouvre F10 → MOYENS → [ressource]	veafAssets	Info, respawn
Ouvre F10 → OPS PORTE-AVIONS → Start carrier air operations for 45 minutes	veafCarrierOperations	Le porte-avions se met face au vent
Entre dans une zone protégée	veafQraManager	Intercepteurs IA décollent
Tape `_auth elevate`	veafSecurity	Le groupe monte au niveau du demandeur pendant 2 minutes
Vole dans une zone sanctuaire	veafSanctuary	Missiles hostiles neutralisés

Par fréquence d'utilisation¶

Quelle est la fréquence d'utilisation de ce module ?

Fréquence	Modules
Essentiel (quasi toute mission)	veafSpawn, veafAssets, veafNamedPoints, veafSecurity
Courant (la plupart des missions de combat)	veafCasMission, veafCombatZone, veafAirWaves, veafCarrierOperations
Situationnel (scénarios spécifiques)	veafQraManager, veafTransportMission, veafMove, veafGrass, veafWeather, veafAirbases
Spécialisé (configurations avancées)	veafMissileGuardian, veafSanctuary, veafSkynetIadsHelper, veafCampaign

Modèle de chargement et d'initialisation¶

Chaque module suit le même modèle :

-- Optionnel : surcharger les valeurs par défaut avant l'initialisation
veafModuleName.SomeConstant = value

-- Requis : initialiser le module
veafModuleName.initialize()

-- Certains modules nécessitent aussi un appel à start()
veafModuleName.start()

Les modules qui ne sont pas initialisés (initialize()) ne consomment aucune ressource et ne créent aucun menu radio.

Contrôle d'accès¶

Module	Fichier	Rôle
veafSecurity	`veafSecurity.lua`	Système de permissions basé sur les rôles (mots de passe, niveaux)

Modules de protection¶

Module	Fichier	Rôle
veafSanctuary	`veafSanctuary.lua`	Zones protégées qui détruisent automatiquement les unités intruses
veafMissileGuardian	`veafMissileGuardian.lua`	Intercepte des missiles entrants spécifiques pour protéger des ressources

Intégrations tierces¶

Module	Fichier	Rôle
veafSkynetIadsHelper	`veafSkynetIadsHelper.lua`	Configure Skynet IADS depuis les données de groupes VEAF
`veafSkynetIadsMonitor.lua`	—	Surveille la santé de Skynet IADS et envoie des alertes radio
`veafRemote.lua`	—	Pont avec le hook serveur VEAF : droits des joueurs et commandes du chat

Administration serveur¶

Composant	Fichier	Rôle
veafServerHook	`VEAF-Server-hook.lua`	Hook serveur dédié : commandes chat (`/send`, `/pause`…), liste des pilotes, restart/télémétrie opt-in

Une option mal orthographiée est refusée, pas ignorée¶

Quand une commande de marqueur porte une option qu'aucune règle ne reconnaît — presque toujours une faute de frappe — la commande est refusée et le nom de l'option vous est affiché, avec une suggestion quand elle est proche d'une option existante :

_spawn group, name sa6, headng 270
      ↓
VEAF SPAWN : paramètre(s) inconnu(s), commande abandonnée : 'headng' (vouliez-vous dire « heading » ?)

Refuser plutôt qu'exécuter est délibéré : une option inconnue ne fait rien, donc la commande ferait apparaître ou déplacerait autre chose que ce que vous avez demandé — sans que rien ne vous le dise. Le marqueur reste en place, vous corrigez et vous replacez.

S'applique aux commandes de SPAWN, CASMISSION, MOVE, RADIO, TRANSPORTMISSION, GROUNDAI (ordres d'artillerie compris). Le nom affiché est celui que le module utilise aussi comme préfixe dans le log DCS, pour que le message et le log se recoupent.

Les alias sont exclus

Un alias (-sa6, -samsr) transporte les paramètres de la commande qu'il déploie, et non les siens : la vérification y signalerait des options parfaitement valides. Les fautes de frappe dans un alias sont donc attrapées par la commande finale, pas par l'alias.

Ordres d'artillerie : le séparateur est le point-virgule

Un ordre d'artillerie voyage comme valeur d'une clé order, dans un marqueur déjà découpé sur la virgule — d'où le ; : aim; shells 10; radius 50. Si vous mettez une virgule, la vérification vous le dit maintenant, au lieu de perdre silencieusement le reste de l'ordre.

Raccourcis (Aliases)¶

Module	Fichier	Description
veafShortcuts	`veafShortcuts.lua`	Aliases courts (`-sa6`, `-shilka`, `-destroy`, etc.) pour les commandes marqueur — voir la liste complète
`veafTime.lua`	—	Utilitaires de temps mission

Modules de données¶

Ce sont des fichiers de données pures — aucune initialisation nécessaire.

Module	Contenu
`dcsUnits.lua`	Base de données de tous les types d'unités DCS avec leurs attributs
`dcsDataExport.lua`	Utilitaires d'export des données d'unités

Référence API complète¶

Pour l'API publique complète de chaque module (fonctions, paramètres, valeurs de retour, exemples), consultez la Référence API Lua.