Targeting Config Reference – Arma 3

From Bohemia Interactive Community
Revision as of 16:30, 19 December 2016 by Ondrejkuzel (talk | contribs) (changed links)
Jump to navigation Jump to search

Template:Cfg ref Template:Cfg ref Note that this is the relevant page for Arma 3 targeting. Implementations for older Arma titles differ somewhat, but are irrelevant for Arma 3.

CfgAmmo

A

airLock

arma3 dev version.gif Property is unused if the ammo uses the new Sensors (Radar, IR...) system.

Requires irLock = 1; to work. Also makes AI to track air units with the given the ammo (weapon). This may not be desirable for non heavy MG weapons as it makes the AI gunner focus on air targets first while ground targets are ignored even if they may actually be the bigger threat.

Integer

airLock = 0; // Cannot target air units
airLock = 1; // Can target air and ground units
airLock = 2; // Can target air units ONLY

artilleryLock

Can lock onto ArtilleryTarget object (created when commanding an AI that operates an artillery piece). Warning: With artilleryLock = 1 the airfriction gets forced to 0 ingame.

Boolean

artilleryLock = 0; 
artilleryLock = 1;

autoSeekTarget

If set to true the missile flies towards a marked target and after reaching lockSeekRadius it searches for the best target (can be still the marked target) and homes in on it. If set to false the missile needs a valid lock first and will only guide towards the locked target. The property is used for example for guided artillery shells.


Boolean

autoSeekTarget = 0;
autoSeekTarget = 1;

C

cameraViewAvailable

arma3 dev version.gif Says whether the missile can provide camera feed after being launched.

Boolean

cameraViewAvailable = 1; // pilot can see the missile's flight from missile's perspective

cmImmunity

Defines the guidance sensitivity to countermeasures (flares, chaff, smoke). 1 makes it completely ignore CM while 0 makes the projectile lose its target immediately after first CM is fired.

Float

cmImmunity = 0; // Projectile loses its target immediately after CM launch
cmImmunity = 1; // Projectile is immune to countermeasures

I

irLock

arma3 dev version.gif Property is unused if the ammo uses the new Sensors (Radar, IR...) system.

Can lock air/ground vehicles (target vehicle must have irTarget=1).

Boolean

irLock = 0;
irLock = 1;

L

laserLock

arma3 dev version.gif Property is unused if the ammo uses the new Sensors (Radar, IR...) system.

Can lock on LaserTarget objects (laserTarget = 1).

Boolean

laserLock = 0;
laserLock = 1;

lockSeekRadius

Specifies the maximum distance from the initial target position where the missile will search for suitable targets if it has autoSeekTarget enabled.

Float

lockSeekRadius = 100; // Current value for all

lockType

Defines ammo dependance on weapon lock. Only works for missiles.

Integer

lockType = 0; // Fire and Forget, currently all guided weapons
lockType = 1; // Operator has to maintain lock (semi-active guidance) NOT IMPLEMENTED
lockType = 2; // Manual guidance

M

maneuvrability

Defines how much the missile is able to turn / how well it can be controlled during the flight.

Float

maneuvrability = 1;  // Default value
maneuvrability = 20; // MissileBase
maneuvrability = 16; // BombCore
maneuvrability = 4;  // NLAW missile
maneuvrability = 14; // SCALPEL missile

manualControl

Missile follows the cursor (unless locked onto a target). maxControlRange, maneuvrability and missile speed are very important for manual control. AI is able to guide missiles manually too.

Boolean

manualControl = 0; // Default value
manualControl = 1; // Titan AT missile

maxControlRange

Defines the distance in meters from the firing platform at which manual control over the missile is lost and it flies in a straight path.

Float

maxControlRange = 4000; // MissileBase
maxControlRange = 5000; // Titan AT missile

missileLockCone

Specifies the maximum angle relative to the ammo current direction at which the missile is able to start locking a target (360 - all around, 180 - front hemisphere,..).

arma3 dev version.gif This doesn't affect missile's Sensor so in theory a missile can detect and track a target outside of its locking range.

Float

missileLockCone = 5;   // DAGR
missileLockCone = 180; // GBU-12
missileLockCone = 50;  // Default (MissileCore)

missileLockMaxDistance

