Mission Creation Tools

🇫🇷 Lire ce document en français

Complete toolkit for creating dynamic DCS World missions using VEAF Lua scripts and automation tools.

License: MIT | Version: see CHANGELOG.md

---

With an AI assistant

Claude Desktop, Claude Code, Codex, Antigravity, Gemini CLI or OpenCode can build and edit VEAF missions for you. To install the tools and connect the assistant, run in PowerShell — or let Codex, OpenCode, Antigravity or Claude Code run it; Claude Desktop in chat mode cannot:

New-Item -ItemType Directory -Force "$env:USERPROFILE\VEAF\tools" | Out-Null
Set-Location "$env:USERPROFILE\VEAF\tools"
Invoke-WebRequest https://github.com/VEAF/VEAF-Mission-Creation-Tools/releases/download/published-latest/veaf-tools-updater.exe -OutFile veaf-tools-updater.exe -UseBasicParsing
.\veaf-tools-updater.exe
.\veaf-tools.exe ai-setup

Then restart the assistant and ask it to "create a mission": everything it needs ships with the tools. Details: Install the AI assistant.

---

Documentation

Choose the guide that matches your role:

Role	Guide	Description
Player / Pilot	Pilot Guide	F10 menus, marker commands, assets, combat zones
Mission Maker	Mission Maker Guide	Install, configure, build — all scripts documented
Developer	Developer Guide	Architecture, build pipeline, quality gates, contributing

Detailed References

Reference	Description
Lua API Reference	Full API for all 34 Lua runtime modules
Tools CLI Reference	veaf-tools.exe and veaf-tools-updater.exe
Testing Guide	Lua unit test suite, CI/CD pipeline
Roadmap	Planned features and known limitations

---

Quick Start

Players and Pilots

You're in a mission that uses VEAF scripts. Open the F10 map, place a marker, and type a command (e.g. _spawn unit T-80 or _cas). See the Pilot Guide for all available commands.

Mission Makers

The .\ is required. The default Windows terminal is PowerShell, which does not search the current directory — on purpose. cmd.exe accepts both forms, so .\ works everywhere. See PowerShell or Command Prompt?.

# 1. Download veaf-tools-updater.exe from the GitHub release page and run it:
.\veaf-tools-updater.exe
# → installs veaf-tools.exe and all VEAF scripts in the current folder

Then, depending on your starting point:

To see every feature in game first, play the v6 demo mission: a guided tour leads you through all of them.

You already have a VEAF mission folder (or created one with mission prepare):

.\veaf-tools.exe build

You only have a .miz file:

.\veaf-tools.exe extract my-mission.miz
# → edit mission.yaml to enable the modules you want
.\veaf-tools.exe build

Full workflow: Mission Maker Guide

Developers

# Setup
poetry install --with build

# Build
poetry run veaf-build build --version 6.0.5

# Test
poetry run test-lua

# Publish
poetry run veaf-build publish --version 6.0.5

Full reference: Developer Guide

---

About

VEAF Mission Creation Tools is a hybrid Lua + Python system:

• Runtime (src/scripts/veaf/) — 34 Lua modules loaded inside DCS missions, providing spawning, asset management, mission types, radio menus, and more
• Design-time (src/python/veaf-tools/) — Python CLI (veaf-tools.exe) for manipulating .miz files: normalizing, injecting weather/waypoints/radio presets/aircraft groups
• Release pipeline (veaf-build CLI) — compiles Lua, builds EXE files, publishes to GitHub

How It Works

flowchart LR
    A["Base .miz<br/>(DCS Editor)"] -->|veaf-tools extract| B["Mission folder<br/>(src/ + mission.yaml)"]
    B --- C["published/<br/>(VEAF scripts)"]
    B -->|veaf-tools build| D[".miz ready to fly"]
    D -->|DCS loads| E["34 Lua modules active"]
    E -->|Players use| F["F10 markers · Radio menus"]

1. Extract — Create a base mission in DCS Editor and extract it into version-controllable source files (src/mission/, src/scripts/)
2. Configure — mission.yaml declares active modules; published/ provides the VEAF Lua scripts
3. Build — veaf-tools build assembles everything (mission data, VEAF scripts, triggers) into a final .miz
4. Runtime — DCS loads the .miz and executes the VEAF Lua framework; players interact via F10

---

Community & Support

• VEAF Discord — real-time help
• VEAF Website
• GitHub Issues — bug reports
• Support the project

---

Outils de création de missions

🇫🇷 Français | 🇬🇧 English

Avec un assistant IA

