DCS option disperseOnAttack

From DCS World Wiki - Hoggitworld.com

Task: Disperse On Attack Added with: 1.2.4
Hierarchy: Scripting Root > Tasks > Option > Disperse On Attack
Tasking Type: Option
For: Ground Vehicles
Available Under: Everything
Description: Option that dictates whether or not AI ground forces are allowed to disperse if they are attacked by an airborne threat.


False or 0: AI will not disperse.

Any positive number: AI will disperse, but only for the specified time before continuing their route.

Format: All options have an option ID and Value. For more information see the article on the AI enumerator.

Option Identifier: 8


Option Values:

0 or false

Any positive number representing the dispersal time in seconds.

Enumerators: DISPERSE_ON_ATTACK = 8
Examples: Group will disperse for 2 minutes
local myGroup = Group.getByName('tanks')
Notes: See article Mission Editor: AI Tasking for more information on how AI tasking is handled within DCS.
Task List: Main Tasks: mission, AttackGroup, AttackUnit, Bombing, CarpetBombing, AttackMapObject, BombingRunway, orbit, refueling, land, follow, followBigFormation, escort, Embarking, fireAtPoint, hold, FAC_AttackGroup, EmbarkToTransport, DisembarkFromTransport, CargoTransportation, goToWaypoint, groundEscort

En-route Tasks: engageTargets, engageTargetsInZone, engageGroup, engageUnit, awacs, tanker, ewr, FAC_engageGroup, FAC

Commands: script, setCallsign, setFrequency, switchWaypoint, stopRoute, switchAction, setInvisible, setImmortal, activateBeacon, deactivateBeacon, activateICLS, deactivateICLS, eplrs, start, transmitMessage, stopTransmission, smoke_on_off, ActivateLink4, deactivateLink4, activateACLS, deactivateACLS,

Options: ROE, Reaction To Threat, Radar Using, Flare Using, Formation, RTB On Bingo, silence, Disperse on Attack, Alarm State, RTB on Out of Ammo, ECM Using, Prohibit AA, Prohibit Jettison, Prohibit Afterburner, Prohibit AG, Missile Attack Range, Prohibit WP Pass Report, Engage Air Weapons, Option Radio Usage Contact, Option Radio Usage Engage, Option Radio Usage Kill, AC Engagement Range Restriction, jett tanks if empty, forced attack, Altitude Restriction for AAA Min, restrict targets, Altitude Restriction for AAA Max