arma3 dev version.gif Specifies the maximum distance at which the missile is able to lock a target. This doesn't affect missile's Sensor so in theory a missile can detect and track a target outside of its locking range.

Float

missileLockMaxDistance = 2000; // missile won't be able to lock targets further than than 2km away

missileLockMinDistance

arma3 dev version.gif Specifies the minimum distance at which the missile is able to lock a target. This doesn't affect missile's Sensor so in theory a missile can detect and track a target outside of its locking range.

Float

missileLockMinDistance = 50; // missile won't be able to lock a target closer than 50m

missileLockMaxSpeed

arma3 dev version.gif Specifies the maximum speed at which the target can be travelling to be still lockable by the missile. This doesn't affect missile's Sensor so in theory a missile can detect and track a faster target than it can lock.

Float

missileLockMaxSpeed = 42; // missile won't be able to lock a target closer that is moving faster than 42km/h

N

nvLock

arma3 dev version.gif Property is unused if the ammo uses the new Sensors (Radar, IR...) system.

Can lock onto NVTarget objects (IR-Grenades thrown by infantry).

Boolean

nvLock = 0; // Default
nvLock = 1; // GBU-12

S

sideAirFriction

Indirectly affects missiles turning / the flight path once the missile changes its orientation. The higher the side friction the more accurate is the maneuvring with the missile.

Float

sideAirFriction = 0.001; // Default (MissileBase)
sideAirFriction = 0.1;   // Titan AA

T

trackLead

​​Range 0-1, how much is the missile performing "smart" tracking, which assumes onboard computer computing predicted target position at the impact time, resulting in a mostly straight flight trajectory.

Float

trackLead = 1; // Missile intercepts
trackLead = 0; // Missile follows

trackOversteer

Simulates manoeuvering errors of the missile.

Float

trackOversteer = 1; // Missiles flies straight to its target
trackOversteer = 0; // Missile never hits its target

W

weaponLockSystem

Defines the type of sensor signature this ammo will emit while locking. The target can then detect it and alert the driver/pilot if its vehicle is equipped with appropriate incomingMissileDetectionSystem. Can be basically any bitmask value, but BI uses the following convention:

Integer

weaponLockSystem = 0; // Undetectable lock
weaponLockSystem = 1; // Visual/Contrast lock
weaponLockSystem = 2; // Infra-red lock
weaponLockSystem = 4; // Laser lock
weaponLockSystem = 8; // Radar lock
weaponLockSystem = "2+4"; // Lock types can be combined (in this case, IR and Laser lock)


CfgWeapons

B

ballisticsComputer

Fire control and aids

Various fire control systems and ballistic aids can be defined (and combined) in a weapon system. Aids based on target motion prediction (1 and 4) require a xxScanner to be able to track the target (Since Arma 3 1.60 they are no longer dependable canLock > 0, only xxScanner values are taken into account. You can mark anything what your sensors are able to detect and use the gained information for fire control.)

Integer

ballisticsComputer = 0; // Disabled
ballisticsComputer = 1; // Automatic zeroing and lead on target, ''FCS abstraction'' (Weapon attempts to calculate and shift the aimpoint to hit a locked target based on range, target movement, own movement, and ballistics of selected ammo type.)
ballisticsComputer = 2; // Manual zeroing
ballisticsComputer = 4; // Target Lead indication; since Arma 3 1.60
ballisticsComputer = 8; // Predicted Impact Point indication; since Arma 3 1.60

C

canLock

Determines if the weapon can lock onto targets allowed by the ammunition it uses.

Integer

canLock = 0; // Disabled
canLock = 1; // Locks only on lower difficulties (Recruit, Cadet), disabled since Arma 3 1.58
canLock = 2; // Always locks

L

lockAcquire

Determines if weapons locks automatically a target within its lock cone or player has to use Lock Target action while pointing at a target.

Boolean

lockAcquire = 0; // player has to select a target himself
lockAcquire = 1; // automatic acquisition of the closest target in missileLockCone

lockingTargetSound

Determines sound played once the selected weapon starts locking a target. The sound is played in a loop while locking. Note the sound is only played if the weapon is a missile.

Sound array : {"path/to/file.wss",<volume priority>,<sound pitch>}

lockingTargetSound[] = {"\A3\Sounds_F\weapons\Rockets\locked_1",0.562341,1}; // Used in missiles_DAGR

