Installation

Download

Grab the latest release from GitHub Releases. Two versions are provided:

• medusa.lua - the main release, includes everything you need
• medusa-thin.lua - does not include dcs-harness, for missions that already load dcs-harness separately

Most people should use medusa.lua.

Mission Editor Setup

Standard setup

Add a single DO SCRIPT FILE trigger at mission start:

1. Open your mission in the DCS Mission Editor
2. Go to Triggers panel
3. Add trigger: MISSION START -> DO SCRIPT FILE -> select medusa.lua

Thin version (shared dcs-harness)

If you use other scripts that depend on dcs-harness, load it once and use the thin version:

1. MISSION START -> DO SCRIPT FILE -> select dcs-harness.lua
2. MISSION START -> DO SCRIPT FILE -> select medusa-thin.lua (must load after harness)

Caution

Load order matters. The thin version requires dcs-harness to be loaded first. If you see errors about missing globals like GetGroup or SetControllerOnOff, dcs-harness hasn’t loaded yet.

Verify it’s working

Start the mission and check your DCS log (dcs.log). If Medusa loaded correctly, you should see output like this:

2026-04-02 23:08:15.769 INFO  SCRIPTING (Main): [ Medusa | INFO | Entrypoint ] Medusa initializing v0.4.1-dev-main
2026-04-02 23:08:15.769 INFO  SCRIPTING (Main): [ Medusa | INFO | PVO | Core.IadsNetwork ] config: coalitionId=1, prefix='pvo'
2026-04-02 23:08:15.769 INFO  SCRIPTING (Main): [ Medusa | INFO | PVO | Core.IadsNetwork ] doctrine: AutoDiscoverEwrs=true BallisticSimMaxSec=120 BallisticSimStepSec=1 BatteryTargetDatalink=true C2DelaySec=3

If you see no Medusa output at all, check that the script files are loading in the correct order.

Next steps

Head to Quick Start to configure your first IADS network.