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

---

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

# 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:

You already have a VEAF mission folder (or forked the Demo Mission):

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"]

Loading

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

À 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"]

Loading

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

# 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 :

Vous avez déjà un dossier mission VEAF (ou vous avez forké la mission de démonstration) :

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

---