lockedTargetSound

Determines sound played once the selected weapon locked its target. The sound is played in a loop until the weapon maintains a lock and is able to fire. Note the sound is only played if the weapon is a missile.

Sound array : {"path/to/file.wss",<volume priority>,<sound pitch>}

lockedTargetSound[] = {"\A3\Sounds_F\weapons\Rockets\locked_1",0.562341,4};

W

weaponLockDelay

Once the locking conditions are met (target is marked, can be locked by this projectile and is in missileLockCone), how much time in seconds would it take for the lock to be achieved.

Float

weaponLockDelay = 0; // Immediate lock if the locking conditions are met
weaponLockDelay = 3; // Most of the guided weapons

weaponLockSystem

Defines the type of sensor signature this weapon will emit while locking. The target can then detect it and alert the driver/pilot if its vehicle is equipped with appropriate lockDetectionSystem. Can be basically any bitmask value, but BI uses the following convention:

Integer

weaponLockSystem = 0; // Undetectable lock
weaponLockSystem = 1; // Visual/Contrast lock
weaponLockSystem = 2; // Infra-red lock
weaponLockSystem = 4; // Laser lock
weaponLockSystem = 8; // Radar lock
weaponLockSystem = "2+4"; // Lock types can be combined (in this case, IR and Laser lock)

CfgVehicles

A

allowTabLock

If true, allows the usage of automatic cycling of targets using Tab (Next Target key assignment - default "R" in Arma 3). Can be used for driver, or each individual turret.

Boolean

allowTabLock = 0; // Tab-lock disabled (man-pads)
allowTabLock = 1; // Most of the vehicles

alwaysTarget

Defines if the vehicle is considered as a training target by AI and IFF sensors (always enemy).

Boolean

alwaysTarget = 0;
alwaysTarget = 1; // VR Targets

artilleryScanner

Enables the Artillery Computer feature and allows the usage of artillery-type weapons more efficiently.

Boolean

artilleryScanner = 0;
artilleryScanner = 1; // Artillery vehicles/mortars

artilleryTarget

Only used by ArtilleryTarget class objects. ArtilleryTarget gets created temporarily on the position designated by a player leader for a subordinate AI artillery operator (Fire Artillery command). Can be locked by projectiles with artilleryLock = 1;

Boolean

artilleryTarget = 0;
artilleryTarget = 1;

C

xxxCanSee

Defines specific tools/sensors for the AI/players when on a specific seat.

  • 1 = CanSeeRadar
  • 2 = CanSeeEye
  • 4 = CanSeeOptics
  • 8 = CanSeeEar
  • 16 = CanSeeCompass
  • 1+16 = CanSeeRadarC
  • 31 = CanSeeAll
  • 32 = CanSeePeripheral //

Integer

driverCanSee = 2+8+16; // The driver of this vehicle can see and hear enemies and use its compass
gunnerCanSee = 1+4+16; // The gunner of this vehicle can detect enemies with optics or radar, and sees a compass
commanderCanSee = 31; // The commander of this vehicle can see and use all its tools

canUseScanners

Can be defined per individual turret. Useful to restrict access to vehicle sensors (target marking) on some positions in vehicles (i.e. door gunners)

Boolean

canUseScanner = 0; // can't use the vehicle's Sensors

I

incomingMissileDetectionSystem

Determines what type of incoming missile can be detected (and shown on the radar?). It checks a match with the weaponLockSystem flags of the Missile (in cfgAmmo) One could also use other flags (e.g. 1, 2, 4, 8) to be more specific about what kind of Missile Detection System is available (paired with appropriate cfgAmmo flags for missiles). Can be basically any bitmask value, but BI uses the following convention:

Integer

incomingMissileDetectionSystem = 0;  // No missile-in-flight detection
incomingMissileDetectionSystem = 1; // Visual/Contrast seeking missile-in-flight - passive, not to be used here
incomingMissileDetectionSystem = 2; // Infra-red seeking missile-in-flight - passive, not to be used here
incomingMissileDetectionSystem = 4; // Laser guided missile-in-flight - passive, not to be used here
incomingMissileDetectionSystem = 8; // Active Radar homing missile-in-flight
incomingMissileDetectionSystem = 16; // Detects all missiles

