VEAF Mission Editor

[![VEAF-logo]][VEAF website] Mission Creation Tools

🇫🇷 Lire ce document en français

[![Badge-Discord]][VEAF Discord] ![Badge-Wakatime]

Complete toolkit for creating dynamic [DCS World][DCS] 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"]

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][VEAF Discord] — real-time help
• [VEAF Website][VEAF website]
• [GitHub Issues][GitHub] — bug reports
• [Support the project][Zip on coff.ee]

---

[![VEAF-logo]][VEAF website] Outils de création de missions

🇫🇷 Français | 🇬🇧 English

À propos

Ensemble complet d'outils pour créer des missions [DCS World][DCS] 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"]