DCS option engagementRange

From DCS World Wiki - Hoggitworld.com
Revision as of 00:31, 19 June 2026 by Grimes (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)


Task: Engagement Range Restriction Added with: 2.5.6
Hierarchy: Scripting Root > Tasks > Option > Engagement Range Restriction
Tasking Type: Option
For: Ground Vehicles
Available Under: Everything
Description: Defines the range at which the unit is allowed to use its weapons automatically.

Behaviors:

Value is a number. If set to 50 then the AI will be limited to 50% of their maximum weapons range.

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

Option Identifier:

AI.Option.Ground.id.AC_ENGAGEMENT_RANGE_RESTRICTION

Option Values:

0 to 100
Enumerators: AC_ENGAGEMENT_RANGE_RESTRICTION= 24
Examples: The following will set the engagement range to a random value between 30 and 70 percent the range of the sam.
   local gp = Group.getByName("SA10")
   local con = gp:getController()
   con:setOption(24, math.random(30, 70))
Notes: See article Mission Editor: AI Tasking for more information on how AI tasking is handled within DCS.
Task List: Task Wrappers: mission, ComboTask, ControlledTask, WrappedAction


Tasks: AttackGroup, AttackUnit, Bombing, Strafing, CarpetBombing, AttackMapObject, BombingRunway, orbit, refueling, land, follow, followBigFormation, escort, Embarking, fireAtPoint, hold, FAC_AttackGroup, EmbarkToTransport, DisembarkFromTransport, CargoTransportation, goToWaypoint, groundEscort, RecoveryTanker

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

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

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, Prefer Vertical, Evasion Of ARM, Formation Interval, Allow Formation Side Swap