irScanXXX

arma3 dev version.gif Property is unused if the vehicle uses the new Sensors (Radar, IR...) system.

Those settings can be used instead of irScanRange to make IR+Radar scan range depend on the visibility distance. If there is irScanRange, fixed value is used. The same thing can also be accomplished by setting both irScanRangeMin and irScanRangeMax to the same value.

If there is no irScanRange,IR+Radar scan range is calculated as:

scanRange = visibility_range * irScanToEyeFactor;
if (scanRange<irScanRangeMin) scanRange = irScanRangeMin;
if (scanRange>irScanRangeMax) scanRange = irScanRangeMax;

Where visiblity_range is basically a drawing distance, but may be shortened by rain or fog. Float

irScanToEyeFactor = 1;
irScanRangeMin = 200;
irScanRangeMax = 1000;

irScanGround

arma3 dev version.gif Property is unused if the vehicle uses the new Sensors (Radar, IR...) system.

Can be used to limit target detection to air or groun targets.

Integer

irScanGround = 0; // Can detect and track aerial irTargets only (AAA)
irScanGround = 1; // Can detect and track any irTargets (multirole)
irScanGround = 2; // Can detect and track ground irTargets only (air-to-surface radar, gunships)

irTarget

arma3 dev version.gif Says whether the vehicle - once heated up - can be detected and tracked by an IR Sensor system. Vehicle heats up mainly from a running engine (~ 6 sec to heat up after engine start, 1h to cool down). Firing a weapon or wheels friction also builds up the vehicle's heat signature.


Arma 3 1.66 - Defines if the vehicle can be detected by vehicles equipped with an IR sensor or and locked by weapons that canLock. Used by most of the vehicles emitting heat. If set to 0, the entity wont show up on the radar, won't be trackable by irScan vehicle or lockable by an irLock ammo and the AI won't use anti-vehicular weapons against it.

Boolean

irTarget = 0; // Buildings, men, static defenses, etc...
irTarget = 1; // Ground/Air vehicles

irTargetSize

arma3 dev version.gif Says how big the vehicle's heat signature is once heated up. Works as a coefficient of IR Sensor's range within the given combat situation.

Float

irTargetSize = 0.1; // heated vehicle will be detected by an IR sensor only at 1/10 of the sensors range in the given tactical situation
irTargetSize = 2.0 // maximum value, vehicle can be detected at 2x the sensor's range

L

laserScanner

arma3 dev version.gif Property is unused if the vehicle uses the new Sensors (Radar, IR...) system.

Defines if the vehicle has a Laser Spot Tracker and is able to detect and lock laser targets (for example, CAS jets, gunships).

Boolean

laserScanner = 0;
laserScanner = 1;

laserTarget

Defines if the vehicle can be detected by vehicles equipped with a laser sensor (laserScanner). Used only by LaserTarget and Land_VR_Target.. classes. LaserTarget gets created at the position of laser spot painted by a laser designator.

Boolean

laserTarget = 0;
laserTarget = 1;

lockDetectionSystem

Defines the type of sensor signature this vehicle can detect when its locked. Weapons and Ammo can be configured to emit these signatures with weaponLockSystem in cfgWeapons. The match of targeting Weapon's flag is checked whenever the attacker has the vehicle marked and matching weapon selected. The match of Ammo's flag is checked during the locking process. Can be basically any bitmask value, but BI uses the following convention:

Integer

lockDetectionSystem = 0; // Undetectable lock
lockDetectionSystem = 1; // Visual/Contrast lock
lockDetectionSystem = 2; // Infra-red lock
lockDetectionSystem = 4; // Laser lock
lockDetectionSystem = 8; // Radar lock
lockDetectionSystem = "2+4"; // Lock types can be combined (in this case, IR and Laser lock)

N

nvScanner

arma3 dev version.gif Property is unused if the vehicle uses the new Sensors (Radar, IR...) system.

Defines if the vehicle is able to detect and lock Night-Vision targets (used by IR-Grenades).

Boolean

nvScanner = 0;
nvScanner = 1;

nvTarget

Defines if the vehicle can be detected by vehicles equipped with a night-vision sensor (nvScanner). Used only by NVTarget and Land_VR_Target.. classes. NV target gets created on the position of ammo with

simulation = "shotNVGMarker";