Claude Desktop, Claude Code, Codex, Antigravity, Gemini CLI ou OpenCode peuvent construire et modifier des missions VEAF pour vous. Pour installer les outils et brancher l'assistant, lancez dans PowerShell — ou laissez Codex, OpenCode, Antigravity ou Claude Code le faire ; Claude Desktop en mode chat ne le peut pas :

New-Item -ItemType Directory -Force "$env:USERPROFILE\VEAF\outils" | Out-Null
Set-Location "$env:USERPROFILE\VEAF\outils"
Invoke-WebRequest https://github.com/VEAF/VEAF-Mission-Creation-Tools/releases/download/published-latest/veaf-tools-updater.exe -OutFile veaf-tools-updater.exe -UseBasicParsing
.\veaf-tools-updater.exe
.\veaf-tools.exe ai-setup

Relancez ensuite l'assistant et demandez-lui de « créer une mission » : tout ce dont il a besoin est livré avec les outils. Détails : Installer l'assistant IA.

À propos

Ensemble complet d'outils pour créer des missions DCS World dynamiques avec les scripts Lua VEAF.

• Runtime (src/scripts/veaf/) — 34 modules Lua s'exécutant dans DCS : spawning, assets, menus radio, zones de combat, météo, et plus
• Design-time (src/python/veaf-tools/) — CLI Python (veaf-tools.exe) pour manipuler les fichiers .miz
• Pipeline de release (veaf-build CLI) — compilation Lua, build EXE, publication GitHub

Principe de fonctionnement

flowchart LR
    A[".miz de base<br/>(Éditeur DCS)"] -->|veaf-tools extract| B["Dossier mission<br/>(src/ + mission.yaml)"]
    B --- C["published/<br/>(scripts VEAF)"]
    B -->|veaf-tools build| D[".miz prêt à voler"]
    D -->|DCS charge| E["34 modules Lua actifs"]
    E -->|Les joueurs utilisent| F["Marqueurs F10 · Menus radio"]

1. Extract — Créez une mission de base dans l'éditeur DCS et extrayez-la en fichiers source versionnables (src/mission/, src/scripts/)
2. Configure — mission.yaml déclare les modules actifs ; published/ fournit les scripts Lua VEAF
3. Build — veaf-tools build assemble tout (données mission, scripts VEAF, triggers) en un .miz final
4. Runtime — DCS charge le .miz et exécute le framework Lua VEAF ; les joueurs interagissent via F10

---

Documentation

Choisissez le guide correspondant à votre rôle :

Rôle	Guide	Description
Joueur / Pilote	Guide du pilote	Menus F10, commandes marqueurs, assets, zones de combat
Créateur de missions	Guide créateur de missions	Installation, configuration, build — tous les scripts documentés
Développeur	Guide du développeur	Architecture, pipeline de build, qualité, contribution

Références détaillées

Référence	Description
Référence API Lua	API complète des 34 modules Lua runtime
Référence CLI des outils	veaf-tools.exe et veaf-tools-updater.exe
Guide de tests	Suite de tests Lua unitaires, pipeline CI/CD
Feuille de route	Fonctionnalités prévues et limitations connues

---

Démarrage rapide

Joueurs et pilotes

Vous êtes dans une mission utilisant les scripts VEAF. Ouvrez la carte F10, placez un marqueur et tapez une commande (ex : _spawn unit T-80 ou _cas). Voir le Guide du pilote pour toutes les commandes disponibles.

Créateurs de missions

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 ?.

# 1. Téléchargez veaf-tools-updater.exe depuis la page de release GitHub et lancez-le :
.\veaf-tools-updater.exe
# → installe veaf-tools.exe et tous les scripts VEAF dans le dossier courant

Ensuite, selon votre point de départ :

Pour voir d'abord chaque fonctionnalité en jeu, jouez la mission de démo v6 : une visite guidée vous les fait toutes parcourir.

Vous avez déjà un dossier mission VEAF (ou vous en avez créé un avec mission prepare) :

.\veaf-tools.exe build

Vous n'avez qu'un fichier .miz :

.\veaf-tools.exe extract ma-mission.miz
# → éditez mission.yaml pour activer les modules souhaités
.\veaf-tools.exe build

Guide complet : Guide créateur de missions

Développeurs

# Installation
poetry install --with build

# Build
poetry run veaf-build build --version 6.0.5

# Tests
poetry run test-lua

# Publication
poetry run veaf-build publish --version 6.0.5

Référence complète : Guide du développeur

---

Communauté & Support

• VEAF Discord — aide en temps réel
• Site VEAF
• Issues GitHub — signalement de bugs
• Soutenir le projet

---