Boolean

nvTarget = 0;
nvTarget = 1;


P

class pilotCamera

Gives the pilot access to a targeting pod (or some CCTV) and control over it in a full screen display feed (via *Multifunction camera* action, Ctrl+RMB by default).

class pilotCamera
{
 
    class OpticsIn
    {
        //different optics mode, same as in turrets
    }
 
    minTurn = - 90; //yaw limits
    maxTurn=   90;  //yaw limits
    initTurn= 0;  //initial yaw angle
    minElev = - 90; //pitch limits
    maxElev =   90; //pitch limits
    initElev =  0; //initial pitch angle
    maxXRotSpeed = 0.5; // yawing speed
    maxYRotSpeed = 0.5; // pitching speed
    pilotOpticsShowCursor = 1; //to show aimCursor (is useful to see plane direction)
    controllable = 1; // set false to have static camera
 };

Related commands: hasPilotCamera, getPilotCameraPosition, getPilotCameraDirection, getPilotCameraRotation, getPilotCameraTarget, setPilotCameraDirection, setPilotCameraRotation, setPilotCameraTarget

R

radarTarget

arma3 dev version.gif Says whether the vehicle can be detected and tracked by a RADAR Sensor.

Boolean

radarTarget = 1; // can be detected by RADAR

radarTargetSize

arma3 dev version.gif Radar cross-section coefficient of the vehicle. Works as a coefficient of RADAR Sensor's range within the given combat situation.

Early test values - to be adjusted by gameplay testing

  • 0.1 - stealth airplanes (<0.0005m2 RCS)
  • 0.7 - small fighter (~1m2 RCS)
  • 1.0 - mid sized fighter (~5m2 RCS)
  • 1.2 - tank (~10m2 RCS)
  • 2.0 - large bomber, small ship and bigger (>80m2 RCS)

Float

radarTargetSize = 0.1; // vehicle will be detected by a visual spectrum sensor only at 1/10 of the sensors range in the given tactical situation
radarTargetSize = 2.0 // maximum value, vehicle can be detected at 2x the sensor's range

radarType

Old Radar and targets indication

arma3 dev version.gif Property is unused if the vehicle uses the new Sensors (Radar, IR...) system.

Defines the type of radar UI the vehicle will use.

Integer

radarType = 0; // No radar (used for infantry)
radarType = 1; // Tactical display (not used)
radarType = 2; // Vehicle radar (used for AAA) - shows compass, turret directions and targets
radarType = 4; // Air radar (used for jets and gunships)  - shows compass, turret directions and targets
radarType = 8; // Compass + turret directions (used for majority of vehicles and their turret positions)  - shows compass and turret directions

S

showAllTargets

showAllTargets indication

Vehicle/turret setting. Displays all targets known to vehicle sensors in via the ingame UI. Values can be combined.

Integer

showAllTargets = 0; //LockNo
showAllTargets = 1; //LockCadet, show targets from all sensors, but only on lower difficulty; disabled since Arma 3 1.58
showAllTargets = 2; //LockYes, show targets from all sensors 
showAllTargets = 4; //LockLaser, show only targets from laser spot tracker (laserScanner); since Arma 3 1.60


showCrewAim

showCrewAim indication

Vehicle/turret setting. Displays gunner/commander turret aimpoints on the in-game UI. Disabled when crosshair is turned off in difficulty since Arma 3 1.68

Integer

showCrewAim = 0; // disabled
showCrewAim = 1; // show primary gunner
showCrewAim = 2; // show commander
showCrewAim = 4; // show all
showCrewAim = 1+2+4; // values can be combined

V

visualTarget

arma3 dev version.gif Says whether the vehicle can be detected and tracked by a Visual sensor (electro-optical sensors in vis. spectrum, contrast seekers).

Boolean

visualTarget = 1; // can be detected by visual sensor

visualTargetSize

arma3 dev version.gif Contrast and visual distinguishability properties of the vehicle. Works as a coefficient of Visual Sensor's range within the given combat situation.

Float

visualTargetSize = 0.1; // vehicle will be detected by a visual spectrum sensor only at 1/10 of the sensors range in the given tactical situation
visualTargetSize = 2.0 // maximum value, vehicle can be detected at 2x the sensor's range

Template:Cfg ref

Related