BIS Game Engine Scripting Commands

Page 1 of 415

!a
Operand types: a: Boolean Type of returned value: Boolean Description: not a Example: !true , result is false Category: Default

grp1 != grp2
Operand types: grp1: Group grp2: Group Type of returned value: Boolean Description: Checks whether two groups are different. If either of them is grpNull, true is returned. Example: group player != group soldierOne Category: OFP

a != b
Operand types: a: Number b: Number Type of returned value: Boolean Description: a is not equal to b Example: counter != 4 Category: Default

location1 != location2
Operand types: location1: Location

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 2 of 415

location2: Location Type of returned value: Boolean Description: Checks whether two locations are different. If either of them is null, true is returned. Category: Location

a != b
Operand types: a: String b: String Type of returned value: Boolean Description: a is not equal to b (case insensitive) Example: nameOfPlayer != "John Doe" Category: Default

text1 != text2
Operand types: text1: Structured text text2: Structured text Compatibility: Version 2.01 required. Type of returned value: Boolean Description: Checks whether two structured text values are different. Category: OFP

side1 != side2
Operand types: side1: Side side2: Side Type of returned value: Boolean Description: Checks whether two side values are different. Example:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 3 of 415

side player != west Category: OFP

control1 != control2
Operand types: control1: Control control2: Control Compatibility: Version 2.50 required. Type of returned value: Boolean Description: Checks whether two controls are different. Category: OFP PC

task1 != task2
Operand types: task1: Task task2: Task Compatibility: Version 2.92 required. Type of returned value: Boolean Description: Checks whether two tasks are different. Category: Identity

obj1 != obj2
Operand types: obj1: Object obj2: Object Type of returned value: Boolean Description: Checks whether two objects are different. If either of them is objNull, true is returned. Example: vehicle player != player Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 4 of 415

display1 != display2
Operand types: display1: Display display2: Display Compatibility: Version 2.50 required. Type of returned value: Boolean Description: Checks whether two displays are different. Category: OFP PC

config1 != config2
Operand types: config1: Config config2: Config Compatibility: Version 2.58 required. Type of returned value: Boolean Description: Checks whether two config entries are different. Category: OFP PC

a%b
Operand types: a: Number b: Number Type of returned value: Number Description: The remainder of a divided by b. Note that the remainder is calculated in the real domain. Example: 4.5 % 3 , result is 1.5 Category: Default

a && b
Operand types: a: Boolean b: Boolean

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 5 of 415

Type of returned value: Boolean Description: a and b Example: alive player && alive leader player Category: Default

a*b
Operand types: a: Number b: Number Type of returned value: Number Description: a multiplied by b Example: iCounter*3 Category: Default

+a
Operand types: a: Number Type of returned value: Number Description: unary plus: returns a Example: +4 , result is 4 Category: Default

+a
Operand types: a: Array Type of returned value: Array Description: unary plus: returns a copy of the array

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 6 of 415

Example: + [0, 1, 2] , result is [0, 1, 2] Category: Default

a+b
Operand types: a: Number b: Number Type of returned value: Number Description: a plus b Example: counter + 1 Category: Default

arrayA + arrayB
Operand types: arrayA: Array arrayB: Array Type of returned value: Array Description: arrayA and arrayB are concatenated. Example: [0, 1, 2] + [1, 2, 3] , result is [0, 1, 2, 1, 2, 3] Category: Default

stringA + stringB
Operand types: stringA: String stringB: String Type of returned value: String Description: stringA and stringB are concatenated. Example: "I" + " am" + " blind" , result is "I am blind"

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 7 of 415

Category: Default

-a
Operand types: a: Number Type of returned value: Number Description: unary minus: zero minus a Example: - - 3 , result is 3 Category: Default

a-b
Operand types: a: Number b: Number Type of returned value: Number Description: a minus b Example: counter - 1 Category: Default

arrayA - arrayB
Operand types: arrayA: Array arrayB: Array Type of returned value: Array Description: All elements in arrayB are removed from arrayA. Example: [0, 1, 2, 4, 0, 1, 2, 3, 4, 5] - [1, 2, 3] , result is [0, 4, 0, 4, 5] Category: Default

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 8 of 415

a/b
Operand types: a: Number b: Number Type of returned value: Number Description: a divided by b Example: enemyStrenght/3 Category: Default

config / name
Operand types: config: Config name: String Compatibility: Version 2.92 required. Type of returned value: Config Description: Returns subentry of config entry with given name (alias for >>). Example: configFile / "CfgVehicles" Category: OFP PC

a:b
Operand types: a: Switch Type b: Code Type of returned value: Nothing Description: see switch Category: Default

a<b
Operand types: a: Number

http://www.arma2.com/comref/full.html

7/11/2010

Type of returned value: http://www.html 7/11/2010 . Type of returned value: Boolean Description: Checks whether two displays are equal.com/comref/full.BIS Game Engine Scripting Commands Page 9 of 415 b: Number Type of returned value: Boolean Description: a lesser than b Example: counter < 4 Category: Default a <= b Operand types: a: Number b: Number Type of returned value: Boolean Description: a lesser or equal than b Example: player distance redCar <= 100 Category: Default display1 == display2 Operand types: display1: Display display2: Display Compatibility: Version 2. Category: OFP PC control1 == control2 Operand types: control1: Control control2: Control Compatibility: Version 2.arma2.50 required.50 required.

Category: OFP PC side1 == side2 Operand types: side1: Side side2: Side Type of returned value: Boolean Description: Checks whether two side values are equal. If either of them is objNull.BIS Game Engine Scripting Commands Page 10 of 415 Boolean Description: Checks whether two controls are equal.arma2. Example: side player == west Category: OFP obj1 == obj2 Operand types: obj1: Object obj2: Object Type of returned value: Boolean Description: Checks whether two objects are the same.com/comref/full. Type of returned value: Boolean Description: Checks whether two config entries are equal. false is returned.html 7/11/2010 .58 required. http://www. Example: player == leader player Category: OFP config1 == config2 Operand types: config1: Config config2: Config Compatibility: Version 2.

Category: Identity text1 == text2 Operand types: text1: Structured text text2: Structured text Compatibility: Version 2. If either of them is grpNull.01 required. false is returned.com/comref/full. Example: group player == group soldierOne Category: OFP a == b http://www.arma2. Type of returned value: Boolean Description: Checks whether two tasks are equal. Category: OFP grp1 == grp2 Operand types: grp1: Group grp2: Group Type of returned value: Boolean Description: Checks whether two groups are the same.92 required. Type of returned value: Boolean Description: Checks whether two structured text values are equal.BIS Game Engine Scripting Commands Page 11 of 415 Category: OFP PC task1 == task2 Operand types: task1: Task task2: Task Compatibility: Version 2.html 7/11/2010 .

html 7/11/2010 .arma2.com/comref/full. Category: Location a == b Operand types: a: String b: String Type of returned value: Boolean Description: a equal to b (case insensitive) Example: nameOfPlayer == "John Doe" Category: Default a>b Operand types: a: Number b: Number Type of returned value: Boolean Description: http://www. If either of them is null.BIS Game Engine Scripting Commands Page 12 of 415 Operand types: a: Number b: Number Type of returned value: Boolean Description: a equal to b Example: counter == 4 Category: Default location1 == location2 Operand types: location1: Location location2: Location Type of returned value: Boolean Description: Checks whether two locations are the same. false is returned.

35 required.arma2.BIS Game Engine Scripting Commands Page 13 of 415 a greater than b Example: counter > 4 Category: Default a >= b Operand types: a: Number b: Number Type of returned value: Boolean Description: a greater or equal than b Example: player distance redCar < 100 Category: Default config >> name Operand types: config: Config name: String Compatibility: Version 2.com/comref/full. Example: configFile >> "CfgVehicles" Category: OFP PC a^b Operand types: a: Number b: Number Type of returned value: Number Description: a raised to the power of b http://www.html 7/11/2010 . Type of returned value: Config Description: Returns subentry of config entry with given name.

Example: abs -3 .com/comref/full. Category: OFP acos x http://www. result is 3 Category: Default accTime Type of returned value: Number Description: Returns the current time acceleration factor.BIS Game Engine Scripting Commands Page 14 of 415 Example: count^4 Category: Default a || b Operand types: a: Boolean b: Boolean Type of returned value: Boolean Description: a or b Example: !alive player || !alive leader player Category: Default abs x Operand types: x: Number Type of returned value: Number Description: The absolute value of x.arma2.html 7/11/2010 .

maxKeys]: String or Array http://www. param3 are type specific. target defaults to unit and param1.BIS Game Engine Scripting Commands Page 15 of 415 Operand types: x: Number Type of returned value: Number Description: The arccosine of x. Example: array = actionKeys "ReloadMagazine" Category: OFP actionKeysImages action or [action. Example: soldierOne action ["eject". Type of returned value: Array Description: Returns a list of dikCodes of buttons assigned to the given user action. maxKeys] Operand types: action or [action. param3].arma2. result is 60 Category: Default unit action action Operand types: unit: Object action: Array Type of returned value: Nothing Description: Makes the unit peform an action. vehicle soldierOne] Category: OFP actionKeys action Operand types: action: String Compatibility: Version 2. the result is in degrees. param2. target. param2.01 required. Example: acos 0. param1.5 . The format of action can be [type.com/comref/full.html 7/11/2010 . Only type is required.

arma2. The list of active addons is initialized during this function. Example: list = actionKeysNames "ReloadMagazine" Category: OFP activateAddons [addon1. maxKeys]: String or Array Compatibility: Version 2. You can find the action names in config class ControllerSchemes.01 required.]: Array Compatibility: Version 2. . Type of returned value: Structured text Description: Returns a list of button images or names assigned to the given user action. A maximum of maxKeys keys is listed.html 7/11/2010 .01 required. Type of returned value: String Description: Returns a list of button names assigned to the given user action.. Type of returned value: Nothing Description: Activates the listed addons..32 required.] Operand types: [addon1.BIS Game Engine Scripting Commands Page 16 of 415 Compatibility: Version 2.com/comref/full. A maximum of maxKeys keys is listed.. You can find the action names in config class ControllerSchemes. . maxKeys] Operand types: action or [action.. Example: activateAddons ["BISOFP"] Category: OFP activateKey keyName http://www. Example: text = actionKeysImages "ReloadMagazine" Category: OFP actionKeysNames action or [action.

value1. but due to a bug. etc.10 required. subtype class]: Array Compatibility: Version 2.html 7/11/2010 .06 required.com/comref/full. condition)]: Array Compatibility: Version 1. the next vehicle has ID one.]. value1. script filename(. priority. hideOnUse. condition)] Operand types: unit: Object [action. [name1. arguments. [name1. Create script is called with _new equal to true. Type of returned value: String Description: Add an object to the editor and assign arguments. use following algorithm: the first action added to the given vehicle has ID zero. showWindow. Type of returned value: Description: Creates an action. See keys.. The action ID should be returned. The keys are used to unlock missions or campaigns. To determine the action ID. showWindow.ext file of the missions. keysLimit and doneKeys in the description. script filename(.92 required. Example: activateKey "M04" Category: OFP unit addAction [action. Type of returned value: Nothing Description: Activates the given key for the current user profile. . "hello.. .BIS Game Engine Scripting Commands Page 17 of 415 Operand types: keyName: String Compatibility: Version 2. shortcut. priority. Category: Editor http://www. shortcut. subtype class] Operand types: map: Control [type. Example: player addAction ["Hello".. Subtype class is optional..arma2.sqs"] Category: OFP map addEditorObject [type.]. hideOnUse. arguments. Returns the ID of the new EditorObject. it's not.

The index of the currently added handler is returned.sqs"}] Category: OFP group addGroupIcon properties Operand types: group: Group properties: Array Compatibility: Version 5501 required. Type of returned value: Number Description: Add icon to a group.{_this exec "playerKilled. Check scripting topic Event handlers for more information. Returns icon ID Example: id = group addGroupIcon["b_inf". Example: http://www.command].10 required.ofsetY]] Category: OFP unit addLiveStats score Operand types: unit: Object score: Number Compatibility: Version 2.com/comref/full.[offsetX. Type of returned value: Description: The format of handler is [type.arma2. Type of returned value: Nothing Description: Xbox Live MP only: adds score to the Xbox Live Statistics score for the given unit (or the commander unit of the given vehicle). Example: player addEventHandler ["killed".BIS Game Engine Scripting Commands Page 18 of 415 object addEventHandler handler Operand types: object: Object handler: Array Compatibility: Version 1.85 required.html 7/11/2010 .

for example by adding 20 grenades. Example: rearmTruckOne addMagazineCargo ["M16". Type of returned value: Nothing Description: Adds count magazines of type name into the weapon pool (used in the campaign to transfer weapons to the next mission). Example: player addMagazine "M16" Category: OFP unit addMagazineCargo magazines Operand types: unit: Object magazines: Array Type of returned value: Nothing Description: Adds magazines to the weapon cargo space.BIS Game Engine Scripting Commands Page 19 of 415 player addLiveStats 10 Category: OFP unit addMagazine weaponName Operand types: unit: Object weaponName: String Type of returned value: Nothing Description: Adds a magazine to the unit.com/comref/full. When doing so. Note: you may create invalid combinations by using this function. application behaviour is undefined. The format of magazines is [magazineName. For magazineName values see CfgWeapons.75 required.arma2. This is used for infantry weapons. 10] Category: OFP addMagazinePool Compatibility: Version 1.html 7/11/2010 . Category: Resistance http://www. count].

The event handler will be executed when some client in MP exports a variable using publicVariable on all clients except the publishing one. Category: Editor map addMenuItem [menu or index.BIS Game Engine Scripting Commands Page 20 of 415 map addMenu [text. priority is optional and determines where in the menu the item will reside (higher priority items first).command.priority] Operand types: map: Control [menu or index. Type of returned value: Number Description: Creates a new menu item. Priority is optional. Category: Editor name addPublicVariableEventHandler code Operand types: name: String code: Code Type of returned value: Nothing Description: Create an event handler for given variable.92 required.priority]: Array Compatibility: Version 2.html 7/11/2010 .com/comref/full.arma2.priority]: Array Compatibility: Version 2.92 required. index is index as returned from addMenu command. Menu can be "file" or "view".text.text. Example: "alarm" addPublicVariableEventHandler {_this execVM "alarm.command. Type of returned value: Number Description: Adds a new menu button.priority] Operand types: map: Control [text.sqf"} Category: OFP unit addRating number http://www.

This is shown in the "I" MP screen as the total score. Example: player addRating 1000 Category: OFP unit addScore score Operand types: unit: Object score: Number Type of returned value: Nothing Description: MP only: adds unit score. The rating for killed enemies and killed friendlies is adjusted automatically. This is usually used to reward for completed mission objectives.html 7/11/2010 .com/comref/full. Type of returned value: Nothing Description: Add a unit into the list of units available for team switch.BIS Game Engine Scripting Commands Page 21 of 415 Operand types: unit: Object number: Number Type of returned value: Nothing Description: Adds number to the unit rating.arma2. When the rating is lower than zero. Example: player addScore 10 Category: OFP addSwitchableUnit person Operand types: person: Object Compatibility: Version 2. a unit is considered "renegade" and is an enemy to everyone. Category: OFP group addVehicle vehicle Operand types: group: Group vehicle: Object http://www.92 required.

0] Category: OFP unit addWeapon weaponName Operand types: unit: Object weaponName: String Type of returned value: Nothing Description: Adds the weapon to the unit. Example: player addWeapon "AK74" Category: OFP unit addWeaponCargo weapons Operand types: unit: Object http://www. The waypoint is placed randomly in a circle with the given center and radius. radius] or [center. radius. radius] or [center. application behaviour is undefined. for example by adding two rifles. Category: OFP group addWaypoint [center. When doing so. radius. The function returns a waypoint with format [group.arma2.com/comref/full. Type of returned value: Nothing Description: Tells the group it owns the vehicle now. Type of returned value: Array Description: Adds (or inserts when index is given) a new waypoint to a group. index] Operand types: group: Group [center. index].BIS Game Engine Scripting Commands Page 22 of 415 Compatibility: Version 5128 required. Example: grp addWaypoint [position player. Note: you may create invalid combinations by using this function.86 required. index]: Array Compatibility: Version 1.html 7/11/2010 .

Example: rearmTruckOne addWeaponCargo ["M16". Example: airportSide 0 .unit.arma2. Type of returned value: Nothing Description: Adds count weapons of type name into the weapon pool (used in campaigns to transfer weapons to the next mission).bool]: Array Compatibility: Version 5501 required. This is used for infantry weapons. count] Operand types: [name.92 required. The format of weapons is [weaponName. Type of returned value: Nothing Description: Checks a side of the airport.BIS Game Engine Scripting Commands Page 23 of 415 weapons: Array Type of returned value: Nothing Description: Adds weapons to the weapon cargo space.html 7/11/2010 . result is west Category: OFP AISFinishHeal [unit.bool] Operand types: [unit. Category: Resistance airportSide airportId Operand types: airportId: Number Compatibility: Version 2.unit. For weaponName values see CfgWeapons. count]: Array Compatibility: Version 1.com/comref/full. count].75 required. http://www. 10] Category: OFP addWeaponPool [name.

arma2. Example: alive player Category: OFP allGroups Compatibility: Version 5501 required.92 required.medic.com/comref/full.BIS Game Engine Scripting Commands Page 24 of 415 Type of returned value: Nothing Description: AIS end state. vehicle or building is't dead / destroyed.true] Category: OFP alive obj Operand types: obj: Object Type of returned value: Boolean Description: Checks whether the given person. Category: OFP map allow3DMode bool Operand types: map: Control bool: Boolean Compatibility: Version 2.html 7/11/2010 . Example: AISFinishHeal [wounded. Category: Editor http://www. Type of returned value: Array Description: Return a list of all groups. Type of returned value: Nothing Description: Allow/dissallow 3D mode.

arma2. Category: OFP obj allowDammage allow Operand types: obj: Object allow: Boolean Type of returned value: Nothing Description: Obsolete. Type of returned value: Nothing Description: Allow/dissallow file ops (load/save etc).92 required. Category: OFP map allowFileOperations bool Operand types: map: Control bool: Boolean Compatibility: Version 2.BIS Game Engine Scripting Commands Page 25 of 415 obj allowDamage allow Operand types: obj: Object allow: Boolean Type of returned value: Nothing Description: Obsolete.html 7/11/2010 . Category: Editor unit allowFleeing courage Operand types: unit: Object or Group courage: Number Type of returned value: Nothing Description: http://www.com/comref/full.

BIS Game Engine Scripting Commands Page 26 of 415 Sets the group courage. The less courage. Type of returned value: Array Description: Return a list of all units (all persons except agents).arma2. Example: player ammo "M16" Category: OFP http://www. Category: OFP unit ammo magazine Operand types: unit: Object magazine: String Type of returned value: Number Description: Counts how many shots the unit has left for the given magazine type. Example: [unitOne. Example: soldierOne allowFleeing 0 Category: OFP unitArray allowGetIn allow Operand types: unitArray: Array allow: Boolean Type of returned value: Nothing Description: Allows the getting in of vehicles of all units in the list. 0 means maximum courage. unitTwo] allowGetIn false Category: OFP allUnits Compatibility: Version 5501 required.com/comref/full. while 1 means always fleeing.html 7/11/2010 . the sooner the group will start fleeing.

phase] Operand types: object: Object [animation.arma2.html 7/11/2010 .75 required. Type of returned value: Nothing Description: Process animation on object. Animation is defined in config file. Wanted animation phase is set to phase.75 required. phase]: Array Compatibility: Version 1.BIS Game Engine Scripting Commands Page 27 of 415 a and b Operand types: a: Boolean b: Boolean Type of returned value: Boolean Description: a and b Example: alive player and alive leader player Category: Default object animate [animation. 1] Category: Resistance object animationPhase animation Operand types: object: Object animation: String Compatibility: Version 1. Type of returned value: Number Description: Return animation phase of animation on object.com/comref/full. Example: house animationPhase "doors1" Category: Resistance http://www. Example: house animate ["doors1".

arma2. the result is in degrees. result is 30 Category: Default assert codition Operand types: codition: Boolean Compatibility: Version 2. Category: OFP armoryPoints Compatibility: Version 5500 required. Type of returned value: Boolean http://www.92 required. Category: OFP asin x Operand types: x: Number Type of returned value: Number Description: The arcsine of x.00 required.html 7/11/2010 .BIS Game Engine Scripting Commands Page 28 of 415 animationState man Operand types: man: Object Compatibility: Version 2.com/comref/full. Example: asin 0. Type of returned value: Number Description: Return the stored value of armory points. Type of returned value: String Description: Return the name of the current primary animation.5 .

html 7/11/2010 . Example: assert (_x>0) Category: Default soldier assignAsCargo vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Nothing Description: Assigns the soldier to the cargo / passenger space of the given vehicle.BIS Game Engine Scripting Commands Page 29 of 415 Description: Tests a condition and if the condition is false. halts the program.arma2. Example: player assignAsCommander tankOne Category: OFP soldier assignAsDriver vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Nothing Description: Assigns the soldier as driver of the given vehicle.com/comref/full. Example: player assignAsCargo tankOne Category: OFP soldier assignAsCommander vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Nothing Description: Assigns the soldier as commander of the given vehicle. http://www.

Category: OFP assignedCommander vehicle Operand types: vehicle: Object Compatibility: Version 5501 required. Category: OFP http://www. Type of returned value: Array Description: Returns the list of soldiers assigned to the given vehicle as a cargo.html 7/11/2010 .com/comref/full.arma2. Type of returned value: Object Description: Returns the soldier assigned to the given vehicle as a commander.BIS Game Engine Scripting Commands Page 30 of 415 Example: player assignAsDriver tankOne Category: OFP soldier assignAsGunner vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Nothing Description: Assigns the soldier as gunner of the given vehicle. Example: player assignAsGunner tankOne Category: OFP assignedCargo vehicle Operand types: vehicle: Object Compatibility: Version 5501 required.

Category: OFP assignedGunner vehicle Operand types: vehicle: Object Compatibility: Version 5501 required.arma2. Category: OFP assignedVehicle person Operand types: person: Object Compatibility: Version 5130 required. Type of returned value: Object Description: Returns the soldier assigned to the given vehicle as a gunner. Category: OFP assignedTarget vehicle Operand types: vehicle: Object Compatibility: Version 2.92 required.html 7/11/2010 .BIS Game Engine Scripting Commands Page 31 of 415 assignedDriver vehicle Operand types: vehicle: Object Compatibility: Version 5501 required. Type of returned value: Object Description: http://www. Type of returned value: Object Description: Return the target assigned to the vehicle.com/comref/full. Type of returned value: Object Description: Returns the soldier assigned to the given vehicle as a driver.

Type of returned value: Nothing Description: Set airport to be used by AI on getout Example: http://www. Type of returned value: Nothing Description: Assigns the vehicle (specifically its commander unit) to the given team.com/comref/full. Type of returned value: Array Description: Return the position in vehicle person is assigned to.arma2. "GREEN". "BLUE" and "YELLOW".html 7/11/2010 . Category: OFP assignedVehicleRole person Operand types: person: Object Compatibility: Version 5130 required.BIS Game Engine Scripting Commands Page 32 of 415 Return the vehicle person is assigned to.92 required. "RED".05 required. Category: OFP vehicle assignTeam team Operand types: vehicle: Object team: String Compatibility: Version 2. Example: soldier2 assignTeam "RED" Category: OFP airplane assignToAirport airportId Operand types: airplane: Object airportId: Number Compatibility: Version 2. The possible team values are: "MAIN".

html 7/11/2010 .BIS Game Engine Scripting Commands Page 33 of 415 plane assignToAirport 0 Category: OFP atan x Operand types: x: Number Type of returned value: Number Description: The arctangens of x. result is 45 Category: Default http://www.0362 Category: Default atg x Operand types: x: Number Type of returned value: Number Description: The arctangens of x. the result is in degrees. result is 59. Example: atan 1 . Example: 5 atan2 3 . in the range from -180 to +180. Example: atg 1 .com/comref/full. result is 45 Category: Default x atan2 y Operand types: x: Number y: Number Type of returned value: Number Description: Returns the arctangens of x/y. the result is in degrees. The returned value is in degrees. using the signs of both parameters to determine the quadrant of the returned value.arma2.

[0. Category: Location obj attachTo [obj.arma2.html 7/11/2010 . offset.com/comref/full.BIS Game Engine Scripting Commands Page 34 of 415 attachedObject location Operand types: location: Location Compatibility: Version 2.90 required. MemPoint] Operand types: obj: Object [obj. Example: player attachTo [car.2.0]. The offset is applied to the object center unless a memory point is provided.hatch1] Category: OFP attackEnabled group Operand types: http://www. offset. Type of returned value: Object Description: Return object attached to given location.90 required. Type of returned value: Nothing Description: Attach a object to given location. Category: Location location attachObject object Operand types: location: Location object: Object Compatibility: Version 2. MemPoint]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Attaches an object to another object.

Example: behaviour player Category: OFP benchmark Type of returned value: Number Description: Returns the value of "3D performance" as it is in OFP preferences."COMBAT" or "STEALTH").92 required."SAFE"."AWARE". This can be used to estimate computer performance. Example: ? benchmark>2000 : setviewdistance 2000 Category: OFP boundingBox object Operand types: object: Object Compatibility: Version 2. Type of returned value: Boolean Description: Return whether leader can issue attack commands. Category: OFP behaviour unit Operand types: unit: Object Type of returned value: String Description: Returns the behaviour mode of the given unit ("CARELESS".BIS Game Engine Scripting Commands Page 35 of 415 group: Object or Group Compatibility: Version 2.com/comref/full. The function can be used to create missions that are able to adapt to computer peformance.html 7/11/2010 .arma2. Type of returned value: Array Description: http://www.92 required.

Nil is returned. minY]. Category: Default breakTo name Operand types: name: String Type of returned value: Nothing Description: Breaks block to scope named 'name'. maxZ. Category: Default building buildingExit index Operand types: building: Object index: Number http://www.BIS Game Engine Scripting Commands Page 36 of 415 Returns a bounding box of given object in model coordinates space. Nil is returned. [maxX.arma2.com/comref/full. The result is in format [x. The result is in format [[minX. Type of returned value: Array Description: Returns the position of original (loaded) center of object in model coordinates. maxY]]. Category: OFP boundingCenter object Operand types: object: Object Compatibility: Version 5501 required. z. minZ. y] Category: OFP breakOut name Operand types: name: String Type of returned value: Nothing Description: Breaks block out scope named 'name'.html 7/11/2010 .

Example: buildingExit [building. Type of returned value: String Description: Returns the action assigned to the given button or active text. The returned value is in format Position.com/comref/full.50 required. http://www.BIS Game Engine Scripting Commands Page 37 of 415 Type of returned value: Array Description: Returns the given indexed exit in a building. Example: building buildingPos 1 Category: OFP buttonAction control Operand types: control: Control Compatibility: Version 2. The returned value is in format Position. 1] Category: OFP building buildingPos index Operand types: building: Object index: Number Type of returned value: Array Description: Returns the given indexed position in a building.92 required.html 7/11/2010 .arma2. Example: _action = buttonAction _button Category: OFP PC buttonAction idc Operand types: idc: Number Compatibility: Version 1. The action is any expression in this scripting language.

Action is any expression in this scripting language.arma2.sqs"""] Category: Resistance control buttonSetAction action Operand types: control: Control action: String Compatibility: Version 2. Type of returned value: Nothing Description: Assigns an action to the control with id idc of the topmost user dialog.sqs""" Category: OFP PC cadetMode http://www. Example: buttonSetAction [100. Example: _action = buttonAction 100 Category: Resistance buttonSetAction [idc.50 required. action] Operand types: [idc. Type of returned value: Nothing Description: Assigns an action to the given button or active text. The action is any expression in this scripting language. "player exec ""reply. The function can be used for buttons and active texts. Example: _control buttonSetAction "player exec ""reply. action]: Array Compatibility: Version 1. Action is any expression in this scripting language.html 7/11/2010 .BIS Game Engine Scripting Commands Page 38 of 415 Type of returned value: String Description: Returns the action assigned to the control with id idc of the topmost user dialog.com/comref/full. The function can be used for buttons and active texts.91 required.

Type of returned value: Any Description: Executes the given code. Argument pars is passed as _this. Type of returned value: Any Description: Executes the function body.BIS Game Engine Scripting Commands Page 39 of 415 Type of returned value: Boolean Description: Returns true if the mission is played in cadet mode and false in veteran mode.85 required. result is 3 Category: Default camera camCommand command Operand types: camera: Object command: String Type of returned value: Nothing Description: http://www. Category: OFP call code Operand types: code: Code Compatibility: Version 1. Example: call {"x=2"} Category: Default pars call body Operand types: pars: Any body: Code Compatibility: Version 1. Example: [1.arma2.com/comref/full.html 7/11/2010 .85 required.2] call {(_this select 0)+(_this select 1)} .

A time of zero results in an immediate change. Type of returned value: Nothing Description: Commits the prepared camera changes smoothly over time. Example: _camera camCommit 5 Category: OFP camera camCommitPrepared time Operand types: camera: Object time: Number Compatibility: Version 2.arma2.BIS Game Engine Scripting Commands Page 40 of 415 Executes a command on the given camera / actor object. A time of zero results in an immediate change.html 7/11/2010 . the following commands can be used: "inertia on" and "inertia off". Example: _camera camCommit 5 Category: OFP camCommitted camera Operand types: camera: Object Type of returned value: Boolean http://www. The "manual on" and "manual off" commands are recognized for all types. For the "seagull" type it's one of: "landed" and "airborne".com/comref/full. For the "camera" type.95 required. Example: _camera camCommand "Manual on" Category: OFP camera camCommit time Operand types: camera: Object time: Number Type of returned value: Nothing Description: Commits the camera changes smoothly over time.

Example: _camera camConstuctionSetParams [getpos player. max above land] Operand types: camera: Object [[x.50.y.20] Category: OFP type camCreate position Operand types: type: String position: Array Type of returned value: Object Description: Creates a camera or an actor of the given type on the given initial position (format Position). Example: _camera = camCreate getPos player Category: OFP camDestroy camera Operand types: camera: Object Type of returned value: Nothing Description: http://www.arma2.z].y.radius. Type of returned value: Nothing Description: Sets construction camera parameters.z].com/comref/full. Example: camCommitted _camera Category: OFP camera camConstuctionSetParams [[x. max above land]: Array Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 41 of 415 Description: Checks whether the camera has finished committing.html 7/11/2010 . Its type is one of "CAMERA" or "SEAGULL".radius.

com/comref/full. Example: cameraEffect ["External".html 7/11/2010 . Type of returned value: Number Description: Return camera interest for given entity. "FRONT" or "BACK" ("BACK" is normally used).arma2.BIS Game Engine Scripting Commands Page 42 of 415 Destroys the camera. Type of returned value: Nothing Description: Enable / disable showing of in-game UI during currently active camera effect. position]. Name is one of: "Internal". "Back"] Category: OFP cameraEffectEnableHUD enable Operand types: enable: Boolean Compatibility: Version 5501 required. "External".57 required. Category: OFP cameraInterest entity Operand types: entity: Object Compatibility: Version 2. Category: OFP http://www. Category: OFP camera cameraEffect effect Operand types: camera: Object effect: Array Type of returned value: Nothing Description: Switches the camera to the given vehicle / camera. "Fixed" or "FixedWithZoom". "LEFT". "RIGHT". The format of effect is [name. Position is one of: "TOP".

Time gives timeout. Category: OFP campaignConfigFile Compatibility: Version 2. zero means no (infinite) timeout. Type of returned value: Config Description: Return root of campaign description. Category: OFP cameraView Compatibility: Version 5501 required.com/comref/full.56 required. Type of returned value: String Description: Return type of camera.ext entries hierarchy.90 required.arma2. Type of returned value: Nothing Description: Preload the scene for he prepared camera.BIS Game Engine Scripting Commands Page 43 of 415 cameraOn Compatibility: Version 1.95 required.html 7/11/2010 . Example: _camera camCommit 5 http://www. Type of returned value: Object Description: Returns the vehicle to which the camera is attached. Category: OFP PC camera camPreload time Operand types: camera: Object time: Number Compatibility: Version 2.

Example: _camera camPrepareBank -0. Example: http://www.1 Category: OFP camera camPrepareDir direction Operand types: camera: Object direction: Number Compatibility: Version 2. Example: camPreloaded _camera Category: OFP camera camPrepareBank bank Operand types: camera: Object bank: Number Compatibility: Version 2.95 required.com/comref/full.95 required. See also camPreload and camCommitPrepared. Type of returned value: Nothing Description: Prepares the camera bank angle. Type of returned value: Boolean Description: Checks whether the camera has finished preloading.arma2. See also camPreload and camCommitPrepared.html 7/11/2010 .BIS Game Engine Scripting Commands Page 44 of 415 Category: OFP camPreloaded camera Operand types: camera: Object Compatibility: Version 2. Type of returned value: Nothing Description: Prepares the camera heading.92 required.

1 Category: OFP camera camPrepareFocus focusRange Operand types: camera: Object focusRange: Array Compatibility: Version 2. 1] Category: OFP camera camPrepareFov fieldOfView Operand types: camera: Object fieldOfView: Number Compatibility: Version 2. Type of returned value: Nothing Description: Prepares the camera dive angle. Type of returned value: Nothing Description: focusRange is in format [distance. See also camPreload and camCommitPrepared. See also camPreload and camCommitPrepared. Prepares the camera focus blur. Example: _camera camPrepareDive -0.com/comref/full.BIS Game Engine Scripting Commands Page 45 of 415 _camera camPrepareDir 150 Category: OFP camera camPrepareDive dive Operand types: camera: Object dive: Number Compatibility: Version 2.arma2.blur].95 required.95 required.95 required. Type of returned value: Nothing http://www. Example: _camera camPrepareFocus [50.html 7/11/2010 .

95 required.1 Category: OFP camera camPrepareFovRange fovRange Operand types: camera: Object fovRange: Array Compatibility: Version 2. See also camPreload and camCommitPrepared.95 required. See also camPreload and camCommitPrepared. Example: _camera camPrepareFovRange [0.1.5] Category: OFP camera camPreparePos position Operand types: camera: Object position: Array Compatibility: Version 2.BIS Game Engine Scripting Commands Page 46 of 415 Description: Prepares the camera field of view (zoom). Example: _camera camPrepareFov 0. 0.html 7/11/2010 . Type of returned value: Nothing Description: Prepares the camera position (format Position).arma2. Example: _camera camPreparePos getPos player Category: OFP camera camPrepareRelPos position Operand types: camera: Object position: Array http://www.com/comref/full. See also camPreload and camCommitPrepared. Type of returned value: Nothing Description: Prepares the camera field of view range for auto zooming.

95 required. See also camPreload and camCommitPrepared. See also camPreload and camCommitPrepared. Example: _camera camPrepareTarget getPos player Category: OFP camera camPrepareTarget target Operand types: camera: Object target: Object Compatibility: Version 2.BIS Game Engine Scripting Commands Page 47 of 415 Compatibility: Version 2.95 required. Type of returned value: Nothing Description: Prepares the camera position relative to the current position of the currect target (see camPrepareTarget).html 7/11/2010 .5] Category: OFP camera camPrepareTarget position Operand types: camera: Object position: Array Compatibility: Version 2. Example: _camera camPrepareTarget player Category: OFP camera camSetBank bank http://www.95 required. Type of returned value: Nothing Description: Prepares the camera target. Type of returned value: Nothing Description: Prepares the camera target to a position (format Position).arma2. See also camPreload and camCommitPrepared. Example: _camera camPrepareRelPos [10.com/comref/full.

Example: _camera camSetDir 150 Category: OFP camera camSetDive dive Operand types: camera: Object dive: Number Type of returned value: Nothing Description: Sets the camera dive angle.com/comref/full.arma2. It does not automatically commit changes.html 7/11/2010 .1 Category: OFP camera camSetDir direction Operand types: camera: Object direction: Number Type of returned value: Nothing Description: Sets the camera heading. It does not automatically commit changes. Example: _camera camSetDive -0.1 Category: OFP camera camSetFocus focusRange Operand types: camera: Object focusRange: Array http://www. Example: _camera camSetBank -0.BIS Game Engine Scripting Commands Page 48 of 415 Operand types: camera: Object bank: Number Type of returned value: Nothing Description: Sets the camera bank angle. It does not automatically commit changes.

It does not automatically commit changes. It does not automatically commit changes.1. Example: _camera camSetFocus [50. 1] Category: OFP camera camSetFov fieldOfView Operand types: camera: Object fieldOfView: Number Type of returned value: Nothing Description: Sets the camera field of view (zoom).arma2. Example: _camera camSetFov 0. It does not automatically commit changes. 0. Sets the camera focus blur.BIS Game Engine Scripting Commands Page 49 of 415 Type of returned value: Nothing Description: focusRange is in format [distance.5] Category: OFP camera camSetPos position Operand types: camera: Object position: Array Type of returned value: Nothing http://www.1 Category: OFP camera camSetFovRange fovRange Operand types: camera: Object fovRange: Array Type of returned value: Nothing Description: Sets the camera field of view range for auto zooming.com/comref/full. Example: _camera camSetFovRange [0.html 7/11/2010 .blur].

It does not automatically commit changes. It does not automatically commit changes. http://www.5] Category: OFP camera camSetTarget target Operand types: camera: Object target: Object Type of returned value: Nothing Description: Sets the camera target. Example: _camera camSetPos getPos player Category: OFP camera camSetRelPos position Operand types: camera: Object position: Array Type of returned value: Nothing Description: Sets the camera position relative to the current position of the currect target (see camSetTarget). It does not automatically commit changes.arma2.html 7/11/2010 . Example: _camera camSetRelPos [10.BIS Game Engine Scripting Commands Page 50 of 415 Description: Sets the camera position (format Position).com/comref/full. Example: _camera camSetTarget player Category: OFP camera camSetTarget position Operand types: camera: Object position: Array Type of returned value: Nothing Description: Sets the camera target to a position (format Position). It does not automatically commit changes.

73 required. It does not check for ammo.com/comref/full. Category: OFP canFire vehicle Operand types: vehicle: Object Type of returned value: Boolean Description: Checks whether the given vehicle is able to fire. Type of returned value: Nothing Description: Set / clear using of night vision during cutscenes. Example: camTarget _camera Category: OFP camUseNVG set Operand types: set: Boolean Compatibility: Version 2. only for damage. Example: canFire vehicle player Category: OFP http://www.html 7/11/2010 .BIS Game Engine Scripting Commands Page 51 of 415 Example: _camera camSetTarget getPos player Category: OFP camTarget camera Operand types: camera: Object Compatibility: Version 5501 required.arma2. Type of returned value: Object Description: Returns camera's target.

BIS Game Engine Scripting Commands Page 52 of 415 canMove vehicle Operand types: vehicle: Object Type of returned value: Boolean Description: Checks whether the given vehicle is able to move. Category: OFP captive unit Operand types: unit: Object http://www.arma2.com/comref/full. Type of returned value: Boolean Description: Check if cargo of this vehicle want to get out when in combat. It does not test for fuel. Example: canStand player Category: OFP canUnloadInCombat vehicle Operand types: vehicle: Object Compatibility: Version 5501 required. only the damage status is checked. Example: canMove vehicle player Category: OFP canStand soldier Operand types: soldier: Object Type of returned value: Boolean Description: Checks whether the given soldier is able to stand up.html 7/11/2010 .

com/comref/full. If the unit is a vehicle. its commander is checked instead. Example: captive player Category: OFP case b Operand types: b: Any Type of returned value: Switch Type Description: see switch Category: Default try-Block catch code Operand types: try-Block: Exception Type code: Code Type of returned value: Any Description: processes code. Example: captive player Category: OFP captiveNum unit Operand types: unit: Object Type of returned value: Number Description: Checks whether the unit is a captive. If the unit is a vehicle.BIS Game Engine Scripting Commands Page 53 of 415 Type of returned value: Boolean Description: Checks whether the unit is a captive. when exception is thrown in try block Category: Default http://www.html 7/11/2010 .arma2. its commander is checked instead.

Category: OFP clearGroupIcons group Operand types: group: Group Compatibility: Version 5501 required. result is 6 Category: Default cheatsEnabled Compatibility: Version 1. Example: clearGroupIcons group http://www. Type of returned value: Nothing Description: Removes all icon from group.BIS Game Engine Scripting Commands Page 54 of 415 ceil x Operand types: x: Number Type of returned value: Number Description: The ceil value of x. Type of returned value: Boolean Description: Checks whether cheats are enabled (whether the designers' version is running).html 7/11/2010 .com/comref/full. Category: Resistance civilian Type of returned value: Side Description: The Civilian side. Example: ceil 5.25 .56 required.arma2.

Example: clearOverlay _map Category: Editor clearRadio http://www. Example: clearMagazineCargo jeepOne Category: OFP clearMagazinePool Compatibility: Version 1.75 required.arma2. Type of returned value: Nothing Description: Clear the current overlay. Category: Resistance clearOverlay map Operand types: map: Control Compatibility: Version 2.com/comref/full. Type of returned value: Nothing Description: Removes all magazines from the weapon pool (this is used in campaigns to transfer weapons to the next mission).BIS Game Engine Scripting Commands Page 55 of 415 Category: OFP clearMagazineCargo unit Operand types: unit: Object Type of returned value: Nothing Description: Removes all magazines from the vehicle cargo space.92 required.html 7/11/2010 .

73 required.arma2. http://www.html 7/11/2010 . Example: clearWeaponCargo jeepOne Category: OFP clearWeaponPool Compatibility: Version 1. Category: OFP clearVehicleInit vehicle Operand types: vehicle: Object Compatibility: Version 5154 required.com/comref/full. Type of returned value: Nothing Description: Clean up the content of radio protocol history.75 required.BIS Game Engine Scripting Commands Page 56 of 415 Compatibility: Version 2. Type of returned value: Nothing Description: Clear vehicle init field. Type of returned value: Nothing Description: Removes all weapons from the weapon pool (this is used in campaigns to transfer weapons to the next mission). Example: clearVehicleInit soldier3 Category: OFP clearWeaponCargo unit Operand types: unit: Object Type of returned value: Nothing Description: Removes all weapons from the vehicle cargo space.

50 required. Example: closeDialog 1 Category: Resistance display closeDisplay exitcode Operand types: display: Display exitcode: Number Compatibility: Version 2.html 7/11/2010 . Type of returned value: Nothing Description: Closes the current overlay without committing.com/comref/full. Type of returned value: Nothing Description: Closes the topmost user dialog as if a button with id idc was pressed.53 required. Example: _display closeDisplay IDC_OK Category: OFP PC closeOverlay map Operand types: map: Control Compatibility: Version 2. Type of returned value: Nothing Description: Close given display.92 required.arma2.BIS Game Engine Scripting Commands Page 57 of 415 Category: Resistance closeDialog idc Operand types: idc: Number Compatibility: Version 1. Category: Editor http://www.

"GREEN". Type of returned value: Nothing Description: Collapse the object tree. it does not broadcast the message. Note: this function only types text to the list.92 required. Example: soldierOne commandChat "Show this text" Category: OFP http://www. you have to execute it on all of them."YELLOW" or "RED"). Example: collapseObjectTree _map Category: Editor combatMode grp Operand types: grp: Object or Group Type of returned value: String Description: Returns the combat mode of the given unit ("BLUE".BIS Game Engine Scripting Commands Page 58 of 415 collapseObjectTree map Operand types: map: Control Compatibility: Version 2. Type of returned value: Nothing Description: Types text to the command radio channel. If you want the message to show on all computers.com/comref/full.arma2.html 7/11/2010 . Example: combatMode group player Category: OFP unit commandChat chatText Operand types: unit: Object or Array chatText: String Compatibility: Version 5501 required.

com/comref/full.arma2.html 7/11/2010 . If the target is objNull. Example: commander vehicle player Category: OFP unit commandFire target Operand types: unit: Object or Array target: Object Type of returned value: Nothing Description: Orders a unit to commence firing on the given target (via the radio). but a person. the person is returned instead. Example: soldierOne commandFollow player Category: OFP http://www. the unit is ordered to commence firing on its current target (set using doTarget or commandTarget). If the vehicle is not a vehicle. Example: soldierOne commandFire player Category: OFP unit commandFollow formationLeader Operand types: unit: Object or Array formationLeader: Object Type of returned value: Nothing Description: Orders a unit to follow the given unit (via the radio).BIS Game Engine Scripting Commands Page 59 of 415 commander vehicle Operand types: vehicle: Object Type of returned value: Object Description: Returns the commander of the vehicle.

target] Operand types: unit(s): Object or Array [fsm name.fsm". position.arma2.28 required. Type of returned value: Nothing Description: Orders the unit to get out from the vehicle (via the radio). Example: commandGetOut unitOne Category: OFP commandingMenu Compatibility: Version 5501 required.com/comref/full. Type of returned value: Nothing Description: Orders a unit to process command defined by FSM file (via the radio). Example: soldierOne commandFSM ["move. Type of returned value: String Description: Return the name of the topmost commanding menu.html 7/11/2010 . Category: OFP unit commandMove position Operand types: unit: Object or Array http://www.BIS Game Engine Scripting Commands Page 60 of 415 unit(s) commandFSM [fsm name. position.53 required. player] Category: OFP PC commandGetOut unit Operand types: unit: Object or Array Compatibility: Version 2. target]: Array Compatibility: Version 2. position player.

Type of returned value: Nothing Description: Sends the message to the command radio channel. Example: commandStop unitOne Category: OFP unit commandTarget position Operand types: unit: Object or Array http://www.html 7/11/2010 . Example: soldierOne commandMove getMarkerPos "MarkerMoveOne" Category: OFP unit commandRadio radioName Operand types: unit: Object or Array radioName: String Compatibility: Version 5501 required. the unit will never be ready.arma2. Note: the stop command is never finished.BIS Game Engine Scripting Commands Page 61 of 415 position: Array Type of returned value: Nothing Description: Orders the unit to move to the given position (format Position) (via the radio).ext file or radio protocol.com/comref/full. Example: soldierOne commandRadio "messageOne" Category: OFP commandStop unit Operand types: unit: Object or Array Type of returned value: Nothing Description: Orders the unit to stop (via the radio). The message is defined in the description.

arma2.html 7/11/2010 . Example: soldierOne commandWatch player Category: OFP comment comment Operand types: comment: String Compatibility: Version 1.BIS Game Engine Scripting Commands Page 62 of 415 position: Object Type of returned value: Nothing Description: Orders the unit to target the given target (via the radio).com/comref/full. Example: soldierOne commandWatch getMarkerPos "MarkerMoveOne" Category: OFP unit commandWatch target Operand types: unit: Object or Array target: Object Type of returned value: Nothing Description: Orders the unit to watch the given target (via the radio). Example: soldierOne commandTarget player Category: OFP unit commandWatch position Operand types: unit: Object or Array position: Array Type of returned value: Nothing Description: Orders the unit to watch the given position (format Position) (via the radio).85 required. Type of returned value: http://www.

Type of returned value: http://www. It's used to create comments.92 required." Category: Default commitOverlay map Operand types: map: Control Compatibility: Version 2. Type of returned value: Code Description: Compile expression. _compiled = compile _function. call _compiled. Category: Default completedFSM FSM handle Operand types: FSM handle: Number Compatibility: Version 5500 required. Example: _function = "a = a + 1".60 required.BIS Game Engine Scripting Commands Page 63 of 415 Nothing Description: This function does nothing. Example: comment "This is a comment.html 7/11/2010 . Example: commitOverlay _map Category: Editor compile expression Operand types: expression: String Compatibility: Version 2.com/comref/full.arma2. Type of returned value: Nothing Description: Commit the current overlay.

html 7/11/2010 .]: Array Compatibility: Version 2. Type of returned value: Config Description: Return root of config entries hierarchy. text2. lineBreak.. . image "data\isniper.paa". .BIS Game Engine Scripting Commands Page 64 of 415 Boolean Description: Check whether the given FSM completes... The FSM handle is the number returned by the execFSM command.arma2.com/comref/full.] Operand types: [text1. Category: OFP composeText [text1. Example: txt = composeText ["First line".35 required. Category: OFP PC configName config Operand types: config: Config Compatibility: Version 2. result is "CfgVehicles" http://www.. text2.35 required. "Second line"] Category: OFP configFile Compatibility: Version 2.01 required. Example: _name = configName (configFile >> "CfgVehicles") . Type of returned value: String Description: Returns name of config entry. Type of returned value: Structured text Description: Creates a structured text by joining the given structured or plain texts.

Category: OFP groupTo copyWaypoints groupFrom Operand types: groupTo: Group groupFrom: Group Compatibility: Version 5500 required. including itself. Type of returned value: Nothing http://www. Type of returned value: Control Description: A non-existing control.92 required. Category: OFP PC copyFromClipboard Compatibility: Version 5500 required. This value is not equal to anything.com/comref/full. Type of returned value: Nothing Description: Copy the text to the clipboard. Category: OFP copyToClipboard text Operand types: text: String Compatibility: Version 5500 required. Type of returned value: String Description: Return the content of the (text) clipboard.BIS Game Engine Scripting Commands Page 65 of 415 Category: OFP PC controlNull Compatibility: Version 2.arma2.html 7/11/2010 .

2] .html 7/11/2010 .BIS Game Engine Scripting Commands Page 66 of 415 Description: Copy the chain of waypoints from source to target group. result is 4 http://www.arma2.0. Example: count [0.com/comref/full. Type of returned value: Number Description: Returns count of subentries.5 Category: Default count config Operand types: config: Config Compatibility: Version 2. The target group will start to process waypoints from the first one. Example: _count = count (configFile >> "CfgVehicles") Category: OFP PC count array Operand types: array: Array Type of returned value: Number Description: The number of elements in the array. Category: OFP cos x Operand types: x: Number Type of returned value: Number Description: The cosine of x. result is 0.1. Example: cos 60 . the argument is in degrees.35 required.

1. Example: player countFriendly list triggerOne Category: OFP http://www.BIS Game Engine Scripting Commands Page 67 of 415 Category: Default condition count array Operand types: condition: Code array: Array Type of returned value: Number Description: Counts the elements in the array for which the given condition is true. 3] . result is 2 Category: Default unit countEnemy array Operand types: unit: Object array: Array Type of returned value: Number Description: Counts how many units in the array are considered enemy by the given unit. It is calculated as follows: 1) Set the count to 0. 2.html 7/11/2010 . 1. Example: player countEnemy list triggerOne Category: OFP unit countFriendly array Operand types: unit: Object array: Array Type of returned value: Number Description: Counts how many units in the array are considered friendly by the given unit. If it's true. 2) For each element in the array assign an element as _x and evaluate the condition expression. 3. Example: "_x > 2" count [0.arma2.com/comref/full. increase the count.

html 7/11/2010 .arma2. markers. placement. position. special] http://www.com/comref/full.BIS Game Engine Scripting Commands Page 68 of 415 side countSide array Operand types: side: Side array: Array Type of returned value: Number Description: Checks how many vehicles belong to the given side. Example: "Tank" countType list triggerOne Category: OFP unit countUnknown array Operand types: unit: Object array: Array Type of returned value: Number Description: Counts how many units in the array are considered unknown to the given unit. Example: player countUnknown list triggerOne Category: OFP createAgent [type. Example: west countSide list triggerOne Category: OFP typeName countType array Operand types: typeName: String array: Array Type of returned value: Number Description: Counts how many vehicles in the array are of the given type. For types see CfgVehicles.

position. 0. Otherwise. Special properties can be: "NONE" and "FORM".86 required. Type of returned value: Object Description: Creates an (independent) agent (person) of the given type (type is a name of a subclass of CfgVehicles).89 required. If a user dialog already exists. []. Example: _ok = createDialog "RscDisplayGame" Category: Resistance http://www. The function returns its success.html 7/11/2010 .com/comref/full.cpp file. placement.ext file of the campaign and the globlal resource.arma2. Example: center = createCenter East Category: OFP createDialog name Operand types: name: String Compatibility: Version 1. it creates a child dialog of the topmost user dialog. If the markers array contains several marker names. Example: agent = createAgent ["SoldierWB". "FORM"] Category: OFP createCenter side Operand types: side: Side Compatibility: Version 1.BIS Game Engine Scripting Commands Page 69 of 415 Operand types: [type. The unit is placed inside a circle with this position as its center and placement as its radius. the description. The class name is searched in the description. the given position is used. special]: Array Compatibility: Version 2. markers. position player.50 required. the position of a random one is used. Type of returned value: Boolean Description: Creates a user dialog from the resource template name. Type of returned value: Side Description: Creates a new AI center for the given side.ext file of the mission.

Example: _link = createDiarySubject ["Group".92 required. Type of returned value: Diary record Description: Create a new record in a log. state))] or [subject.com/comref/full."] Category: Identity person createDiarySubject [subject. text(. task or unit). object. state))] or [subject. display name] or [subject. task(. state))]: Array Compatibility: Version 2. task(. text](. player. [title.arma2. text(. text]: Array Compatibility: Version 5500 required. Example: http://www. picture] Operand types: person: Object [subject.53 required. task(.html 7/11/2010 . "Kill all enemies. Type of returned value: Number Description: Create a new subject page in a log. object. "Player"] Category: Identity person createDiaryRecord [subject. display name. picture]: Array Compatibility: Version 2. text](. display name. task(. Type of returned value: String Description: Create a link to the section of diary given by subject. Example: _record = player createDiaryRecord ["diary". Record is selected based on given object (diary record. [title. state))] Operand types: person: Object [subject. display name] or [subject.BIS Game Engine Scripting Commands Page 70 of 415 createDiaryLink [subject. text] Operand types: [subject.

Example: CreateGearDialog [palyer.com/comref/full. Type of returned value: Group Description: Creates a new AI group for the given center (side).resource] Operand types: [unit. Type of returned value: Nothing Description: Create child display of given display and load from resource "name"."RscDisplayGear"] Category: OFP createGroup side Operand types: side: Side Compatibility: Version 1.html 7/11/2010 . "My page"] Category: Identity parent createDisplay name Operand types: parent: Display name: String Compatibility: Version 2. Example: _display createDisplay "RscObserver" Category: OFP PC CreateGearDialog [unit. http://www.BIS Game Engine Scripting Commands Page 71 of 415 _index = player createDiarySubject ["myPage".53 required.resource]: Array Compatibility: Version 5501 required.86 required. Type of returned value: Nothing Description: Opens gear dialog for given unit.arma2.

0]. position]: Array Compatibility: Version 1. position.com/comref/full. Type of returned value: Location Description: Create location of given type with given size at given position.86 required.86 required. idStatic. position. The marker name has to be unique. The marker is created on all computers in a network session. otherwise the given position is guarded. position.html 7/11/2010 .90 required. sizeZ] Operand types: [type. position. vehicle]: Array Compatibility: Version 1. position] Operand types: [name. If the given vehicle is valid. http://www. Example: point = createGuardedPoint [East. Category: Location createMarker [name. sizeX. Type of returned value: Nothing Description: Adds a point guarded by the given side.arma2. vehicle player] Category: OFP createLocation [type. the position of a static object with the given id is guarded. [0. idStatic. Type of returned value: String Description: Creates a new marker on the given position. sizeZ]: Array Compatibility: Version 2. -1. vehicle] Operand types: [side. sizeX. If idStatic is not negative.BIS Game Engine Scripting Commands Page 72 of 415 Example: group = createGroup East Category: OFP createGuardedPoint [side. the starting position of the vehicle is guarded.

BIS Game Engine Scripting Commands Page 73 of 415 Example: marker = createMarker [Marker1. The marker is only created on the computer where the command is called. Type of returned value: Nothing Description: Creates a previously added menu. Example: marker = createMarkerLocal [Marker1. position] Operand types: [name.92 required. markers. The marker name has to be unique.92 required. placement]: Array Compatibility: Version 2. the position of a random one is used. markers. position player] Category: OFP map createMenu index Operand types: map: Control index: Number Compatibility: Version 2. If the markers array contains several marker names. The mine is placed inside a circle with this position as its center and placement as its http://www. position. position.32 required.arma2.html 7/11/2010 . position]: Array Compatibility: Version 2. placement] Operand types: [type. position player] Category: OFP createMarkerLocal [name.com/comref/full. Type of returned value: String Description: Creates a new marker on the given position. Category: Editor createMine [type. Otherwise. Type of returned value: Object Description: Creates a mine of the given type (type is the name of the subclass of CfgVehicles). the given position is used.

BIS Game Engine Scripting Commands Page 74 of 415 radius. parentTask]: Array Compatibility: Version 5500 required. Example: mine = createMine ["MineMine".html 7/11/2010 . The mission dialog will be set to the directory given as an argument "root". Example: _display createMissionDisplay "Tutorial" Category: OFP PC person createSimpleTask [name] or [name. Type of returned value: Object Description: http://www. parentTask] Operand types: person: Object [name] or [name. markers. position. position player. markers. Type of returned value: Task Description: Create a new simple task (subtask of parentTask). 0] Category: OFP parent createMissionDisplay root Operand types: parent: Display root: String Compatibility: Version 5140 required. placement] Operand types: [type. []. Category: Identity createSoundSource [type.32 required. placement]: Array Compatibility: Version 2. position.arma2. Type of returned value: Display Description: Create single missions display as a child of given display.com/comref/full.

html 7/11/2010 . priority.. position] Operand types: [type. name1. If the markers array contains several marker names. Category: Identity createTrigger [type. position]: Array Compatibility: Version 1.] Operand types: teamMember: [[type] or [type. position player] Category: OFP group createUnit [type.. . placement. Type of returned value: Task Description: Create a new AI task (subtask of parentTask). this type must be a class name in CfgNonAIVehicles or CfgVehicles with simulation=detector. An object of the given type is created. position player.BIS Game Engine Scripting Commands Page 75 of 415 Creates a sound source of the given type (type is the name of the subclass of CfgVehicles). []. special]: Array Compatibility: http://www. parentTask]. position. priority. value2. markers. markers. Otherwise. Type of returned value: Object Description: Creates a new trigger on the given position. Example: soundSource = createSoundSource ["LittleDog".arma2. parentTask]. the given position is used. value1. value1.com/comref/full. name2. the position of a random one is used. Type is name of registered task type.62 required. . special] Operand types: group: Group [type. 0] Category: OFP teamMember createTask [[type] or [type. name2... name1.86 required. value2. position. The sound source is placed inside a circle with this position as its center and placement as its radius.]: Array Compatibility: Version 2. placement. Example: trigger = createTrigger["EmptyDetector".

If the markers array contains several marker names. 0. Type of returned value: Object Description: Creates a vehicle of the given type (type is the name of the subclass in CfgVehicles). the position of a random one is used. Type of returned value: Object Description: Creates a unit (person) of the given type (type is a name of a subclass of CfgVehicles) and makes it a member of the given group. group (Group). Otherwise.32 required. markers. position.arma2. Example: veh = createVehicle ["Cobra". init (String). Special properties can be: "NONE" and "FORM". Example: unit = group player createUnit ["SoldierWB". position player. special]: Array Compatibility: Version 2. 0. markers. If the markers array contains several marker names.BIS Game Engine Scripting Commands Page 76 of 415 Version 2. Special properties can be: "NONE". placement.5. "FLY"] Category: OFP http://www. the position of a random one is used. rank (String)]. []. groupAlpha] Category: OFP createVehicle [type. the given position is used. position player. placement. 0. position. the given position is used. skill and rank are optional. The unit is placed inside a circle with this position as its center and placement as its radius.html 7/11/2010 . Example: "SoldierWB" createUnit [getMarkerPos "barracks".com/comref/full.32 required. Note: init. Their default values are "". skill (Number). The vehicle is placed inside a circle with this position as center and placement as its radius. Otherwise. Type of returned value: Nothing Description: Creates a unit of the given type. special] Operand types: [type. []. "FLY" and "FORM". The format of unitInfo is: [pos (Position). "PRIVATE".34 required. "FORM"] Category: OFP type createUnit unitInfo Operand types: type: String unitInfo: Array Compatibility: Version 1.

Example: _tank = "M1Abrams" createVehicleLocal getmarkerpos "tankFactory" Category: OFP crew vehicle Operand types: vehicle: Object Type of returned value: Array Description: Returns all units mounted in the given vehicle.34 required. If the vehicle is not a vehicle. Type of returned value: Object Description: Creates an empty vehicle of the given type.html 7/11/2010 . but person. Pos is in format Position.com/comref/full.56 required. Pos is in format Position. See CfgVehicles for possible type values. See CfgVehicles for possible type values.arma2.BIS Game Engine Scripting Commands Page 77 of 415 type createVehicle pos Operand types: type: String pos: Array Compatibility: Version 1. Example: _tank = "M1Abrams" createVehicle getmarkerpos "tankFactory" Category: OFP type createVehicleLocal pos Operand types: type: String pos: Array Compatibility: Version 2. Type of returned value: Object Description: Creates an empty vehicle of the given type. Vehicle is not transferred through network in MP games. a list containing only persons is returned. Example: crew vehicle player http://www.

Type of returned value: Number Description: Add an event handler to the given control.com/comref/full. Returns id of the handler or -1 when failed. Type of returned value: Number Description: Returns number of seconds until auto-scroll starts. ""] Category: OFP PC ctrlAutoScrollDelay control Operand types: control: Control Compatibility: Version 5501 required. function]: Array Compatibility: Version 5501 required.html 7/11/2010 . Type of returned value: Nothing Description: Launch actions attached to given (button based) control. Example: ctrlActivate _control Category: OFP PC control ctrlAddEventHandler [handler name. Example: _id = _control ctrlAddEventHandler ["KeyDown".92 required.arma2. -2 if scrollbar not present. Example: _delay = ctrlAutoScrollDelay _control http://www. function] Operand types: control: Control [handler name.BIS Game Engine Scripting Commands Page 78 of 415 Category: OFP ctrlActivate control Operand types: control: Control Compatibility: Version 2.

arma2. Example: _speed = ctrlAutoScrollSpeed _control Category: OFP PC control ctrlCommit time Operand types: control: Control time: Number Compatibility: Version 2.BIS Game Engine Scripting Commands Page 79 of 415 Category: OFP PC ctrlAutoScrollRewind control Operand types: control: Control Compatibility: Version 5501 required. Type of returned value: Boolean Description: True if auto-scroll should move back to start after it reach end. Type of returned value: Nothing Description: Commit control animation. http://www.com/comref/full. -2 if scrollbar not present. Example: _rewind = ctrlAutoScrollRewind _control Category: OFP PC ctrlAutoScrollSpeed control Operand types: control: Control Compatibility: Version 5501 required. -1 if auto-scroll is disabled.html 7/11/2010 .50 required. Type of returned value: Number Description: Returns number of seconds to auto-scroll one line.

Type of returned value: Boolean Description: Check if the control animation is finished. Type of returned value: Nothing Description: Enable / disable given control. enable] Operand types: [idc. Example: ctrlEnable [100.BIS Game Engine Scripting Commands Page 80 of 415 Example: _control ctrlCommit 2 Category: OFP PC ctrlCommitted control Operand types: control: Control Compatibility: Version 2.50 required. Type of returned value: Nothing Description: Enables / disables the control with id idc of the topmost user dialog.arma2. http://www.html 7/11/2010 . Example: _done = ctrlCommitted _control Category: OFP PC ctrlEnable [idc.com/comref/full. false] Category: Resistance control ctrlEnable enable Operand types: control: Control enable: Boolean Compatibility: Version 2. enable]: Array Compatibility: Version 1.50 required.50 required.

html 7/11/2010 . Type of returned value: Number Description: Returns the current fade factor of control.com/comref/full. Example: _ok = ctrlEnabled _control Category: OFP PC ctrlEnabled idc Operand types: idc: Number Compatibility: Version 1.arma2. Example: _enabled = ctrlEnabled 100 Category: Resistance ctrlFade control Operand types: control: Control Compatibility: Version 2.50 required.50 required.50 required.BIS Game Engine Scripting Commands Page 81 of 415 Example: _control ctrlEnable false Category: OFP PC ctrlEnabled control Operand types: control: Control Compatibility: Version 2. Type of returned value: Boolean Description: Returns whether the control with id idc of the topmost user dialog is enabled. http://www. Type of returned value: Boolean Description: Returns whether given control is enabled.

the format of position is Position2D.92 required. Type of returned value: Nothing Description: Clears the map animation. Example: _map ctrlMapAnimAdd [1.com/comref/full. Type of returned value: Nothing Description: Plays the map animation. zoom.92 required.html 7/11/2010 . http://www. Type of returned value: Nothing Description: Adds the next frame to the map animation.1. position].92 required.BIS Game Engine Scripting Commands Page 82 of 415 Example: _scale = ctrlFade _control Category: OFP PC map ctrlMapAnimAdd frame Operand types: map: Control frame: Array Compatibility: Version 1. The format of frame is [time. getMarkerPos "anim1"] Category: OFP PC ctrlMapAnimClear control Operand types: control: Control Compatibility: Version 2. Category: OFP PC ctrlMapAnimCommit control Operand types: control: Control Compatibility: Version 2. 0.arma2.

Type of returned value: Nothing Description: Changes default cursor texture ("Track". Category: OFP PC control ctrlMapCursor texture names Operand types: control: Control texture names: Array Compatibility: Version 5501 required. To restore default texture."Array"."customCursor"] Category: OFP ctrlMapMouseOver control Operand types: control: Control Compatibility: Version 5501 required.arma2. If new texture does not exist. Category: OFP http://www. write empty string. Type of returned value: Boolean Description: Checks whether the map animation has finished. default cursor texture is used.BIS Game Engine Scripting Commands Page 83 of 415 Category: OFP PC ctrlMapAnimDone control Operand types: control: Control Compatibility: Version 2. "Move".html 7/11/2010 .com/comref/full. Type of returned value: Array Description: Returns description of map sign mouse cursor is over. "Scroll") to custom one. Example: <map_control> ctrlMapCursor ["Track".92 required.

92 required. y] Operand types: map: Control [x. Type of returned value: Number Description: Return the current scale of the map control. Category: OFP PC map ctrlMapScreenToWorld [x. Category: OFP PC ctrlParent control Operand types: control: Control Compatibility: Version 2.com/comref/full. y]: Array Compatibility: Version 5127 required.50 required.html 7/11/2010 . Type of returned value: Array Description: Convert position in the map from screen coordinates to world coordinates. Type of returned value: Array Description: Convert position in the map from world coordinates to screen coordinates.arma2. Type of returned value: http://www. Category: OFP PC map ctrlMapWorldToScreen position Operand types: map: Control position: Array Compatibility: Version 5127 required.BIS Game Engine Scripting Commands Page 84 of 415 ctrlMapScale control Operand types: control: Control Compatibility: Version 2.

id] Operand types: control: Control [handler name. w.com/comref/full. h] array. id]: Array Compatibility: http://www.html 7/11/2010 . Example: _display = ctrlParent _control Category: OFP PC ctrlPosition control Operand types: control: Control Compatibility: Version 2.50 required.BIS Game Engine Scripting Commands Page 85 of 415 Display Description: Returns container of given control.arma2. Example: _control ctrlRemoveAllEventHandlers "KeyDown" Category: OFP PC control ctrlRemoveEventHandler [handler name. Example: _pos = ctrlPosition _control Category: OFP PC control ctrlRemoveAllEventHandlers handler name Operand types: control: Control handler name: String Compatibility: Version 5501 required. Type of returned value: Nothing Description: Remove all even handlers from the given control. y. Type of returned value: Array Description: Returns the current position and size of control as [x.

0. Type of returned value: Nothing Description: Sets text color of given control when control is selected.50 required.html 7/11/2010 . Example: _control ctrlSetActiveColor [1. Example: _scale = ctrlScale _control Category: OFP PC display ctrlSetActiveColor color Operand types: display: Control color: Array Compatibility: Version 2. 1] Category: OFP PC control ctrlSetAutoScrollDelay delay Operand types: control: Control http://www.com/comref/full.arma2. Type of returned value: Nothing Description: Remove a given event handler from the given control. 0] Category: OFP PC ctrlScale control Operand types: control: Control Compatibility: Version 5501 required. Color is in format Color. Type of returned value: Number Description: Returns the current scale of control.BIS Game Engine Scripting Commands Page 86 of 415 Version 5501 required. Example: _control ctrlRemoveEventHandler ["KeyDown". 0.

Type of returned value: Nothing Description: Sets number of second required to scroll to next line. Type of returned value: Nothing Description: Sets number of second before auto-scroll starts.BIS Game Engine Scripting Commands Page 87 of 415 delay: Number Compatibility: Version 5501 required. auto-scroll is disabled. If speed smaller than 0. Example: _control ctrlSetAutoScrollDelay 5 Category: OFP PC control ctrlSetAutoScrollRewind delay Operand types: control: Control delay: Boolean Compatibility: Version 5501 required. Example: _control ctrlSetAutoScrollSpeed 5 Category: OFP PC display ctrlSetBackgroundColor color http://www.html 7/11/2010 .arma2. Type of returned value: Nothing Description: Defines if scroll should rewind when auto-scroll reach end. Example: _control ctrlSetAutoScrollDelay 5 Category: OFP PC control ctrlSetAutoScrollSpeed speed Operand types: control: Control speed: Number Compatibility: Version 5501 required.com/comref/full.

54 required. Color is in format Color. 0. Type of returned value: Nothing Description: Sets wanted transparency for control animation. 0. 1] Category: OFP PC control ctrlSetEventHandler [handler name. ""] Category: OFP PC control ctrlSetFade fade Operand types: control: Control fade: Number Compatibility: Version 2. function]: Array Compatibility: Version 2.com/comref/full.BIS Game Engine Scripting Commands Page 88 of 415 Operand types: display: Control color: Array Compatibility: Version 2.arma2. Example: _control ctrlSetFade 1 Category: OFP PC http://www. Example: _control ctrlSetBackgroundColor [1.html 7/11/2010 . function] Operand types: control: Control [handler name.50 required. Type of returned value: Nothing Description: Sets given event handler of given control Example: _control ctrlSetEventHandler ["KeyDown". Type of returned value: Nothing Description: Sets background color of given control.50 required.

BIS Game Engine Scripting Commands Page 89 of 415 ctrlSetFocus control Operand types: control: Control Compatibility: Version 2.com/comref/full.arma2.html 7/11/2010 . Example: _control ctrlSetFontH1 "TahomaB" Category: OFP PC http://www. Example: _control ctrlSetFont "TahomaB" Category: OFP PC control ctrlSetFontH1 name Operand types: control: Control name: String Compatibility: Version 2. Type of returned value: Nothing Description: Set the input focus on given control. Type of returned value: Nothing Description: Sets the main font of given control.50 required.92 required. Type of returned value: Nothing Description: Sets H1 font of given HTML control. Example: ctrlSetFocus _control Category: OFP PC control ctrlSetFont name Operand types: control: Control name: String Compatibility: Version 2.50 required.

Example: _control ctrlSetFontH2 "TahomaB" Category: OFP PC control ctrlSetFontH2B name Operand types: control: Control name: String Compatibility: Version 2.BIS Game Engine Scripting Commands Page 90 of 415 control ctrlSetFontH1B name Operand types: control: Control name: String Compatibility: Version 2.50 required.com/comref/full. Type of returned value: Nothing Description: Sets H2 font of given HTML control.arma2. Type of returned value: Nothing Description: Sets H1 bold font of given HTML control.50 required. Type of returned value: Nothing Description: Sets H2 bold font of given HTML control.50 required. Example: _control ctrlSetFontH1B "TahomaB" Category: OFP PC control ctrlSetFontH2 name Operand types: control: Control name: String Compatibility: Version 2. Example: _control ctrlSetFontH2B "TahomaB" Category: OFP PC http://www.html 7/11/2010 .

50 required.50 required. Example: _control ctrlSetFontH4 "TahomaB" http://www.arma2.BIS Game Engine Scripting Commands Page 91 of 415 control ctrlSetFontH3 name Operand types: control: Control name: String Compatibility: Version 2. Example: _control ctrlSetFontH3 "TahomaB" Category: OFP PC control ctrlSetFontH3B name Operand types: control: Control name: String Compatibility: Version 2. Type of returned value: Nothing Description: Sets H3 font of given HTML control.50 required. Type of returned value: Nothing Description: Sets H4 font of given HTML control.com/comref/full. Type of returned value: Nothing Description: Sets H3 bold font of given HTML control. Example: _control ctrlSetFontH3B "TahomaB" Category: OFP PC control ctrlSetFontH4 name Operand types: control: Control name: String Compatibility: Version 2.html 7/11/2010 .

Type of returned value: Nothing Description: Sets H4 bold font of given HTML control. Example: _control ctrlSetFontH5 "TahomaB" Category: OFP PC control ctrlSetFontH5B name Operand types: control: Control name: String Compatibility: Version 2. Type of returned value: Nothing Description: Sets H5 font of given HTML control.50 required.BIS Game Engine Scripting Commands Page 92 of 415 Category: OFP PC control ctrlSetFontH4B name Operand types: control: Control name: String Compatibility: Version 2. Type of returned value: Nothing Description: Sets H5 bold font of given HTML control. Example: _control ctrlSetFontH4B "TahomaB" Category: OFP PC control ctrlSetFontH5 name Operand types: control: Control name: String Compatibility: Version 2.50 required.arma2.50 required. http://www.com/comref/full.html 7/11/2010 .

Type of returned value: Nothing http://www. Example: _control ctrlSetFontH6 "TahomaB" Category: OFP PC control ctrlSetFontH6B name Operand types: control: Control name: String Compatibility: Version 2. Type of returned value: Nothing Description: Sets H6 bold font of given HTML control.com/comref/full.BIS Game Engine Scripting Commands Page 93 of 415 Example: _control ctrlSetFontH5B "TahomaB" Category: OFP PC control ctrlSetFontH6 name Operand types: control: Control name: String Compatibility: Version 2.50 required. Example: _control ctrlSetFontH6B "TahomaB" Category: OFP PC control ctrlSetFontHeight height Operand types: control: Control height: Number Compatibility: Version 2.50 required.50 required.arma2. Type of returned value: Nothing Description: Sets H5 font of given HTML control.html 7/11/2010 .

50 required.05 Category: OFP PC control ctrlSetFontHeightH1 height Operand types: control: Control height: Number Compatibility: Version 2. Example: _control ctrlSetFontHeight 0.50 required.05 Category: OFP PC control ctrlSetFontHeightH3 height Operand types: control: Control height: Number Compatibility: http://www.05 Category: OFP PC control ctrlSetFontHeightH2 height Operand types: control: Control height: Number Compatibility: Version 2.html 7/11/2010 . Type of returned value: Nothing Description: Sets H1 font size of given HTML control.BIS Game Engine Scripting Commands Page 94 of 415 Description: Sets the main font size of given control. Example: _control ctrlSetFontHeightH1 0. Example: _control ctrlSetFontHeightH2 0. Type of returned value: Nothing Description: Sets H2 font size of given HTML control.arma2.com/comref/full.

50 required. Type of returned value: Nothing Description: Sets H3 font size of given HTML control.50 required.com/comref/full.BIS Game Engine Scripting Commands Page 95 of 415 Version 2. Example: _control ctrlSetFontHeightH5 0.arma2. Example: _control ctrlSetFontHeightH4 0.05 Category: OFP PC control ctrlSetFontHeightH6 height Operand types: http://www. Type of returned value: Nothing Description: Sets H5 font size of given HTML control. Example: _control ctrlSetFontHeightH3 0.html 7/11/2010 .50 required.05 Category: OFP PC control ctrlSetFontHeightH4 height Operand types: control: Control height: Number Compatibility: Version 2. Type of returned value: Nothing Description: Sets H4 font size of given HTML control.05 Category: OFP PC control ctrlSetFontHeightH5 height Operand types: control: Control height: Number Compatibility: Version 2.

Type of returned value: Nothing Description: Sets H6 font size of given HTML control. Type of returned value: Nothing Description: Sets P font size of given HTML control.50 required.50 required. Example: _control ctrlSetFontHeightH6 0.BIS Game Engine Scripting Commands Page 96 of 415 control: Control height: Number Compatibility: Version 2.50 required. Type of returned value: Nothing Description: Sets P font of given HTML control. Example: _control ctrlSetFontP "TahomaB" Category: OFP PC control ctrlSetFontP height Operand types: control: Control height: Number Compatibility: Version 2.html 7/11/2010 . Example: _control ctrlSetFontHeightP 0.com/comref/full.05 Category: OFP PC control ctrlSetFontPB name http://www.arma2.05 Category: OFP PC control ctrlSetFontP name Operand types: control: Control name: String Compatibility: Version 2.

5] Category: OFP PC http://www.BIS Game Engine Scripting Commands Page 97 of 415 Operand types: control: Control name: String Compatibility: Version 2. y.arma2.50 required. Type of returned value: Nothing Description: Sets P bold font of given HTML control. w.html 7/11/2010 . Example: _control ctrlSetFontPB "TahomaB" Category: OFP PC display ctrlSetForegroundColor color Operand types: display: Control color: Array Compatibility: Version 2. Example: _control ctrlSetPosition [0. Type of returned value: Nothing Description: Sets wanted position and size for control animation. h] Operand types: control: Control [x.50 required. Color is in format Color. 1] Category: OFP PC control ctrlSetPosition [x. Example: _control ctrlSetForegroundColor [1. Width and height are optional. h]: Array Compatibility: Version 2. Type of returned value: Nothing Description: Sets background color of given control.5. 0.50 required. 0. y.com/comref/full. 0. w.

53 required.BIS Game Engine Scripting Commands Page 98 of 415 control ctrlSetScale scale Operand types: control: Control scale: Number Compatibility: Version 5501 required. text]: Array Compatibility: Version 1. edit lines and active texts. Type of returned value: Nothing Description: Set the structured text which will be displayed in structured text control. text] Operand types: [idc. This can be used for static texts.com/comref/full.html 7/11/2010 .arma2. Type of returned value: Nothing Description: Sets wanted scale for control animation.50 required. buttons.Second line" Category: OFP PC ctrlSetText [idc. "Hello.img image=data\isniper. Example: _control ctrlScale 0. Example: ctrlSetText [100.&ltbr/&gt. world"] Category: Resistance http://www. Example: _control ctrlSetStructuredText parseText "First line&lt.5 Category: OFP PC control ctrlSetStructuredText structured text Operand types: control: Control structured text: Structured text Compatibility: Version 2. Type of returned value: Nothing Description: Sets the text that will be shown in the control with id idc of the topmost user dialog. Top left corner remains same.paa/&gt.

50 required.arma2.com/comref/full. Type of returned value: Nothing Description: Sets the text that will be shown in given control." Category: OFP PC display ctrlSetTextColor color Operand types: display: Control color: Array Compatibility: Version 2. Example: _control ctrlSetTextColor [1. Type of returned value: Nothing Description: Sets tooltip text of given control. Type of returned value: Nothing Description: Sets text color of given control.92 required.BIS Game Engine Scripting Commands Page 99 of 415 control ctrlSetText text Operand types: control: Control text: String Compatibility: Version 2. Color is in format Color. world.html 7/11/2010 .50 required. 1] Category: OFP PC display ctrlSetTooltip text Operand types: display: Control text: String Compatibility: Version 2. 0. 0. Example: _control ctrlSetTooltip "tooltip" http://www. Example: _control ctrlSetText "Hello.

92 required. Color is in format Color. 0. Type of returned value: Nothing Description: Sets tooltip background color of given control. Example: _control ctrlSetTooltipColorBox [1. Type of returned value: Nothing Description: Sets tooltip border color of given control. 0. Color is in format Color.html 7/11/2010 .BIS Game Engine Scripting Commands Page 100 of 415 Category: OFP PC display ctrlSetTooltipColorBox color Operand types: display: Control color: Array Compatibility: Version 2. 0.com/comref/full. 1] Category: OFP PC display ctrlSetTooltipColorShade color Operand types: display: Control color: Array Compatibility: Version 2. 1] Category: OFP PC display ctrlSetTooltipColorText color Operand types: display: Control color: Array Compatibility: Version 2. Type of returned value: Nothing Description: Sets tooltip text color of given control. http://www.arma2.92 required. Example: _control ctrlSetTooltipColorShade [1. Color is in format Color. 0.92 required.

1] Category: OFP PC ctrlShow [idc.50 required.BIS Game Engine Scripting Commands Page 101 of 415 Example: _control ctrlSetTooltipColorText [1. show] Operand types: [idc. Type of returned value: Nothing Description: Show / hide given control. true] Category: Resistance control ctrlShow show Operand types: control: Control show: Boolean Compatibility: Version 2. 0.arma2.com/comref/full. Example: ctrlShow [100. Example: _control ctrlShow false Category: OFP PC ctrlShown control Operand types: control: Control Compatibility: Version 2.50 required. 0. Type of returned value: Nothing Description: Shows / hides the control with id idc of the topmost user dialog. Type of returned value: Boolean Description: Returns whether given control is shown. show]: Array Compatibility: Version 1.html 7/11/2010 . http://www.50 required.

html 7/11/2010 . This can be used for static texts.BIS Game Engine Scripting Commands Page 102 of 415 Example: _ok = ctrlShown _control Category: OFP PC ctrlText control Operand types: control: Control Compatibility: Version 2. Type of returned value: String Description: Returns the text shown in the control with id idc of the topmost user dialog.56 required. Type of returned value: Number Description: http://www.com/comref/full. Example: _message = ctrlText 100 Category: Resistance ctrlType control Operand types: control: Control Compatibility: Version 2. Type of returned value: String Description: Returns the text shown in given control. Example: _text = ctrlText _control Category: OFP PC ctrlText idc Operand types: idc: Number Compatibility: Version 1.arma2.50 required. edit lines and active texts.50 required. buttons.

arma2.com/comref/full.92 required.html 7/11/2010 . Type of returned value: Boolean Description: Returns whether the control with id idc of the topmost user dialog is visible. Type of returned value: String Description: Return the name of the type of the currently using magazine (on the primary turret for vehicles). Example: _type = ctrlType _control Category: OFP PC ctrlVisible idc Operand types: idc: Number Compatibility: Version 1. Type of returned value: String Description: Return the current command type (empty string when no command).50 required.BIS Game Engine Scripting Commands Page 103 of 415 Returns value representing type of control. Category: OFP http://www. Category: OFP currentMagazine vehicle Operand types: vehicle: Object Compatibility: Version 5500 required. Example: _visible = ctrlVisible 100 Category: Resistance currentCommand vehicle Operand types: vehicle: Object Compatibility: Version 2.

Type of returned value: Number Description: Return the index of the current waypoint. Category: Identity currentTasks teamMember Operand types: teamMember: Compatibility: Version 2.com/comref/full.BIS Game Engine Scripting Commands Page 104 of 415 currentTask person Operand types: person: Object Compatibility: Version 5501 required. Type of returned value: Array Description: List all uncompleted tasks. Category: OFP currentWeapon vehicle Operand types: vehicle: Object Compatibility: Version 5500 required. Type of returned value: http://www. Category: Identity currentWaypoint group Operand types: group: Group Compatibility: Version 5500 required.arma2.91 required. Type of returned value: Task Description: Return current task of given person.html 7/11/2010 .

"type"]. The object can be defined in the description.arma2.the argument uses format ["name". it's assumed to be one.BIS Game Engine Scripting Commands Page 105 of 415 String Description: Return the name of the currently selected weapon (on the primary turret for vehicles). Type of returned value: Object Description: This is the entity pointed to by a players cursor.0 Category: OFP cutObj effect Operand types: effect: Array Type of returned value: Nothing Description: Object background .speed] or ["name"."type". Example: alive cursorTarget Category: OFP layer cutFadeOut duration Operand types: layer: Number duration: Number Compatibility: Version 5126 required. If speed is not given. Example: http://www.html 7/11/2010 .com/comref/full. Type of returned value: Nothing Description: Terminate the effect in the given layer and set duration of the fade out phase to the given time. Category: OFP cursorTarget Compatibility: Version 5500 required. Example: 0 cutFadeIn 1.ext file.

it's assumed to be one.speed] or ["name"."type"].the right argument uses format ["name". it's assumed to be one. Example: 0 cutObj ["TVSet".arma2. The resource can be defined in the description.html 7/11/2010 . "PLAIN"] Category: OFP layer cutRsc effect Operand types: layer: Number effect: Array Compatibility: Version 5126 required. "plain"] Category: OFP cutRsc effect Operand types: effect: Array Type of returned value: Nothing Description: Resource background .the argument uses format ["name"."type". Example: cutRsc ["binocular"."type". The left argument define layer in which the effect is show. 0 is the back most. If speed is not given.ext file. If speed is not given."type"].ext file. The object can be defined in the description.com/comref/full. Type of returned value: Nothing Description: http://www.BIS Game Engine Scripting Commands Page 106 of 415 cutObj ["TVSet". Type of returned value: Nothing Description: Object background .speed] or ["name". "plain"] Category: OFP layer cutObj effect Operand types: layer: Number effect: Array Compatibility: Version 5126 required.

BIS Game Engine Scripting Commands

Page 107 of 415

Resource background - the right argument uses format ["name","type",speed] or ["name","type"]. If speed is not given, it's assumed to be one. The left argument define layer in which the effect is show, 0 is the back most. The resource can be defined in the description.ext file. Example: 0 cutRsc ["binocular", "PLAIN"] Category: OFP

cutText effect
Operand types: effect: Array Type of returned value: Nothing Description: Text background - the argument uses format ["text","type",speed] or ["text","type"]. If speed is not given, it's assumed to be one. Type may be one of: "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" or "WHITE IN". Example: cutText ["", "BLACK OUT"] Category: OFP

layer cutText effect
Operand types: layer: Number effect: Array Compatibility: Version 5126 required. Type of returned value: Nothing Description: Text background - the right argument uses format ["text","type",speed] or ["text","type"]. If speed is not given, it's assumed to be one. Type may be one of: "PLAIN", "PLAIN DOWN", "BLACK", "BLACK FADED", "BLACK OUT", "BLACK IN", "WHITE OUT" or "WHITE IN". The left argument define layer in which the effect is show, 0 is the back most. Example: 0 cutText ["", "BLACK OUT"] Category: OFP

damage object
Operand types:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 108 of 415

object: Object Compatibility: Version 1.50 required. Type of returned value: Number Description: Returns the object damage in a range of 0 to 1. Note: this function is identical to getDammage. Example: damage player Category: OFP

date
Compatibility: Version 2.92 required. Type of returned value: Array Description: Return the actual mission date and time as an array [year, month, day, hour, minute]. Category: OFP

DateToNumber date
Operand types: date: Array Compatibility: Version 5501 required. Type of returned value: Number Description: Convert date to float number. Example: time = DateToNumber [year,month,day,hour,minute] Category: OFP

dayTime
Type of returned value: Number Description: Returns the time in the world, in hours. Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 109 of 415

debugLog anything
Operand types: anything: Any Type of returned value: Nothing Description: Dumps the argument's type and value to the debugging output. Example: debugLog player Category: OFP

default a
Operand types: a: Code Type of returned value: Nothing Description: see switch Category: Default

deg x
Operand types: x: Number Type of returned value: Number Description: Converts x from radians to degrees. Example: deg 1 , result is 57.295 Category: Default

deleteCenter side
Operand types: side: Side Compatibility: Version 1.86 required. Type of returned value:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 110 of 415

Nothing Description: Destroys the AI center of the given side. Example: deleteCenter East Category: OFP

deleteCollection object
Operand types: object: Object Compatibility: Version 2.90 required. Type of returned value: Nothing Description: Delete a collection. Category: OFP

map deleteEditorObject object
Operand types: map: Control object: String Compatibility: Version 2.92 required. Type of returned value: Any Description: Delete the editor object. Requires all editor object links to be removed prior. Category: Editor

deleteGroup group
Operand types: group: Group Type of returned value: Nothing Description: Destroys the given AI group. Example: deleteGroup group

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 111 of 415

Category: OFP

deleteIdentity identityName
Operand types: identityName: String Compatibility: Version 1.75 required. Type of returned value: Boolean Description: Deletes an identity created by saveIdentity from the campaign progress file. Example: deleteIdentity "playerIdentity" Category: Resistance

deleteLocation location
Operand types: location: Location Compatibility: Version 2.90 required. Type of returned value: Nothing Description: Delete the given location. Category: Location

deleteMarker name
Operand types: name: String Type of returned value: Nothing Description: Destroys the given marker. The marker is destroyed on all computers in a network session. Example: deleteMarker "Marker1" Category: OFP

deleteMarkerLocal name

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 112 of 415

Operand types: name: String Compatibility: Version 2.92 required. Type of returned value: Nothing Description: Destroys the given marker. The marker is only destroyed on the computer where the command is called. Example: deleteMarkerLocal "Marker1" Category: OFP

deleteStatus statusName
Operand types: statusName: String Compatibility: Version 1.75 required. Type of returned value: Boolean Description: Deletes a status created by saveStatus from the campaign progress file. Example: deleteStatus "playerState" Category: Resistance

deleteVehicle object
Operand types: object: Object Compatibility: Version 1.34 required. Type of returned value: Nothing Description: Deletes any unit or vehicle. Only vehicles inserted in the editor or created during a mission can be deleted. The player unit cannot be deleted. Example: deleteVehicle tank Category: OFP

deleteWaypoint waypoint

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 113 of 415

Operand types: waypoint: Array Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Removes the waypoint. Example: deleteWaypoint [grp, 2] Category: OFP

detach obj
Operand types: obj: Object Compatibility: Version 5501 required. Type of returned value: Nothing Description: Detaches an object. Example: detach player Category: OFP

diag_fps
Compatibility: Version 5500 required. Type of returned value: Number Description: Returns average framerate over last 16 frames. Category: OFP

diag_fpsmin
Compatibility: Version 5500 required. Type of returned value: Number Description:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 114 of 415

Returns minimal framerate. Calculated from the longest frame over last 16 frames. Category: OFP

diag_frameno
Compatibility: Version 5500 required. Type of returned value: Number Description: Returns number of frame currently displayed . Category: OFP

diag_log anything
Operand types: anything: Any Compatibility: Version 5501 required. Type of returned value: Nothing Description: Dumps the argument's type and value to the report file. Example: diag_log player Category: OFP

diag_tickTime
Compatibility: Version 5501 required. Type of returned value: Number Description: Real time spent from the start of the game. Category: OFP

dialog
Compatibility: Version 1.78 required.

http://www.arma2.com/comref/full.html

7/11/2010

Category: OFP direction object Operand types: object: Object Compatibility: Version 1. see config class Flags in CfgDificulties. Type of returned value: Number Description: Returns the object heading in the range of 0 to 360.BIS Game Engine Scripting Commands Page 115 of 415 Type of returned value: Boolean Description: Returns whether a user dialog is present. Category: Identity difficultyEnabled flag Operand types: flag: String Compatibility: Version 5127 required. Example: direction player http://www.50 required. Type of returned value: Boolean Description: Check if given difficulty setting is currently enabled.arma2. Category: Resistance person diarySubjectExists name Operand types: person: Object name: String Compatibility: Version 5501 required. For possible values of flag.html 7/11/2010 .com/comref/full. Type of returned value: Boolean Description: Checks whether given subject is present in the diary of given person.

BIS Game Engine Scripting Commands Page 116 of 415 Category: OFP direction location Operand types: location: Location Compatibility: Version 2. Category: Location unit directSay radioName Operand types: unit: Object radioName: String Compatibility: Version 5501 required.html 7/11/2010 . The message is defined in the description.ext file or radio protocol.90 required.arma2. Type of returned value: Number Description: Return direction (angle) of given location. Type of returned value: Nothing Description: Sends the message to the direct channel. Example: soldierOne disableAI "Move" http://www. "AUTOTARGET" (disables independed target assigning and watching of unknown targets) or "MOVE" (disables movement). Section is one of "TARGET" (disables watching assigned targets).com/comref/full. Example: soldierOne directSay "messageOne" Category: OFP unit disableAI section Operand types: unit: Object section: String Type of returned value: Nothing Description: Disables parts of the AI behaviour to get more control over a unit.

BIS Game Engine Scripting Commands Page 117 of 415 Category: OFP unit disableConversation lock Operand types: unit: Object lock: Boolean Type of returned value: Nothing Description: Lock / unlock the unit to using conversation.html 7/11/2010 . Category: OFP display displayAddEventHandler [handler name.unlock need to be matched. script can work with the data types which do not support serialization (UI types).com/comref/full. so lock . This is normally used only in cutscenes to disable the player's controls. Type of returned value: Nothing Description: Disable saving of script containing this command. Category: Default disableUserInput disable Operand types: disable: Boolean Type of returned value: Nothing Description: Disables all user input. Example: player disableConversation true Category: OFP disableSerialization Compatibility: Version 5501 required. Implemented by the counter. function] Operand types: display: Display http://www.arma2. After this.

50 required.html 7/11/2010 .arma2. Example: _id = _display displayAddEventHandler ["KeyDown". function]: Array Compatibility: Version 5501 required.com/comref/full. Returns id of the handler or -1 when failed. Category: OFP PC display displayRemoveAllEventHandlers handler name Operand types: display: Display handler name: String Compatibility: Version 5501 required. Example: _control = _display displayCtrl 101 Category: OFP PC displayNull Compatibility: Version 2.BIS Game Engine Scripting Commands Page 118 of 415 [handler name. Type of returned value: Number Description: Add an event handler to the given display. including itself. This value is not equal to anything.92 required. Type of returned value: Display Description: A non-existing display. ""] Category: OFP PC display displayCtrl idc Operand types: display: Display idc: Number Compatibility: Version 2. http://www. Type of returned value: Control Description: Return child control with specified idc.

Example: _control displaySetEventHandler ["KeyDown". ""] Category: OFP PC dissolveTeam team Operand types: team: String http://www. Type of returned value: Nothing Description: Remove a given event handler from the given display. Type of returned value: Nothing Description: Sets given event handler of given display.com/comref/full. Example: _display displayRemoveEventHandler ["KeyDown".BIS Game Engine Scripting Commands Page 119 of 415 Type of returned value: Nothing Description: Remove all even handlers from the given display. function]: Array Compatibility: Version 2. function] Operand types: display: Display [handler name. 0] Category: OFP PC display displaySetEventHandler [handler name. Example: _display displayRemoveAllEventHandlers "KeyDown" Category: OFP PC display displayRemoveEventHandler [handler name.html 7/11/2010 .arma2. id] Operand types: display: Display [handler name.54 required. id]: Array Compatibility: Version 5501 required.

"BLUE" or "YELLOW". Type of returned value: Number Description: Computes the distance between two locations or positions. All members become members of the main team.05 required. "GREEN".BIS Game Engine Scripting Commands Page 120 of 415 Compatibility: Version 2. Type of returned value: Number http://www. Example: player distance leader player Category: OFP location1 or pos1 distance location2 or pos2 Operand types: location1 or pos1: location2 or pos2: Compatibility: Version 5501 required. Example: dissolveTeam "RED" Category: OFP obj1 or pos1 distance obj2 or pos2 Operand types: obj1 or pos1: Object or Array obj2 or pos2: Object or Array Type of returned value: Number Description: Computes the distance between two objects or positions.arma2.html 7/11/2010 . Category: Location distributionRegion Compatibility: Version 5129 required. Possible team values are: "RED".com/comref/full. Type of returned value: Nothing Description: Dissolves the given team.

.BIS Game Engine Scripting Commands Page 121 of 415 Description: Return the region where the game was sold (based on distribution id). starts cycle Example: for "_x" from 20 to 10 step -2 do {. Note: the maximum repeat count for the loop is http://www.code.. Category: OFP with do code Operand types: with: With Type code: Code Compatibility: Version 5501 required. Type of returned value: Nothing Description: Repeats the code while the condition is true.com/comref/full.html 7/11/2010 .arma2. Type of returned value: Nothing Description: Execute the code inside the given namespace.} Category: Default while do code Operand types: while: While Type code: Code Compatibility: Version 1.85 required. Example: with missionNamespace do {global=global+1} Category: Default forCommand do code Operand types: forCommand: for type code: Code Type of returned value: Any Description: End of for command.

BIS Game Engine Scripting Commands Page 122 of 415 10000. Example: soldierOne doFire objNull Category: OFP unit doFollow position Operand types: unit: Object or Array position: Object Type of returned value: Nothing Description: Orders a unit to follow the given unit (silently). the loop will be terminated and an error message is shown.com/comref/full. the unit is ordered to commence firing on its current target (set using doTarget or commandTarget).} Category: Default unit doFire target Operand types: unit: Object or Array target: Object Type of returned value: Nothing Description: Orders a unit to commence firing on the given target (silently). Example: while "a>b" do {a=a+1} Category: Default switch do block Operand types: switch: Switch Type block: Code Type of returned value: Any Description: Switch form Example: switch (_a) do { case 1: {block}. default {block}. http://www.arma2. If the condition is still true after the loop was repeated 10000 times. If the target is objNull. case 2 : {block}.html 7/11/2010 .

arma2. position.fsm".html 7/11/2010 . Type of returned value: Nothing Description: Orders a unit to get out from the vehicle (silently).com/comref/full.53 required. position player. target]: Array Compatibility: Version 2. target] Operand types: unit(s): Object or Array [fsm name. Example: soldierOne doFSM ["move. position.BIS Game Engine Scripting Commands Page 123 of 415 Example: soldierOne doFollow player Category: OFP unit(s) doFSM [fsm name.28 required. http://www. Example: doGetOut unitOne Category: OFP unit doMove position Operand types: unit: Object or Array position: Array Type of returned value: Nothing Description: Orders the unit to move to the given position (format Position) (silently). Type of returned value: Nothing Description: Orders a unit to process command defined by FSM file (silently). player] Category: OFP PC doGetOut unit Operand types: unit: Object or Array Compatibility: Version 2.

Note: the stop command is never finished. Example: soldierOne doWatch getMarkerPos "MarkerMoveOne" http://www.arma2. Example: doStop unitOne Category: OFP unit doTarget position Operand types: unit: Object or Array position: Object Type of returned value: Nothing Description: Orders the unit to target the given target (silently).BIS Game Engine Scripting Commands Page 124 of 415 Example: soldierOne doMove getMarkerPos "MarkerMoveOne" Category: OFP doStop unit Operand types: unit: Object or Array Type of returned value: Nothing Description: Orders the unit to stop (silently).com/comref/full.html 7/11/2010 . Example: soldierOne doTarget player Category: OFP unit doWatch position Operand types: unit: Object or Array position: Array Type of returned value: Nothing Description: Orders the unit to watch the given position (format Position) (silently). the unit will never be ready.

color.arma2. position2.35 required. color.com/comref/full. b. fill] Operand types: map: Control [center. Category: OFP PC http://www. a. fill]: Array Compatibility: Version 2. color] Operand types: map: Control [position1. Example: soldierOne doWatch player Category: OFP map drawArrow [position1.BIS Game Engine Scripting Commands Page 125 of 415 Category: OFP unit doWatch target Operand types: unit: Object or Array target: Object Type of returned value: Nothing Description: Orders the unit to watch the given target (silently). Category: OFP PC map drawEllipse [center. angle.html 7/11/2010 . color]: Array Compatibility: Version 2. angle. position2. b. Type of returned value: Nothing Description: Draw arrow in map.35 required. Type of returned value: Nothing Description: Draw ellipse in map. a.

angle. Category: OFP PC map drawLink [from. shadow]: Array Compatibility: Version 2. position2. color] Operand types: map: Control [position1. height. line type. Type of returned value: Nothing Description: Draw icon in map.BIS Game Engine Scripting Commands Page 126 of 415 map drawIcon [texture. color]: Array Compatibility: Version 2. color. color]: Array Compatibility: Version 2. text. shadow] Operand types: map: Control [texture. Category: Editor map drawLocation location Operand types: map: Control location: Location http://www. height. Line type can be LINE or ARROW.92 required. Type of returned value: Nothing Description: The editor will draw a line between the two specified editor objects. to. Type of returned value: Nothing Description: Draw line in map.com/comref/full.35 required. param type.arma2. angle. color] Operand types: map: Control [from. width. color.35 required. Category: OFP PC map drawLine [position1. position2. position. to. width.html 7/11/2010 . text. line type. param type. position.

angle. angle. Type of returned value: Nothing Description: Drops a particle into the scene. Type of returned value: Nothing Description: Draw location in the map. b. a. b. Example: driver vehicle player Category: OFP drop array Operand types: array: Array Compatibility: Version 1. but a person. Category: Location PC map drawRectangle [center.90 required. If the vehicle is not a vehicle.50 required. color. http://www.com/comref/full. the person is returned instead. fill] Operand types: map: Control [center. a. fill]: Array Compatibility: Version 2.html 7/11/2010 . Category: OFP PC driver vehicle Operand types: vehicle: Object Type of returned value: Object Description: Returns the driver of the vehicle.35 required. color. Type of returned value: Nothing Description: Draw rectangle in map.BIS Game Engine Scripting Commands Page 127 of 415 Compatibility: Version 2. Array is in format ParticleArray.arma2.

Type of returned value: Nothing Description: Sends any text into the debugger console or the logfile.com/comref/full. Category: Editor map editorSetEventHandler [handler name. function] Operand types: map: Control http://www.html 7/11/2010 .92 required.00 required.BIS Game Engine Scripting Commands Page 128 of 415 Category: Resistance east Type of returned value: Side Description: The East side. Type of returned value: Any Description: Show the edit object dialog for the given object. Example: echo "Text in logfile" Category: Default map editObject object Operand types: map: Control object: String Compatibility: Version 2.arma2. Category: OFP echo text Operand types: text: String Compatibility: Version 2.

Type of returned value: Nothing Description: Sets given event handler of given editor. Category: OFP ifCode else elseCode Operand types: ifCode: Code elseCode: Code Compatibility: Version 1.BIS Game Engine Scripting Commands Page 129 of 415 [handler name.com/comref/full.html 7/11/2010 . Example: if (a>b) then {c=0} else {c=1} Category: Default vehicle emptyPositions position Operand types: vehicle: Object position: String http://www.92 required.92 required. Type of returned value: Object Description: Returns the effective commander (who really commands) of the vehicle.arma2. Type of returned value: Array Description: Constructs an array that can be processed by then. function]: Array Compatibility: Version 2.85 required. Example: _map editorSetEventHandler ["SelectObject". ""] Category: Editor effectiveCommander vehicle Operand types: vehicle: Object Compatibility: Version 2.

Type of returned value: Number Description: Returns the number of available cargo.92 required. Example: _freePositions = (vehicle player) freePositions "cargo" Category: OFP unit enableAI section Operand types: unit: Object section: String Compatibility: Version 2.92 required. gunner or commander positions in the vehicle. Section is one of "TARGET" (enables watching assigned targets). Type of returned value: Nothing Description: Enables parts of the AI behaviour. Type of returned value: Nothing Description: Set if leader can issue attack commands.html 7/11/2010 . Category: OFP enableEndDialog Type of returned value: http://www. driver.53 required.BIS Game Engine Scripting Commands Page 130 of 415 Compatibility: Version 2.com/comref/full. Example: soldierOne enableAI "Move" Category: OFP group enableAttack enable Operand types: group: Object or Group enable: Boolean Compatibility: Version 2. "AUTOTARGET" (enables independed target assigning and watching of unknown targets) or "MOVE" (enables movement).arma2.

92 required. Category: OFP object enableReload enable Operand types: object: Object enable: Boolean Compatibility: Version 2. Example: _vehicle enableReload false http://www.92 required. Example: enableEnvironment false Category: OFP enableRadio enable Operand types: enable: Boolean Type of returned value: Nothing Description: Enables radio transmissions to be heard and seen on screen.arma2. Type of returned value: Nothing Description: Enable / disable reload right after magazine is empty.html 7/11/2010 . Type of returned value: Nothing Description: Enable/disable environmental effects (ambient life + sound).com/comref/full. Category: OFP enableEnvironment enabled Operand types: enabled: Boolean Compatibility: Version 2.BIS Game Engine Scripting Commands Page 131 of 415 Nothing Description: Enables the dialog buttons to be shown during the OnPlayerKilled script.

Category: OFP entity enableSimulation enable Operand types: entity: Object enable: Boolean Type of returned value: Nothing Description: Enable / disable simulation for given entity. Category: OFP enableTeamSwitch enable Operand types: enable: Boolean Compatibility: Version 2. Type of returned value: Nothing Description: Enable / disable saving of the game. Category: OFP enableSentences enable Operand types: enable: Boolean Type of returned value: Nothing Description: Enables radio transmissions to be heard and seen on screen. save] Operand types: enable or [enable. http://www. When disabled.BIS Game Engine Scripting Commands Page 132 of 415 Category: OFP enableSaving enable or [enable.arma2.html 7/11/2010 . save]: Compatibility: Version 5501 required. the autosave is created (if not forbidden by save == false).92 required. It does not affect KBTell conversations.com/comref/full.

Type of returned value: Nothing Description: Finish the mission. "KILLED".arma2.com/comref/full. Example: vehicle player engineOn false Category: OFP http://www. Type of returned value: Nothing Description: Finish loading screen displaying (started by startLoadingScreen). "END2". Category: OFP endMission end type Operand types: end type: String Compatibility: Version 5501 required. "LOSER". "END5".html 7/11/2010 . "END1". Category: OFP vehicle engineOn on Operand types: vehicle: Object on: Boolean Compatibility: Version 1. Type of returned value: Nothing Description: Switches the vehicle's engine on (true) or off (false). The end type can be "CONTINUE".90 required. "END3". "END4". or "END6". Category: OFP endLoadingScreen Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 133 of 415 Type of returned value: Nothing Description: Enable / disable team switch.

the following example can be used in the init.arma2. argument]: Array Compatibility: Version 2. Category: Editor argument exec script Operand types: http://www.html 7/11/2010 .34 required.BIS Game Engine Scripting Commands Page 134 of 415 estimatedEndServerTime Compatibility: Version 5501 required. Category: OFP estimatedTimeLeft timeLeft Operand types: timeLeft: Number Compatibility: Version 1. argument] Operand types: map: Control [object. Type of returned value: Any Description: Return object argument in mission editor. Using this function the designer can provide a "time left" estimate that is shown in the "Game in progress" screen or in the master browser. Example: estimatedTimeLeft Param1 Category: OFP map evalObjectArgument [object. Type of returned value: Nothing Description: Returns the estimated time left in the game.sqs file.com/comref/full. For missions with a hard set limit adjusted via Param1.35 required. Type of returned value: Number Description: Estimated end of MP game converted to serverTime.

jeepOne] exec "getIn. Return the FSM handler or 0 when failed. Example: execFSM "test.com/comref/full.sqs" Category: OFP map execEditorScript [object. then in the campaign scripts subfolder and finally in the global scripts folder. Type of returned value: Number Description: Execute the scripted FSM.fsm" Category: OFP http://www. The FSM file is first searched in the mission folder. script]: Array Compatibility: Version 2. Example: [player. Example: _map execEditorScript ["_team_1". "create"] Category: Editor execFSM filename Operand types: filename: String Compatibility: Version 5500 required. The script is first searched in the mission folder. then in the campaign scripts folder and finally in the global scripts folder.arma2. script] Operand types: map: Control [object.92 required.html 7/11/2010 .BIS Game Engine Scripting Commands Page 135 of 415 argument: Any script: String Type of returned value: Nothing Description: Executes a script. Type of returned value: Any Description: Execute an editor script for the specified object. Argument is passed to the script as local variable _this.

Return the FSM handler or 0 when failed. Example: player execFSM "test. then in the campaign scripts folder and finally in the global scripts folder. Argument is passed to the FSM as local variable _this. Example: http://www. then in the campaign scripts folder and finally in the global scripts folder. Example: execVM "test.html 7/11/2010 . Type of returned value: Script Description: Compile and execute function (sqf). The FSM file is first searched in the mission folder.sqf" Category: OFP PC argument execVM filename Operand types: argument: Any filename: String Compatibility: Version 2.BIS Game Engine Scripting Commands Page 136 of 415 argument execFSM filename Operand types: argument: Any filename: String Compatibility: Version 5500 required.fsm" Category: OFP execVM filename Operand types: filename: String Compatibility: Version 2. Argument is passed to the script as local variable _this. The function is first searched in the mission folder. The function is first searched in the mission folder. then in the campaign scripts folder and finally in the global scripts folder. Type of returned value: Script Description: Compile and execute function (sqf).arma2. Type of returned value: Number Description: Execute the scripted FSM.com/comref/full.60 required.58 required.

com/comref/full.sqf" Category: OFP PC exit Type of returned value: Nothing Description: Exits the script.BIS Game Engine Scripting Commands Page 137 of 415 player execVM "test._x} .html 7/11/2010 . outputs message and terminates code in current level with value of _x Category: Default exp x Operand types: x: Number Type of returned value: Number Description: The exponential value of x. Example: exp 1 . Category: OFP if exitWith code Operand types: if: If Type code: Code Compatibility: Version 2 required. result is 2. and current block with result of code Example: if (_x>5) exitWith {echo "_x is too big".arma2. Type of returned value: Any Description: if result of condition is true. evaluates code. result is [when _x is greater then 5.7182 Category: Default expectedDestination person http://www.

Category: OFP time fadeMusic volume Operand types: time: Number volume: Number Type of returned value: Nothing Description: Causes a smooth change in the music volume.html 7/11/2010 . Category: OFP faction unit Operand types: unit: Object Compatibility: Version 5501 required. forceReplan]. Example: 5 fadeMusic 0 Category: OFP time fadeRadio volume Operand types: time: Number volume: Number Type of returned value: Nothing Description: http://www.com/comref/full. If faction is not defined.5. planningMode. The default music volume is 0.92 required. the target volume by volume. Type of returned value: Array Description: Return expected destination of unit as a [position. Type of returned value: String Description: Gets unit faction.BIS Game Engine Scripting Commands Page 138 of 415 Operand types: person: Object Compatibility: Version 2. returns empty string.arma2. The change duration is given by time.

The change duration is given by time.1 Category: OFP time fadeSound volume Operand types: time: Number volume: Number Type of returned value: Nothing Description: Causes a smooth change in the master volume. Type of returned value: Nothing Description: Finish the mission. Category: OFP false Type of returned value: Boolean Description: Always false. the target volume by volume.BIS Game Engine Scripting Commands Page 139 of 415 Causes a smooth change in the radio volume. "END3". the target volume by volume.1 Category: OFP failMission end type Operand types: end type: String Compatibility: Version 5501 required. "END4". Example: 5 fadeSound 0.com/comref/full. Example: 5 fadeRadio 0. The change duration is given by time. "END2". Mission saves will not be deleted. The default master volume is 1. Category: Default http://www. "KILLED". "END5".0. "LOSER". or "END6".0. The default radio volume is 1. The end type can be "CONTINUE".arma2. "END1".html 7/11/2010 .

ignoreObject] Operand types: object: Object [position. Example: fillWeaponsFromPool victor Category: Resistance array find x Operand types: array: Array x: Any Compatibility: Version 2.92 required. hidePosition.html 7/11/2010 . maxDist.92 required. minDist. visibilityPosition. minDist. maxDist. 2] find 1 . 1. Type of returned value: Object Description: Returns the object where the object should search for cover.arma2. Category: OFP http://www. Type of returned value: Nothing Description: Adds magazines from the campaign pool to the person (depending on the weapons the person has). visibilityPosition.BIS Game Engine Scripting Commands Page 140 of 415 fillWeaponsFromPool person Operand types: person: Object Compatibility: Version 1. Type of returned value: Number Description: Returns the position of the first array element that matches x. hidePosition. ignoreObject is an object that is ignored in visibility check. visibilityPosition and ignoreObject parameters are optional.75 required. The minDist. result is 1 Category: Default object findCover [position. Example: [0. returns -1 if not found. ignoreObject]: Array Compatibility: Version 2.com/comref/full. visibilityPosition is used to select cover that can see a certain position.

Use [type. Category: Editor map findEditorObject [type. game value] to search by object reference of a specific editor object type. Category: Editor center findEmptyPosition [radius. value1. name1.] Operand types: map: Control [type.arma2. maxDistance] or [radius.92 required. name1.BIS Game Engine Scripting Commands Page 141 of 415 findDisplay idd Operand types: idd: Number Compatibility: Version 2..54 required.html 7/11/2010 . . value1. maxDistance. Type of returned value: String Description: Return object that matches the provided reference. vehicleType] http://www. Type of returned value: String Description: Return object of given type with given arguments.]: Array Compatibility: Version 2....com/comref/full. . Type of returned value: Display Description: Find display by its IDD.35 required. Example: _display = findDisplay 1 Category: OFP PC map findEditorObject value Operand types: map: Control value: Any Compatibility: Version 2.

maxDistance. maxDistance] Operand types: center: Array [radius. Type of returned value: Object Description: Find the nearest enemy from the specified position.arma2.com/comref/full. empty array is returned.BIS Game Engine Scripting Commands Page 142 of 415 Operand types: center: Array [radius.html 7/11/2010 . Category: OFP center findEmptyPositionReady [radius. Type of returned value: Array Description: Check if findEmptyPosition can be called without waiting for files. Type of returned value: Array Description: Search for the position nearest (up to maxDistance) to the center. maxDistance]: Array Compatibility: Version 5501 required. Category: OFP object findNearestEnemy position Operand types: object: Object position: Object or Array Compatibility: Version 2. vehicleType]: Array Compatibility: Version 5501 required. with the free area (vehicle of the given type can be placed anywhere) of the given radius.92 required. maxDistance] or [radius. Type of returned value: Nothing Description: http://www. When not found.33 required. Category: OFP finishMissionInit Compatibility: Version 2.

com/comref/full. The array has format [muzzle. Example: soldierOne fire ["throw". magazine] or [muzzle. mode].html 7/11/2010 . mode."SmokeShell".arma2. result is false Category: Default unit fire weaponName Operand types: unit: Object weaponName: String Type of returned value: Nothing Description: The unit will fire from the given weapon. if number is finite (not infinite and valid number) Example: finite 10/0 . Category: OFP finite x Operand types: x: Number Type of returned value: Boolean Description: True."SmokeShell"] Category: OFP http://www. Example: soldierOne fire "HandGrenade" Category: OFP unit fire array Operand types: unit: Object array: Array Type of returned value: Nothing Description: The unit will fire from the given weapon.BIS Game Engine Scripting Commands Page 143 of 415 Finish world initialization before mission is launched.

com/comref/full. objNull is returned. If not.BIS Game Engine Scripting Commands Page 144 of 415 flag unit Operand types: unit: Object Type of returned value: Object Description: If the unit has a flag. this flag is returned. the returned value is the person that has this flag. Example: flagowner flagOne Category: OFP fleeing unit Operand types: unit: Object Type of returned value: Boolean Description: Checks whether the unit is fleeing. When used on anything else.arma2. Example: fleeing player Category: OFP floor x Operand types: http://www. Example: flag player Category: OFP flagOwner flag Operand types: flag: Object Type of returned value: Object Description: When used on a flag. objNull is returned.html 7/11/2010 . A dead or empty unit returns false.

25 . The accepted range is from 50 to 1000. Category: OFP fogForecast Compatibility: Version 2. Type of returned value: Number Description: Return the current fog. Example: cobraOne flyInHeight 150 Category: OFP fog Compatibility: Version 2.arma2.92 required.92 required.com/comref/full.html 7/11/2010 . Category: OFP http://www. Type of returned value: Number Description: Return the fog forecast.BIS Game Engine Scripting Commands Page 145 of 415 x: Number Type of returned value: Number Description: The floor value of x. result is 5 Category: Default helicopter flyInHeight height Operand types: helicopter: Object height: Number Type of returned value: Nothing Description: Sets the height level for the helicopter. Example: floor 5.

Category: OFP forceMap show Operand types: show: Boolean Compatibility: Version 1.html 7/11/2010 .com/comref/full.BIS Game Engine Scripting Commands Page 146 of 415 for var Operand types: var: String Type of returned value: for type Description: Starts for sequence. Type of returned value: Nothing Description: Forces the map to display. Example: for "_x" from 1 to 10 do {debugLog _x. http://www. using C like style. Example: for [{_x=1}.} Category: Default for forspec Operand types: forspec: Array Type of returned value: for type Description: creates cycle.{_x<=10}. use in complette form(see example).27 required.} Category: Default forceEnd Type of returned value: Nothing Description: Forces the mission to terminate.arma2. See example.{_x=_x+1}] do {debugLog _x.

Type of returned value: Nothing Description: Force the speed of the given object. %x may appear in the string in any order. Each %x is replaced by the corresponding argument. Category: OFP command forEach array Operand types: command: Code array: Array Type of returned value: Nothing Description: Executes the given command for each element in array.%2 . etc.BIS Game Engine Scripting Commands Page 147 of 415 Example: forceMap true Category: OFP object forceSpeed speed Operand types: object: Object speed: Number Compatibility: Version 2.92 required. Example: format ["%1 . This string may contain references to the following arguments using format %1. "text"] .1" http://www. result is "1 .com/comref/full. It's executed as follows: for each element of array an element is assigned as _x and the command is executed. 1.%1".arma2. %2. Example: "_x setdammage 1" forEach units group player Category: Default format format Operand types: format: Array Type of returned value: String Description: The first argument of the array is in format string.text .html 7/11/2010 .

92 required.html 7/11/2010 . Type of returned value: Object Description: Return leader of the formation. Type of returned value: Number Description: Return the direction unit watching in formation.92 required. "ECH RIGHT". Category: OFP formationMembers person http://www. "VEE" or "LINE"). Category: OFP formationLeader person Operand types: person: Object Compatibility: Version 2.com/comref/full. Example: formation group player Category: OFP formationDirection person Operand types: person: Object Compatibility: Version 2. "ECH LEFT".BIS Game Engine Scripting Commands Page 148 of 415 Category: OFP formation grp Operand types: grp: Object or Group Type of returned value: String Description: Returns the formation of the group ("COLUMN". "STAG COLUMN". "WEDGE".arma2.

Category: OFP formationPosition person Operand types: person: Object Compatibility: Version 2. . Category: OFP formationTask person Operand types: person: Object Compatibility: Version 2. %2. . Type of returned value: Structured text Description: Creates a structured text by replacing %1.. Category: OFP formatText [format..01 required.. in format by plain or structured texts given as arguments.92 required. arg2. Type of returned value: String Description: Return the current task of the unit in the formation. etc.BIS Game Engine Scripting Commands Page 149 of 415 Operand types: person: Object Compatibility: Version 2.arma2. Type of returned value: Array Description: Return position of unit in the formation. arg2..]: Array Compatibility: Version 2.html 7/11/2010 . http://www.com/comref/full.] Operand types: [format.92 required. arg1.92 required. Type of returned value: Array Description: Return list of units (drivers) in the formation. arg1.

Example: fuel vehicle player http://www. For dead units objNull is returned. The result is often the same as groupLeader.com/comref/full.BIS Game Engine Scripting Commands Page 150 of 415 Example: txt = formatText ["Image: %1".. Example: formLeader player != leader player Category: OFP for "_var" from b Operand types: for "_var": for type b: Number Type of returned value: for type Description: Continue sequence of 'for' command.} Category: Default fuel vehicle Operand types: vehicle: Object Type of returned value: Number Description: Checks how much fuel is left in the gas tank.. Example: for "_x" from 10 to 20 do {. image "data\isniper.html 7/11/2010 .arma2. in the range from 0 to 1. but not always.paa"] Category: OFP formLeader unit Operand types: unit: Object Type of returned value: Object Description: Returns the formation leader for the given unit.code.

Example: _array = getArray (configFile >> "CfgVehicles" >> "Thing" >> "threat") Category: OFP PC getDammage obj Operand types: obj: Object Type of returned value: Number Description: Returns the object damage in the range from 0 to 1.html 7/11/2010 . Type of returned value: Array Description: Extract array from config entry.arma2.35 required. Example: getDammage player Category: OFP http://www.com/comref/full.BIS Game Engine Scripting Commands Page 151 of 415 Category: OFP gearSlotData control Operand types: control: Control Compatibility: Version 5501 required. Example: weapon = gearSlotData _control Category: OFP PC getArray config Operand types: config: Config Compatibility: Version 2. Type of returned value: String Description: Returns gear slot item name.

BIS Game Engine Scripting Commands Page 152 of 415 getDir obj Operand types: obj: Object Type of returned value: Number Description: Returns the object heading in the range from 0 to 360.html 7/11/2010 .arma2. Type of returned value: String Description: Returns the current mode of the editor.92 required. Type of returned value: Object Description: Fetches a reference to the mission editor camera. Type of returned value: http://www.com/comref/full. Category: Editor getEditorMode map Operand types: map: Control Compatibility: Version 2. Example: getDir player Category: OFP getEditorCamera map Operand types: map: Control Compatibility: Version 2.92 required. Category: Editor map getEditorObjectScope object Operand types: map: Control object: String Compatibility: Version 2.92 required.

Type of returned value: Number Description: Returns if sides are friendly or hostile.arma2.BIS Game Engine Scripting Commands Page 153 of 415 String Description: Returns the editor object scope of the specified editor object.html 7/11/2010 . Category: OFP group getGroupIcon ID Operand types: group: Group ID: Number Compatibility: Version 5501 required. otherwise it's friendly.com/comref/full. The FSM handle is the number returned by the execFSM command. Example: value = west getFriend east Category: OFP FSM handle getFSMVariable name Operand types: FSM handle: Number name: String Compatibility: Version 5501 required. Type of returned value: Any Description: Return the value of variable in the variable space of given FSM.6 it results in being enemy. For a value smaller than 0. Type of returned value: Array http://www. Category: Editor side1 getFriend side2 Operand types: side1: Side side2: Side Compatibility: Version 5501 required.

Type of returned value: http://www.].html 7/11/2010 .BIS Game Engine Scripting Commands Page 154 of 415 Description: Get group icon properties.arma2..] Example: getGroupIcons group Category: OFP object getHideFrom enemy Operand types: object: Object enemy: Object Compatibility: Version 2.scale. [color.[[id. visible] Example: getGroupIconParams group Category: OFP getGroupIcons group Operand types: group: Group Compatibility: Version 5501 required. Example: group getGroupIcon id Category: OFP getGroupIconParams group Operand types: group: Group Compatibility: Version 5501 required.offsety].com/comref/full.92 required.icon.[... text. Type of returned value: Array Description: Returns group icons params. Type of returned value: Array Description: Returns all group icons.[offsetx.

http://www. See setMarkerColor.21 required.com/comref/full.html 7/11/2010 . Example: getMarkerColor "MarkerOne" Category: OFP getMarkerPos markerName Operand types: markerName: String Type of returned value: Array Description: Returns the marker positon in format [x. If enemy is null it is the some position in front of the object or enemy position otherwise. Type of returned value: String Description: Gets the marker color. Category: OFP getMarkerColor marker Operand types: marker: String Compatibility: Version 1.y].BIS Game Engine Scripting Commands Page 155 of 415 Array Description: Returns the hiding position in format Position. Example: getMarkerPos "markerOne" Category: OFP getMarkerSize marker Operand types: marker: String Compatibility: Version 1.z.arma2.21 required. See setMarkerSize. Type of returned value: Array Description: Gets the marker size.

Example: getMarkerType "MarkerOne" Category: OFP getNumber config Operand types: config: Config Compatibility: Version 2. Type of returned value: Number Description: Extract number from config entry.arma2. argument]: Array Compatibility: Version 2.35 required. Example: _array = getNumber (configFile >> "CfgVehicles" >> "Thing" >> "maxSpeed") Category: OFP PC map getObjectArgument [object.35 required.21 required. Type of returned value: String Description: Gets the type of the marker. argument] Operand types: map: Control [object.BIS Game Engine Scripting Commands Page 156 of 415 Example: getMarkerSize "MarkerOne" Category: OFP getMarkerType marker Operand types: marker: String Compatibility: Version 1.com/comref/full. Type of returned value: String Description: Return name of object argument in mission editor. http://www. See setMarkerType.html 7/11/2010 .

Category: Editor getPos obj Operand types: obj: Object Type of returned value: Array Description: Returns the object position in format Position.arma2. Type of returned value: Array Description: Return a list of all the children of the specified object. Type of returned value: Object Description: Return the proxy object associated with the given editor object. Example: getPos player Category: OFP getPos location http://www.92 required.com/comref/full.html 7/11/2010 .92 required.BIS Game Engine Scripting Commands Page 157 of 415 Category: Editor map getObjectChildren object Operand types: map: Control object: String Compatibility: Version 2. Category: Editor map getObjectProxy object Operand types: map: Control object: String Compatibility: Version 2.

http://www. Category: Location getPosASL obj Operand types: obj: Object Compatibility: Version 2.BIS Game Engine Scripting Commands Page 158 of 415 Operand types: location: Location Compatibility: Version 5501 required."SLOW"."NORMAL".arma2. Category: OFP getText config Operand types: config: Config Compatibility: Version 2.53 required.35 required.com/comref/full. Example: getPosASL player Category: OFP object getSpeed speedMode Operand types: object: Object speedMode: String Compatibility: Version 2.92 required. Type of returned value: Number Description: Get the speed for the given speed mode.html 7/11/2010 . Type of returned value: Array Description: Returns the object position in format PositionASL. SpeedMode can be: "AUTO". Type of returned value: Array Description: Return (raw) position of given location."FAST".

arma2. Example: _array = getText (configFile >> "CfgVehicles" >> "Thing" >> "icon") Category: OFP PC namespace getVariable name Operand types: namespace: Namespace name: String Compatibility: Version 5501 required.html 7/11/2010 . Category: Default group getVariable name Operand types: group: Group name: String Compatibility: Version 5501 required. Category: OFP location getVariable name Operand types: location: Location name: String Compatibility: Version 2. Type of returned value: Any Description: Return the value of variable in the variable space of given group. Type of returned value: Any Description: Return the value of variable in the given namespace.BIS Game Engine Scripting Commands Page 159 of 415 Type of returned value: String Description: Extract text from config entry. Type of returned value: Any Description: http://www.92 required.com/comref/full.

Category: OFP map getVariable name Operand types: map: Control name: String Compatibility: Version 2. Category: Editor task getVariable name Operand types: task: Task name: String Compatibility: Version 2.html 7/11/2010 . Type of returned value: Nothing Description: Get variable from the variable space of given map. Type of returned value: Any Description: Return the value of variable in the variable space of given object. Category: Location object getVariable name Operand types: object: Object name: String Compatibility: Version 2.92 required.92 required.92 required.BIS Game Engine Scripting Commands Page 160 of 415 Return the value of variable in the variable space of given location.arma2. Category: Identity http://www. Type of returned value: Any Description: Return the value of variable in the variable space of given task.com/comref/full.

Example: soldierOne globalChat "Show this text" Category: OFP http://www. Example: getWPPos [groupOne. otherSoldier glanceAt getMarkerPos "markerOne" Category: OFP unit globalChat chatText Operand types: unit: Object chatText: String Type of returned value: Nothing Description: Types text to the global radio channel. it does not broadcast the message. Type of returned value: Nothing Description: Control what the unit is glancing at (target or position) (format Position) Example: someSoldier glanceAt otherSoldier.arma2.40 required. If you want the message to show on all computers.html 7/11/2010 . The format of waypoint is Waypoint.com/comref/full.BIS Game Engine Scripting Commands Page 161 of 415 getWPPos waypoint Operand types: waypoint: Array Compatibility: Version 1. 1] Category: OFP unit(s) glanceAt position Operand types: unit(s): Object or Array position: Object or Array Compatibility: Version 2.21 required. you have to execute it on all of them. Note: this function only types text to the list. Type of returned value: Array Description: Gets the waypoint position.

html 7/11/2010 .ext file or radio protocol. Note: the string argument is used here.arma2. grpNull is returned. For dead units. The message is defined in the description. Example: soldierOne globalRadio "messageOne" Category: OFP goto label Operand types: label: String Type of returned value: Nothing Description: Only in scripts: go to given label. Be sure to use double quotes around the label name in goto.com/comref/full.BIS Game Engine Scripting Commands Page 162 of 415 unit globalRadio radioName Operand types: unit: Object radioName: String Type of returned value: Nothing Description: Sends the message to the global radio channel. Example: group player == group leader player Category: OFP unit groupChat chatText Operand types: http://www. Example: goto "Loop" Category: OFP group obj Operand types: obj: Object Type of returned value: Group Description: Returns the group to which the given unit is assigned.

Example: http://www.com/comref/full. Category: OFP groupIconsVisible Compatibility: Version 5501 required. If you want the message to show on all computers. you have to execute it on all of them. it does not broadcast the message.BIS Game Engine Scripting Commands Page 163 of 415 unit: Object chatText: String Type of returned value: Nothing Description: Types text to the group radio channel. Type of returned value: Array Description: Return group icons are visible. The message is defined in the description.ext file or radio protocol.html 7/11/2010 . Note: this function only types text to the list. Type of returned value: Boolean Description: Return if groups icon raises onClick and onOver events. Category: OFP unit groupRadio radioName Operand types: unit: Object radioName: String Type of returned value: Nothing Description: Sends the message to the group radio channel. Example: soldierOne groupChat "Show this text" Category: OFP groupIconSelectable Compatibility: Version 5501 required.arma2.

Type of returned value: Nothing Description: Select unit from unit's group.true] Category: OFP grpNull Type of returned value: Group Description: A non-existing group. including itself.arma2. Type of returned value: Array Description: Returns selected groups in sgroup.com/comref/full. Example: group player == objNull . Example: player groupSelectUnit [unit.BIS Game Engine Scripting Commands Page 164 of 415 soldierOne groupRadio "messageOne" Category: OFP groupSelectedUnits unit Operand types: unit: Object Compatibility: Version 5501 required.bool]: Array Compatibility: Version 5501 required. This value is not equal to anything.bool] Operand types: unit: Object [unit. result is false Category: OFP http://www.html 7/11/2010 . Example: array = groupSelectedUnits unit Category: OFP unit groupSelectUnit [unit.

Example: gunner vehicle player Category: OFP halt Compatibility: Version 2.arma2.com/comref/full.00 required. Example: handsHit leader player Category: OFP unit hasWeapon weaponName Operand types: http://www. Type of returned value: Nothing Description: Stops the program into a debugger. the person is returned.BIS Game Engine Scripting Commands Page 165 of 415 gunner vehicle Operand types: vehicle: Object Type of returned value: Object Description: Returns the gunner of the vehicle. If the vehicle is not a vehicle. but a person.html 7/11/2010 . Example: halt Category: Default handsHit soldier Operand types: soldier: Object Type of returned value: Number Description: Checks whether the soldier's hands are hit (causing inaccurate aiming).

Example: array = hcAllGroups unit Category: OFP unit hcGroupParams group Operand types: unit: Object group: Group Compatibility: Version 5501 required.com/comref/full. Return value is [string.BIS Game Engine Scripting Commands Page 166 of 415 unit: Object weaponName: String Type of returned value: Boolean Description: Checks whether the unit has the given weapon.float[4]] Example: unit hcGroupParams group Category: OFP hcLeader group Operand types: http://www. Type of returned value: Array Description: Returns parameters describing group in high command bar.html 7/11/2010 .arma2. Example: player hasWeapon "M16" Category: OFP hcAllGroups unit Operand types: unit: Object Compatibility: Version 5501 required. Type of returned value: Array Description: Returns selected groups in high command.

Type of returned value: Object Description: Returns group's HC commander. Example: hcLeader group Category: OFP hcRemoveAllGroups unit Operand types: unit: Object Compatibility: Version 5501 required. Type of returned value: Nothing Description: Removes group from unit's high command bar. Example: hcRemoveAllGroups unit Category: OFP unit hcRemoveGroup group Operand types: unit: Object group: Group Compatibility: Version 5501 required.com/comref/full.html 7/11/2010 . Type of returned value: Nothing Description: Remove all groups from unit's high command bar.arma2.BIS Game Engine Scripting Commands Page 167 of 415 group: Group Compatibility: Version 5501 required. Example: unit HCRemoveGroup group Category: OFP hcSelected unit http://www.

com/comref/full.BIS Game Engine Scripting Commands Page 168 of 415 Operand types: unit: Object Compatibility: Version 5501 required. Type of returned value: Nothing Description: Add group to unit's high command bar. Array parameters are group. Example: array = hcSelected unit Category: OFP unit hcSelectGroup array Operand types: unit: Object array: Array Compatibility: Version 5501 required. group name and team (teammain.html 7/11/2010 . Type of returned value: Array Description: Returns selected groups in high command. Group is the only necessary parameter.arma2."HQ". teamgreen. teamred. Example: unit hcSelectGroup [group. teamyellow) ."teamred"] or player hcSetGroup [group] Category: OFP http://www.true] Category: OFP unit hcSetGroup array Operand types: unit: Object array: Array Compatibility: Version 5501 required. Example: unit hcSetGroup [group. teamblue. Type of returned value: Nothing Description: Select given group in HC bar.

There must be some groups under hc command to show hc bar. Example: hideBody player Category: OFP hint text Operand types: text: Text or String Type of returned value: http://www. Type of returned value: Nothing Description: Shows or hides HC bar.arma2.html 7/11/2010 . Category: OFP hideBody person Operand types: person: Object Compatibility: Version 2.com/comref/full.BIS Game Engine Scripting Commands Page 169 of 415 hcShowBar bool Operand types: bool: Boolean Compatibility: Version 5501 required.10 required. Type of returned value: Nothing Description: Hides the body of the given person. Example: hcShowBar true Category: OFP hcShownBar Compatibility: Version 5501 required. Type of returned value: Boolean Description: Return a list of all groups.

Type of returned value: Nothing Description: http://www.01 required. Example: hint "Press W to move forward" Category: OFP hintC text Operand types: text: String Type of returned value: Nothing Description: Shows a text hint. The text can contain several lines.arma2. This hint has to be confirmed. Type of returned value: Nothing Description: Creates a hint dialog with the given title and text. The text can contain several lines. \n is used to indicate the end of a line. Category: OFP title hintC text Operand types: title: String text: String Compatibility: Version 2. Example: hintC "Press W to move forward" Category: OFP title hintC text Operand types: title: String text: Structured text Compatibility: Version 2.com/comref/full.01 required.BIS Game Engine Scripting Commands Page 170 of 415 Nothing Description: Shows a text hint.html 7/11/2010 . \n is used to indicate the end of a line.

. but without a sound.] Operand types: title: String [text1.. text2. Category: OFP hintCadet text Operand types: text: Text or String Type of returned value: Nothing Description: Shows a text hint only when using cadet mode.. .. text2. Category: OFP http://www. Texts can be plain or structured. Type of returned value: Nothing Description: Creates a hint dialog with the given title and text.BIS Game Engine Scripting Commands Page 171 of 415 Creates a hint dialog with the given title and text..]: Array Compatibility: Version 2. Category: OFP title hintC [text1. \n is used to indicate the end of a line. The text can contain several lines.arma2.com/comref/full. Type of returned value: Nothing Description: Same as hint. Example: hintCadet "Press W to move forward" Category: OFP hintSilent text Operand types: text: Text or String Compatibility: Version 5501 required.01 required.html 7/11/2010 .

85 required. Example: if (a>b) then {a=b} Category: Default image filename Operand types: filename: String Compatibility: Version 2.01 required. Type of returned value: Structured text Description: Creates a structured text containing the given image.com/comref/full. Type of returned value: If Type Description: The first part of the if command. Type of returned value: Nothing Description: Load HTML from file to given control.53 required.paa" Category: OFP http://www. Example: txt1 = image "data\isniper.arma2.html 7/11/2010 .html" Category: OFP PC if condition Operand types: condition: Boolean Compatibility: Version 1. Example: _control htmlLoad "briefing.BIS Game Engine Scripting Commands Page 172 of 415 control htmlLoad filename Operand types: control: Control filename: String Compatibility: Version 2.

http://www. Example: 1 in [0. result is true Category: Default position in location Operand types: position: Array location: Location Compatibility: Version 2.BIS Game Engine Scripting Commands Page 173 of 415 importAllGroups map Operand types: map: Control Compatibility: Version 2. Type of returned value: Nothing Description: Imports all groups into the RTE. Category: Location x in array Operand types: x: Any array: Array Type of returned value: Boolean Description: Checks whether x is equal to any element in the array. 2] . 1. Type of returned value: Number Description: Return importance of given location.com/comref/full. Category: Editor importance location Operand types: location: Location Compatibility: Version 2.92 required.90 required.92 required.html 7/11/2010 .arma2.

Type of returned value: Boolean Description: Check if fireplace is inflamed (buring).arma2.com/comref/full.BIS Game Engine Scripting Commands Page 174 of 415 Type of returned value: Boolean Description: Check if the position is inside area defined by the location.04 required. Example: player in jeepOne Category: OFP fireplace inflame burn Operand types: fireplace: Object burn: Boolean Type of returned value: Nothing Description: Controls fireplace buring. http://www. Category: Location soldier in vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Boolean Description: Checks whether the soldier is mounted in the vehicle.html 7/11/2010 . Set to true to inflame the fireplace. Example: fireplaceOne inflame true Category: OFP inflamed fireplace Operand types: fireplace: Object Compatibility: Version 1.

function]: Array Compatibility: Version 2.arma2.91 required. Category: OFP inheritsFrom config Operand types: config: Config Compatibility: Version 2.92 required. Type of returned value: Config Description: Returns base entry of config entry.html 7/11/2010 . function] Operand types: [handler name.BIS Game Engine Scripting Commands Page 175 of 415 Example: inflamed fireplaceOne Category: OFP inGameUISetEventHandler [handler name.90 required. Category: OFP inputAction name http://www. Example: _base = inheritsFrom (configFile >> "CfgVehicles" >> "Car") Category: OFP PC initAmbientLife Compatibility: Version 2. Type of returned value: Nothing Description: Sets given event handler of in-game UI.com/comref/full. Type of returned value: Nothing Description: Initialize the ambient life.

Example: [tank.. "VIEW" intersect [[1500. Type of returned value: Array Description: Find named selection in object which is in specified lod intersected by given section of a line. value. subtype class] Operand types: map: Control [type. lod name]: Array [begin. value1. end] Operand types: [object. Returns the ID of the new EditorObject. end]: Array Compatibility: Version 2... Type of returned value: String Description: Insert an object to the editor and assign arguments.com/comref/full. Type of returned value: Number Description: Return the state of input devices mapped to given input action (see CfgDefaultKeysMapping for action names). value1.53 required. 2]] Category: OFP isArray config Operand types: config: Config http://www.]. 2]. Create script is not called. lod name] intersect [begin.arma2.BIS Game Engine Scripting Commands Page 176 of 415 Operand types: name: String Compatibility: Version 5500 required. Category: Editor [object. value.92 required. Category: OFP map insertEditorObject [type. .]. subtype class]: Array Compatibility: Version 2. Subtype class is optional. 1500. 1500. [name1.. .html 7/11/2010 . [1550. [name1.

BIS Game Engine Scripting Commands Page 177 of 415 Compatibility: Version 2.90 required. result is true Category: OFP PC isDedicated Compatibility: Version 5501 required.arma2. Category: OFP isEngineOn vehicle Operand types: vehicle: Object Compatibility: Version 1. Type of returned value: Boolean Description: Return true for dedicated server. result is false Category: OFP PC isClass config Operand types: config: Config Compatibility: Version 2. Type of returned value: Boolean Description: Check if config entry represents config class. Type of returned value: Boolean Description: http://www.html 7/11/2010 .35 required.35 required. Example: _ok = isArray (configFile >> "CfgVehicles") . Example: _ok = isClass (configFile >> "CfgVehicles") . Type of returned value: Boolean Description: Check if config entry represents array.com/comref/full.

bool onShore.float gradientRadius. Example: on = isEngineOn vehicle player Category: OFP position isFlatEmpty [float minDistance.5.float onWater.float precizePos. 0. 0.92 required.html 7/11/2010 . Type of returned value: Array Description: Chek if given area is flat and emty. player) Category: OFP isFormationLeader person Operand types: person: Object Compatibility: Version 2.float precizePos. Type of returned value: Boolean Description: Returns true if the specified person is subgroup leader.object skipobj]: Array Compatibility: Version 5501 required.float onWater.object skipobj] Operand types: position: Array [float minDistance. 0.com/comref/full.92 required.float maxGradient. false. Type of returned value: Boolean Description: http://www. Category: OFP isHidden person Operand types: person: Object Compatibility: Version 2.BIS Game Engine Scripting Commands Page 178 of 415 Checks whether the engine is on.arma2.float maxGradient. Example: newposition = position isFlatEmpty(10.bool onShore. 5.float gradientRadius.

arma2.html 7/11/2010 . Example: ok = isKeyActive "M04" Category: OFP object isKindOf typeName Operand types: object: Object typeName: String Compatibility: Version 2. Type of returned value: Boolean Description: Checks whether the object is of the given type.BIS Game Engine Scripting Commands Page 179 of 415 Return whether the person is hidden (reached the hiding position). Category: OFP isKeyActive keyName Operand types: keyName: String Compatibility: Version 2.30 required. Type of returned value: Boolean Description: Checks whether the given key is active in the current user profile. Example: vehicle player isKindOf "Tank" Category: OFP typeName1 isKindOf typeName2 Operand types: typeName1: String typeName2: String Compatibility: Version 5160 required. http://www. Type of returned value: Boolean Description: Checks whether the type typeName1 is inherited from the type typeName1.com/comref/full.06 required.

Type of returned value: Boolean Description: Return true if multiPlayer.html 7/11/2010 . The function returns true if the variable is null and false if it's not. Type of returned value: Boolean Description: Tests whether the variable is null. Type of returned value: Boolean Description: Checks whether the object is marked for weapons collection. result is true Category: OFP isMarkedForCollection object Operand types: object: Object Compatibility: Version 2.00 required.BIS Game Engine Scripting Commands Page 180 of 415 Example: "Tank" isKindOf "Land" . Example: marked = isMarkedForCollection truck Category: OFP isMultiplayer Compatibility: Version 5501 required.13 required.com/comref/full.arma2. Example: if (isNil("_pokus")) then {_pokus=0. Category: OFP isNil variable Operand types: variable: Compatibility: Version 2.} http://www.

Type of returned value: Boolean Description: Check whether the value is null. Note: a==GrpNull does not work. Note: a==controlNull does not work.BIS Game Engine Scripting Commands Page 181 of 415 Category: Default isNull location Operand types: location: Location Compatibility: Version 5501 required.html 7/11/2010 . even to itself. because grpNull is not equal to anything. Category: Location isNull control Operand types: control: Control Compatibility: Version 2. Type of returned value: Boolean Description: Checks whether the value is equal to controlNull.arma2. result is true Category: OFP PC isNull grp Operand types: grp: Group Type of returned value: Boolean Description: Checks whether the value is equal to grpNull. Example: isNull group player .92 required.com/comref/full. Example: isNull controlNull . result is false Category: OFP http://www. because controlNull is not equal to anything. even to itself.

Example: isNull objNull . because objNull is not equal to anything. Example: isNull taskNull .com/comref/full. even to itself.html 7/11/2010 . Type of returned value: Boolean Description: Checks whether the value is equal to taskNull. even to itself.BIS Game Engine Scripting Commands Page 182 of 415 isNull task Operand types: task: Task Compatibility: Version 5160 required. because displayNull is not equal to anything.arma2. Example: isNull displayNull . Note: a==displayNull does not work. result is true Category: OFP PC isNull obj Operand types: obj: Object Type of returned value: Boolean Description: Checks whether the value is equal to objNull. Note: a==ObjNull does not work.92 required. result is true Category: Identity isNull display Operand types: display: Display Compatibility: Version 2. because taskNull is not equal to anything. Type of returned value: Boolean Description: Checks whether the value is equal to displayNull. even to itself. result is true Category: OFP http://www. Note: a==TaskNull does not work.

35 required.arma2. Type of returned value: Boolean Description: Check if config entry represents number.BIS Game Engine Scripting Commands Page 183 of 415 isNumber config Operand types: config: Config Compatibility: Version 2.com/comref/full.html 7/11/2010 . result is false Category: OFP PC isOnRoad position or object Operand types: position or object: Object or Array Compatibility: Version 5501 required. Type of returned value: Boolean Description: Check whether given position is on road. Example: _ok = isNumber (configFile >> "CfgVehicles") .92 required. http://www. Category: OFP isRealTime map Operand types: map: Control Compatibility: Version 2. Category: OFP isPlayer person Operand types: person: Object Compatibility: Version 2.92 required. Type of returned value: Boolean Description: Check if given person is the player.

Category: OFP isShowing3DIcons map Operand types: map: Control Compatibility: Version 2.arma2. Example: _ok = isText (configFile >> "CfgVehicles") . result is false http://www.92 required.html 7/11/2010 . Type of returned value: Boolean Description: Check if config entry represents text.35 required. Type of returned value: Boolean Description: Returns true if the editor is set to draw 3D icons. Type of returned value: Boolean Description: Returns true if the computer is the server.92 required.com/comref/full. Example: _isRealTime = isRealTime _map Category: Editor isServer Compatibility: Version 2. Category: Editor isText config Operand types: config: Config Compatibility: Version 2.BIS Game Engine Scripting Commands Page 184 of 415 Type of returned value: Boolean Description: Returns true if the mission editor is operating in real time mode.

com/comref/full. Example: items player Category: OFP unitArray join group Operand types: unitArray: Array group: Object or Group Type of returned value: Nothing Description: Joins all units in the array to the given group.BIS Game Engine Scripting Commands Page 185 of 415 Category: OFP PC items unit Operand types: unit: Object Compatibility: Version 5501 required.arma2. 4] Category: OFP http://www. Example: [unitOne. Note: This function is unsupported in MP in version 1. id] Operand types: unit: Object [group. unitTwo] join player Category: OFP unit joinAs [group. if position id is available. Note: the total number of group members cannot exceed 12.33 and before. id]: Array Type of returned value: Nothing Description: Joins the unit to the given group. Example: player joinAs [_group.html 7/11/2010 . Type of returned value: Array Description: Returns an array of names of all special items of the vehicle. this one is used.

Example: player joinAsSilent [_group.arma2. id] Operand types: unit: Object [group. unitTwo] joinSilent player Category: OFP person kbAddDatabase filename Operand types: person: Object filename: String Compatibility: Version 2. this one is used. id]: Array Type of returned value: Nothing Description: Joins the unit to the given group. 4] Category: OFP unitArray joinSilent group Operand types: unitArray: Array group: Object or Group Type of returned value: Nothing Description: Joins all units in the array to the given group. Type of returned value: Boolean Description: Register knowledge base database to given person. if position id is available. Avoid any radio communication related to joining.html 7/11/2010 .com/comref/full.BIS Game Engine Scripting Commands Page 186 of 415 unit joinAsSilent [group.42 required. Example: [unitOne. Example: _unit kbAddDatabase "chat.txt" Category: OFP PC http://www. Avoid any radio communication related to joining.

.html 7/11/2010 . task type(. filename(. Type of returned value: Boolean Description: Check if conversation topic was registered to given person.92 required.45 required.txt" Category: OFP PC person kbAddTopic [name. Example: _unit kbAddDatabase "chat. argument speech]. filename(.] http://www.arma2.com/comref/full. Type of returned value: Boolean Description: Register target list knowledge base database to given person. Category: OFP PC person kbReact [receiver.. . [argument name. player event handler))] Operand types: person: Object [name. task type(. Type of returned value: Nothing Description: Register conversation topic to given person. argument value. topic. player event handler))]: Array Compatibility: Version 2.BIS Game Engine Scripting Commands Page 187 of 415 person kbAddDatabaseTargets filename Operand types: person: Object filename: String Compatibility: Version 2. Category: OFP PC person kbHasTopic name Operand types: person: Object name: String Compatibility: Version 2. argument text. sentence id.92 required.

] Operand types: person: Object [receiver.. ..92 required.. Type of returned value: Nothing Description: Make the person tell to the receiver the sentence. . [argument name. . argument value. argument value. Category: OFP PC person kbTell [receiver. max. sentence id.com/comref/full. topic. Category: OFP PC person kbRemoveTopic name Operand types: person: Object name: String Compatibility: Version 2. topic. sentence id. sentence id.. argument speech]. sentence id. argument text.92 required. topic. argument speech].. argument speech]. sentence id. argument value. age] Operand types: person: Object [receiver.. topic.]: Array Compatibility: Version 2. Type of returned value: Nothing Description: Pass a non-verbal communication to the receiver.html 7/11/2010 . max. topic. [argument name. Category: OFP PC person kbWasSaid [receiver. Type of returned value: Nothing Description: Unregister conversation topic from given person.]: Array Compatibility: Version 5500 required. argument text.arma2. [argument name. age]: Array http://www.BIS Game Engine Scripting Commands Page 188 of 415 Operand types: person: Object [receiver. argument text.

BIS Game Engine Scripting Commands Page 189 of 415 Compatibility: Version 5500 required. Example: name = keyName 28 .html 7/11/2010 . Category: OFP PC keyImage dikCode Operand types: dikCode: Number Compatibility: Version 2. mouse or joystick) with the given code.01 required. result is "Enter" Category: OFP keyName dikCode Operand types: dikCode: Number Compatibility: Version 2. Type of returned value: Boolean Description: Check if given item was said by person to someone.com/comref/full. containing an image or name (if no image is found) of the button (on the keyboard. Type of returned value: String Description: Returns the name of a button (on the keyboard. Type of returned value: Structured text Description: Returns a structured text. mouse or joystick) with the given code.arma2. Example: name = keyImage 28 . result is "Enter" Category: OFP unit knowsAbout target Operand types: unit: Object or Group target: Object Type of returned value: http://www.01 required.

arma2.html 7/11/2010 . Example: cobraOne land "LAND" Category: OFP airplane landAt airportId Operand types: airplane: Object http://www. If the unit is a vehicle. "GET OUT" (hovering low for another unit to get out) or "NONE" (cancel landing). Type of returned value: Number Description: Checks whether the side knows about the target (and how much). Example: east knowsAbout jeepOne Category: OFP helicopter land mode Operand types: helicopter: Object mode: String Type of returned value: Nothing Description: Forces a helicopter landing. the vehicle commander is considered instead.BIS Game Engine Scripting Commands Page 190 of 415 Number Description: Checks whether the unit knows about the target (and how much).com/comref/full. The landing mode may be "LAND" (a complete stop). "GET IN" (hovering very low for another unit to get in). Example: soldierOne knowsAbout jeepOne Category: OFP side knowsAbout target Operand types: side: Side target: Object Compatibility: Version 5501 required.

BIS Game Engine Scripting Commands Page 191 of 415 airportId: Number Compatibility: Version 2. Type of returned value: String Description: Return the result of helicopter landing position searching (performed after land command). "NotFound" (position not found). Type of returned value: Nothing Description: Order AI airplane to land at given airport Example: plane landAt 0 Category: OFP landResult helicopter Operand types: helicopter: Object Compatibility: Version 5501 required.html 7/11/2010 . It returns the index of the newly added item. Category: OFP lbAdd [idc. Type of returned value: Number Description: Adds an item with the given text to the listbox or combobox with id idc of the topmost user dialog.arma2.92 required. text] Operand types: [idc.com/comref/full. Example: _index = lbAdd [101. "NotReady" (position searching is still in progress) or empty string when wrong argument given. "First item"] Category: Resistance control lbAdd text Operand types: http://www. The value can be "Found" (position found).50 required. text]: Array Compatibility: Version 1.

It returns the index of the newly added item. Example: _index = _control lbAdd "First item" Category: OFP PC lbClear idc Operand types: idc: Number Compatibility: Version 1.91 required. Type of returned value: Number Description: Adds an item with the given text to the given listbox or combobox.91 required.html 7/11/2010 .BIS Game Engine Scripting Commands Page 192 of 415 control: Control text: String Compatibility: Version 2. Type of returned value: Nothing Description: Clears all items in the listbox or combobox with id idc of the topmost user dialog.com/comref/full. Example: lbClear _control Category: OFP PC lbColor [idc. index] http://www. Type of returned value: Nothing Description: Clears all items in the given listbox or combobox. Example: lbClear 101 Category: Resistance lbClear control Operand types: control: Control Compatibility: Version 2.arma2.50 required.

The color is returned in format Color.html 7/11/2010 . Type of returned value: Array Description: Returns the text color of the item with the given index of the listbox or combobox with id idc of the topmost user dialog. Example: _color = lbColor [101. 0] Category: Resistance control lbColor index Operand types: control: Control index: Number Compatibility: Version 2. Type of returned value: Array Description: Returns the text color of the item with the given index of the given listbox or combobox.50 required.91 required. Example: _index = lbCurSel 101 Category: Resistance http://www. Example: _color = _control lbColor 0 Category: OFP PC lbCurSel idc Operand types: idc: Number Compatibility: Version 1.com/comref/full. Type of returned value: Number Description: Returns the index of the selected item of the listbox or combobox with id idc of the topmost user dialog. index]: Array Compatibility: Version 1.BIS Game Engine Scripting Commands Page 193 of 415 Operand types: [idc.50 required.arma2.

com/comref/full. Example: _data = lbData [101.arma2.BIS Game Engine Scripting Commands Page 194 of 415 lbCurSel control Operand types: control: Control Compatibility: Version 2. index] Operand types: [idc.html 7/11/2010 .50 required. Type of returned value: String Description: Returns the additional text (invisible) in an item with the given index of the given listbox or combobox. Example: _index = lbCurSel _control Category: OFP PC lbData [idc.91 required. 0] Category: Resistance control lbData index Operand types: control: Control index: Number Compatibility: Version 2. index]: Array Compatibility: Version 1. Example: _data = _control lbData 0 Category: OFP PC http://www. Type of returned value: String Description: Returns the additional text (invisible) in an item with the given index of the listbox or combobox with id idc of the topmost user dialog. Type of returned value: Number Description: Returns the index of the selected item of the given listbox or combobox.91 required.

BIS Game Engine Scripting Commands Page 195 of 415 lbDelete [idc. Type of returned value: Nothing Description: Removes the item with the given index from the listbox or combobox with id idc of the topmost user dialog.html 7/11/2010 . Example: lbDelete [101. index] Operand types: [idc. Example: _control lbDelete 0 Category: OFP PC control lbIsSelected index Operand types: control: Control index: Number Compatibility: Version 2. index]: Array Compatibility: Version 1. Type of returned value: Nothing Description: Removes the item with the given index from the given listbox or combobox. Type of returned value: Boolean Description: Check whether given row of the given listbox is selected. 0] Category: Resistance control lbDelete index Operand types: control: Control index: Number Compatibility: Version 2.92 required. Example: _selected = _control lbIsSelected 0 http://www.arma2.50 required.91 required.com/comref/full.

html 7/11/2010 . 0] Category: Resistance control lbPicture index Operand types: control: Control index: Number Compatibility: Version 2.BIS Game Engine Scripting Commands Page 196 of 415 Category: OFP PC lbPicture [idc.arma2.com/comref/full.92 required. Example: http://www. Example: _picture = lbPicture [101.50 required. index]: Array Compatibility: Version 1. Type of returned value: Array Description: Returns the array of selected rows indices in the given listbox.91 required. Type of returned value: String Description: Returns the picture name of the item with the given index of the given listbox or combobox. Type of returned value: String Description: Returns the picture name of the item with the given index of the listbox or combobox with id idc of the topmost user dialog. index] Operand types: [idc. Example: _picture = _control lbPicture 0 Category: OFP PC lbSelection control Operand types: control: Control Compatibility: Version 2.

arma2.91 required. 0.5]] Category: OFP PC lbSetCurSel [idc.BIS Game Engine Scripting Commands Page 197 of 415 _indices = lbSelection _control Category: OFP PC lbSetColor [idc. 0. Example: _control lbSetColor [0. index]: Array Compatibility: Version 1. 0.50 required. color]: Array Compatibility: Version 2. index. [0. color] Operand types: control: Control [index. Color is in format Color. Color is in format Color. 1.50 required.com/comref/full. Example: lbSetColor [101.5]] Category: Resistance control lbSetColor [index. Type of returned value: Nothing Description: http://www. 0.html 7/11/2010 . 0. Type of returned value: Nothing Description: Sets the color of the item with the given index of the listbox or combobox with id idc of the topmost user dialog to the given color. color]: Array Compatibility: Version 1. Type of returned value: Nothing Description: Sets the text color of the item with the given index of the given listbox or combobox. [0. 1. color] Operand types: [idc. index. index] Operand types: [idc.

1. data]: Array Compatibility: http://www.BIS Game Engine Scripting Commands Page 198 of 415 Selects the item with the given index of the listbox or combobox with id idc of the topmost user dialog. index. data] Operand types: control: Control [index.html 7/11/2010 .91 required. Example: _control lbSetCurSel 0 Category: OFP PC lbSetData [idc. Example: lbSetCurSel [101. data]: Array Compatibility: Version 1. index. 0] Category: Resistance control lbSetCurSel index Operand types: control: Control index: Number Compatibility: Version 2.com/comref/full.arma2. data] Operand types: [idc. "#1"] Category: Resistance control lbSetData [index. Example: lbSetData [101.50 required. Type of returned value: Nothing Description: Sets the additional text (invisible) in the item with the given index of the listbox or combobox with id idc of the topmost user dialog to the given data. Type of returned value: Nothing Description: Selects the item with the given index of the given listbox or combobox.

name]: Array Compatibility: Version 2. Name is the picture name. index.91 required. The picture is searched in the mission directory. 0. "#1"] Category: OFP PC lbSetPicture [idc. Name is the picture name. index.arma2. name]: Array Compatibility: Version 1. "iskoda"] Category: Resistance control lbSetPicture [index. "iskoda"] Category: OFP PC http://www. Type of returned value: Nothing Description: Sets the picture in the item with the given index of the given listbox or combobox.91 required. Example: _control lbSetPicture [0.com/comref/full. Type of returned value: Nothing Description: Sets the picture in the item with the given index of the listbox or combobox with id idc of the topmost user dialog. name] Operand types: [idc. Example: _control lbSetData [1.BIS Game Engine Scripting Commands Page 199 of 415 Version 2. the dtaExt subdirectory of the campaign directory and the dtaExt directory and the data bank (or directory). The picture is searched in the mission directory. name] Operand types: control: Control [index. the dtaExt subdirectory of the campaign directory and the dtaExt directory and the data bank (or directory).50 required. Example: lbSetPicture [101.html 7/11/2010 . Type of returned value: Nothing Description: Sets the additional text (invisible) in the item with the given index of the given listbox or combobox to the given data.

value]: Array Compatibility: Version 2. selected]: Array Compatibility: Version 5501 required. Example: lbSetValue [101.50 required. Type of returned value: Nothing Description: Set the selection state of the given row of the given listbox. 1] http://www. selected] Operand types: control: Control [index. index.com/comref/full. value] Operand types: [idc. Listbox must support multiple selection Example: _control lbSetSelection [0. true] Category: OFP PC lbSetValue [idc.91 required. 1] Category: Resistance control lbSetValue [index. Example: _control lbSetValue [0. value] Operand types: control: Control [index. value]: Array Compatibility: Version 1. Type of returned value: Nothing Description: Sets the additional integer value in the item with the given index of the listbox or combobox with id idc of the topmost user dialog to the given value.arma2. Type of returned value: Nothing Description: Sets the additional integer value in the item with the given index of the given listbox or combobox to the given value. index.BIS Game Engine Scripting Commands Page 200 of 415 control lbSetSelected [index.html 7/11/2010 . 0.

50 required. Example: _n = lbSize _control Category: OFP PC lbSize idc Operand types: idc: Number Compatibility: Version 1. Type of returned value: Number Description: Returns the number of items in the listbox or combobox with id idc of the topmost user dialog.html 7/11/2010 .arma2. Example: _n = lbSize 101 Category: Resistance lbSort control Operand types: control: Control Compatibility: Version 5148 required. Type of returned value: Number Description: Returns the number of items in the given listbox or combobox.com/comref/full.BIS Game Engine Scripting Commands Page 201 of 415 Category: OFP PC lbSize control Operand types: control: Control Compatibility: Version 2.91 required. Type of returned value: Number Description: Sorts the given listbox or combobox by item text. Example: lbSort _control http://www.

index] Operand types: [idc. Example: _text = lbText [101. Type of returned value: String Description: Returns the shown text in the item with the given index of the listbox or combobox with id idc of the topmost user dialog.com/comref/full.arma2.BIS Game Engine Scripting Commands Page 202 of 415 Category: OFP PC lbSortByValue control Operand types: control: Control Compatibility: Version 5148 required. Example: lbSortByValue _control Category: OFP PC lbText [idc. Type of returned value: Number Description: Sorts the given listbox or combobox by item value.html 7/11/2010 . Type of returned value: String Description: Returns the shown text in the item with the given index of the given listbox or combobox. 0] Category: Resistance control lbText index Operand types: control: Control index: Number Compatibility: Version 2.50 required.91 required. index]: Array Compatibility: Version 1. Example: http://www.

91 required. objNull is returned. Type of returned value: Number Description: Returns the additional integer value in the item with the given index of the given listbox or combobox.50 required. index] Operand types: [idc. Example: _value = _control lbValue 0 Category: OFP PC leader unit Operand types: unit: Object Type of returned value: Object Description: Returns the group leader for the given unit.html 7/11/2010 .com/comref/full. For dead units. http://www. Example: _value = lbValue [101.BIS Game Engine Scripting Commands Page 203 of 415 _text = _control lbText 0 Category: OFP PC lbValue [idc. 0] Category: Resistance control lbValue index Operand types: control: Control index: Number Compatibility: Version 2.arma2. index]: Array Compatibility: Version 1. Type of returned value: Number Description: Returns the additional integer value in the item with the given index of the listbox or combobox with id idc of the topmost user dialog.

BIS Game Engine Scripting Commands Page 204 of 415 Example: leader player Category: OFP leader grp Operand types: grp: Group Type of returned value: Object Description: Returns the group leader for the given group.com/comref/full. It unassigns all grouped units from the vehicle.arma2. For a dead unit. Example: leader group player == leader player Category: OFP group leaveVehicle vehicle Operand types: group: Object vehicle: Object Type of returned value: Nothing Description: Ceases the using of the vehicle in the group. It unassigns all grouped units from the vehicle. Example: soldierOne leaveVehicle jeepOne Category: OFP group leaveVehicle vehicle Operand types: group: Group vehicle: Object Type of returned value: Nothing Description: Ceases the using of the vehicle in the group. grpNull is returned.html 7/11/2010 . Example: groupOne leaveVehicle jeepOne Category: OFP http://www.

Type of returned value: Nothing Description: Attach light to given object (at given position).arma2. Type of returned value: Nothing Description: Detach light from object. position]: Array Compatibility: Version 2. position] Operand types: light: Object [object.58 required.58 required. http://www.com/comref/full. Type of returned value: String Description: Returns the life state of the given unit. Category: OFP lightDetachObject light Operand types: light: Object Compatibility: Version 2.BIS Game Engine Scripting Commands Page 205 of 415 lifeState unit Operand types: unit: Object Compatibility: Version 5501 required.04 required. Category: OFP light lightAttachObject [object.html 7/11/2010 . Category: OFP lightIsOn lamppost Operand types: lamppost: Object Compatibility: Version 1.

For a trigger of type "Not present" the list is the same as the list that would be returned for type "Present". http://www. "StreetLamp"] != "OFF" Category: OFP object limitSpeed speed Operand types: object: Object speed: Number Compatibility: Version 2.com/comref/full.01 required. Possible values are "ON". Example: lightIsOn nearestObject [player.html 7/11/2010 . Type of returned value: Nothing Description: Limit speed of given vehicle to given value (in km/h). Type of returned value: Structured text Description: Creates a structured text containing a line break. "OFF" and "AUTO" (auto means the lamp will be shining during the night automatically).arma2.92 required. Category: OFP lineBreak Compatibility: Version 2. Example: txt3 = lineBreak Category: OFP list trigger Operand types: trigger: Object Type of returned value: Array Description: Returns a list of units that would activate the given trigger.BIS Game Engine Scripting Commands Page 206 of 415 Type of returned value: String Description: Checks whether the lampost is turned on.

[[text.... http://www. [value.....html 7/11/2010 .text].].. [value.. Example: ln 10 .]]. Type of returned value: Array Description: Return the list of all objects of given type.[[[text.[[[]]. [value.]].com/comref/full..text].]] Operand types: [IDC. Type of returned value: Number Description: Adds list of rows of strings.BIS Game Engine Scripting Commands Page 207 of 415 Example: list triggerOne Category: OFP map listObjects type Operand types: map: Control type: String Compatibility: Version 2.].]]. [data.. Returns row index.[[]]]] .[[[text. [data. result is 2. [data..text].].92 required.arma2..]]: Array Compatibility: Version 5501 required. [data. Category: Editor ln x Operand types: x: Number Type of returned value: Number Description: The natural logarithm of x.. [[text.. Example: _index = lnbAddRow [idc.].text].]]. [value.302 Category: Default lnbAddArray [IDC..

. position] Operand types: [idc.]] Operand types: [idc.8] Category: Resistance control lnbAddColumn position Operand types: control: Control position: Number Compatibility: Version 5501 required. 0. It returns the index of the newly added item. Type of returned value: Number Description: Adds an row of strings.com/comref/full. text. Example: http://www. Example: _index = lnbAddColumn [105. [text...]]: Array Compatibility: Version 5501 required. [text.arma2..BIS Game Engine Scripting Commands Page 208 of 415 Category: Resistance lnbAddColumn [idc.. It returns the index of the newly added column.. Type of returned value: Number Description: Adds an column at given position. Type of returned value: Number Description: Adds an item with the given text to the given listbox or combobox.50 required. Example: _index = _control lbAdd "First item" Category: OFP PC lnbAddRow [idc. text. position]: Array Compatibility: Version 1.html 7/11/2010 .

It returns the index of the newly added row.] Category: OFP PC lnbClear idc Operand types: idc: Number Compatibility: Version 5501 required.text2..] Operand types: control: Control [text1. Example: _index = _control lnbAdd [t1.BIS Game Engine Scripting Commands Page 209 of 415 _index = lnbAddRow [105.com/comref/full...t3.. Example: lnbClear 101 Category: Resistance lnbClear control Operand types: control: Control Compatibility: Version 2. Type of returned value: Number Description: Adds an row to the end od 2d listbox .. ["First column".. Category: Resistance control lnbAddRow [text1. Returns row index.html 7/11/2010 ..t2.arma2. Type of returned value: Nothing Description: Clears all items in the 2D listbox... "second column"..]].]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Clears all items in the given listbox or combobox. . http://www.91 required..text2.

[0. Type of returned value: Array Description: Returns the text color of the item with the given position of the 2D listbox. column]: Array Compatibility: Version 5501 required.html 7/11/2010 . [row. column] Category: OFP PC lnbCurSelRow control Operand types: control: Control Compatibility: Version 2.91 required. Type of returned value: Number Description: http://www. [row. column]: Array Compatibility: Version 5501 required. Example: _color = lnbColor [101. column] Operand types: control: Control [row. column] Operand types: [idc. Example: _color = _control lnbColor [row.1]] Category: Resistance control lnbColor [row.arma2.BIS Game Engine Scripting Commands Page 210 of 415 Example: lbClear _control Category: OFP PC lnbColor [idc. Type of returned value: Array Description: Returns the text color of the item with the given position of the given 2D listbox.com/comref/full. The color is returned in format Color.

1]] Category: Resistance control lnbData [row. Type of returned value: String Description: Returns the additional text (invisible) in an item with the given position of the 2D listbox. column] Operand types: control: Control [row. Example: _index = lbCurSel _control Category: OFP PC lnbCurSelRow idc Operand types: idc: Number Compatibility: Version 5501 required. Type of returned value: String http://www. [row.BIS Game Engine Scripting Commands Page 211 of 415 Returns the index of the selected item of the given listbox or combobox. Example: _data = lnbData [101. column]: Array Compatibility: Version 5501 required.com/comref/full. column] Operand types: [idc.html 7/11/2010 . [row.arma2. Example: _row = lnbCurSel 105 Category: Resistance lnbData [idc. column]: Array Compatibility: Version 5501 required. [0. Type of returned value: Number Description: Returns the index of the selected row id 2D listbox.

html 7/11/2010 . Type of returned value: Nothing Description: Removes the item with the given index from the given listbox or combobox.com/comref/full. column] Category: OFP PC lnbDeleteColumn [idc. Type of returned value: Nothing Description: Removes column with given index. index] Operand types: [idc. 0] Category: Resistance control lnbDeleteColumn index Operand types: control: Control index: Number Compatibility: Version 5501 required. index]: Array Compatibility: Version 1. Example: lnbDeleteColumn [101.BIS Game Engine Scripting Commands Page 212 of 415 Description: Returns the additional text (invisible) in an item with the given position of the given 2D listbox. index] Operand types: [idc. Example: _data = _control lnbData [row. index]: Array Compatibility: Version 5501 required.50 required. Type of returned value: http://www. Example: _control lbDelete 0 Category: OFP PC lnbDeleteRow [idc.arma2.

0] Category: Resistance control lnbDeleteRow row Operand types: control: Control row: Number Compatibility: Version 5501 required.com/comref/full.html 7/11/2010 .BIS Game Engine Scripting Commands Page 213 of 415 Nothing Description: Removes row with given index from the 2D listbox. http://www.arma2. Example: _index = lbCurSel _control Category: OFP PC lnbGetColumnsPosition idc Operand types: idc: Number Compatibility: Version 5501 required. Type of returned value: Nothing Description: Removes row with the given index from the given listbox or combobox. Type of returned value: Array Description: Returns the index of the selected item of the given listbox or combobox. Example: lnbDeleteRow [105. Example: _control lnbDelete 0 Category: OFP PC lnbGetColumnsPosition control Operand types: control: Control Compatibility: Version 2.91 required.

Example: _picture = lnbPicture [101. [row. [0.1]] Category: Resistance control lnbPicture [row.BIS Game Engine Scripting Commands Page 214 of 415 Type of returned value: Array Description: Returns the columns position in 2D listbox.arma2. [row. column] Operand types: [idc. color]: Array Compatibility: http://www. Type of returned value: String Description: Returns the picture name of the item with the given position of the given listbox or combobox. Type of returned value: String Description: Returns the picture name of the item with the given position of the 2D listbox.html 7/11/2010 . Example: _picture = _control lnbPicture [row.com/comref/full. column] Operand types: control: Control [row. color] Operand types: [idc. column]: Array Compatibility: Version 5501 required. column] Category: OFP PC lnbSetColor [idc. column]. column]: Array Compatibility: Version 5501 required. column]. Example: _n = lnbGetColumnsSize 105 Category: Resistance lnbPicture [idc. [row. [row.

1]. 1. color] Operand types: control: Control [[row. 0. Color is in format Color. column]. column]. data]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Sets the color of the item with the given position of the 2D listbox. column]. 0.pos2.] Operand types: http://www. Example: lnbSetColor [101. data] Operand types: [idc.com/comref/full. [0.. 1. [0. column]. Color is in format Color. 0. 0. [0. Example: lnbSetData [101.arma2... color]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Sets the additional text (invisible) in the item with the given position of the 2D listbox. [row. column].1].html 7/11/2010 . [0. "#1"] Category: Resistance control lnbSetColumnsPos [pos1.5]] Category: Resistance control lnbSetColor [[row. Type of returned value: Nothing Description: Sets the text color of the item with the given position of the given 2D listbox .5]] Category: OFP PC lnbsetColumnsPos [idc.BIS Game Engine Scripting Commands Page 215 of 415 Version 5501 required. Example: _control lnbSetColor [[row. [row.

column].]: Array Compatibility: Version 5501 required.pos2..arma2.html 7/11/2010 .com/comref/full. Example: _control lbSetColumnsPos [pos1. Example: _control lbSetCurSel row Category: OFP PC lnbSetData [idc. Example: lnbSetCurSel [105. Type of returned value: Nothing Description: Selects the row with the given index of the 2D listbox..BIS Game Engine Scripting Commands Page 216 of 415 control: Control [pos1.] Category: OFP PC lnbSetCurSelRow [idc. index] Operand types: [idc. data] http://www. index]: Array Compatibility: Version 5501 required.. Type of returned value: Nothing Description: Set position of 2d listbox columns. [row.pos2. Type of returned value: Nothing Description: Selects the item with the given index of the given listbox or combobox. 0] Category: Resistance control lnbSetCurSelRow row Operand types: control: Control row: Number Compatibility: Version 5501 required....

data]: Array Compatibility: Version 5501 required. Example: lnbSetData [101. "iskoda"] Category: Resistance http://www. "#1"] Category: Resistance control lnbSetData [[row. The picture is searched in the mission directory. [row.BIS Game Engine Scripting Commands Page 217 of 415 Operand types: [idc.html 7/11/2010 . column].com/comref/full. [row. [0. "#1"] Category: OFP PC lnbSetPicture [idc.arma2. [row. [0. Type of returned value: Nothing Description: Sets the additional text (invisible) in the item with the given position of the 2D listbox. Type of returned value: Nothing Description: Sets the picture in the item with the given position of the 2D listbox. Example: lnbSetPicture [101. column]. column].1]. column]. Type of returned value: Nothing Description: Sets the additional text (invisible) in the item with the given position of the given 2D listbox to the given data. column]. column]. data]: Array Compatibility: Version 5501 required. Name is the picture name.1]. name] Operand types: [idc. name]: Array Compatibility: Version 5501 required. data] Operand types: control: Control [[row. the dtaExt subdirectory of the campaign directory and the dtaExt directory and the data bank (or directory). Example: _control lnbSetData [[row.

"iskoda"] Category: OFP PC lnbSetText [idc. Name is the picture name. column]. name]: Array Compatibility: Version 5501 required.1]. column].arma2. data] Operand types: [idc. column]. [0. column]. [row. data]: Array Compatibility: Version 5501 required. column]. column]. Example: lnbSetData [101. name] Operand types: control: Control [[row. The picture is searched in the mission directory. Type of returned value: Nothing Description: Sets the additional text (invisible) in the item with the given position of the 2D listbox.html 7/11/2010 . text]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Sets the additional text (invisible) in the item with the given index of the given 2D listbox to the given data. [row. "#1"] http://www. column]. column]. the dtaExt subdirectory of the campaign directory and the dtaExt directory and the data bank (or directory). Example: _control lnbSetData [[row. "#1"] Category: Resistance control lnbSetText [[row. Type of returned value: Nothing Description: Sets the picture in the item with the given position of the given 2D listbox. text] Operand types: control: Control [[row.BIS Game Engine Scripting Commands Page 218 of 415 control lnbSetPicture [[row.com/comref/full. Example: _control lnbSetPicture [[row.

com/comref/full.arma2. [row.html 7/11/2010 . Type of returned value: Nothing Description: Sets the additional integer value in the item with the given position of the given 2D listbox to the given value. [0. 1] Category: OFP PC lnbSize idc Operand types: idc: Number Compatibility: Version 5501 required. value] Operand types: [idc. column]. column]. Example: _control lnbSetValue [[row. value] Operand types: control: Control [[row. column].1]. value]: Array Compatibility: Version 5501 required. [row.Y] size of 2D listbox.BIS Game Engine Scripting Commands Page 219 of 415 Category: OFP PC lnbSetValue [idc. column]. 1] Category: Resistance control lnbSetValue [[row. column]. Example: http://www. Example: lnbSetValue [101. value]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Sets the additional integer value in the item with the position index of the 2D listbox. Type of returned value: Array Description: Returns [X.

Type of returned value: String Description: Returns the shown text in the item with the given position of the 2D listbox.BIS Game Engine Scripting Commands Page 220 of 415 _n = lnbSize 105 Category: Resistance lnbSize control Operand types: control: Control Compatibility: Version 2. [row.50 required. column] Operand types: control: Control [row.arma2.html 7/11/2010 . column]] Operand types: [idc. [0. [row. column]]: Array Compatibility: Version 1. column]: Array Compatibility: Version 5501 required. Example: _text = lnbText [101. http://www.com/comref/full.91 required.1]] Category: Resistance control lnbText [row. Type of returned value: String Description: Returns the shown text in the item with the given position of the given 2D listbox. Type of returned value: Array Description: Returns the number of items in the given listbox or combobox. Example: _n = lbSize _control Category: OFP PC lnbText [idc.

Type of returned value: Number Description: Returns the additional integer value in the item with the given position of the 2D listbox. column] Operand types: control: Control [row. column] Operand types: [idc. [row. Type of returned value: Number Description: Returns the additional integer value in the item with the given position of the given 2D listbox. column] Category: OFP PC loadFile filename Operand types: filename: String Compatibility: Version 1. column]: Array Compatibility: Version 5501 required.com/comref/full.82 required. [0.html 7/11/2010 . http://www. Example: _value = lnbValue [101.BIS Game Engine Scripting Commands Page 221 of 415 Example: _text = _control lnbText [row. Type of returned value: String Description: Returns the content of the given file. [row.arma2. Example: _value = _control lnbValue [row. column]: Array Compatibility: Version 5501 required. column] Category: OFP PC lnbValue [idc.1]] Category: Resistance control lnbValue [row.

sav file in campaign directory (from entry name). Type of returned value: Boolean Description: Loads person's identity from objects. Category: OFP person loadIdentity name Operand types: person: Object name: String Compatibility: Version 1.html 7/11/2010 .arma2. Type of returned value: Nothing Description: Creates the load overlay dialog for the specified type of overlay. Type of returned value: Nothing Description: Load a game from the autosave. result is "if a>b then {a} else {b}" Category: OFP loadGame Compatibility: Version 5501 required. restart the mission.BIS Game Engine Scripting Commands Page 222 of 415 Example: loadFile "myFunction. if failed.75 required.com/comref/full.92 required.sqf" . Example: player loadIdentity "playerIdentity" Category: Resistance map loadOverlay config Operand types: map: Control config: Config Compatibility: Version 2. Category: Editor http://www.

Type of returned value: Boolean Description: Loads object's properties from objects.BIS Game Engine Scripting Commands Page 223 of 415 object loadStatus name Operand types: object: Object name: String Compatibility: Version 1. Note: all static objects are local on all computers. Example: local unitName Category: OFP localize stringName Operand types: stringName: String Type of returned value: String Description: Replaces the string with the given name with the corresponding localized text from the stringtable.html 7/11/2010 .75 required.arma2.sav file in campaign directory (from entry name).com/comref/full. In SP all objects are local. Example: player loadStatus "playerState" Category: Resistance local obj Operand types: obj: Object Type of returned value: Boolean Description: MP: checks whether the given unit is local on the computer.csv file. This can be used when one or more activation fields or scripts need to be performed only on one computer. Example: localize "STR_DN_FROG" Category: OFP http://www.

html 7/11/2010 . including itself.com/comref/full.arma2.90 required.BIS Game Engine Scripting Commands Page 224 of 415 locationNull Compatibility: Version 5501 required. Category: Location vehicle lock lock Operand types: vehicle: Object lock: Boolean Type of returned value: Nothing Description: Locks the vehicle (disables mounting / dismounting) for the player. Example: jeepOne lock true Category: OFP vehicle lockCargo lock Operand types: vehicle: Object lock: Boolean Compatibility: Version 5501 required. Category: Location locationPosition location Operand types: location: Location Compatibility: Version 2. Type of returned value: Nothing http://www. Type of returned value: Location Description: A non-existing location. This value is not equal to anything. Type of returned value: Array Description: Return position of given location.

If it's locked. the player cannot mount / dismount without an order. Type of returned value: Nothing Description: Lock the driver position of the vehicle. Example: locked jeepOne Category: OFP http://www. Category: OFP vehicle lockDriver lock Operand types: vehicle: Object lock: Boolean Compatibility: Version 5501 required. Category: OFP locked unit Operand types: unit: Object Type of returned value: Boolean Description: Checks whether the vehicle is locked for the player. Category: OFP vehicle lockCargo [cargo index. lock]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Lock the cargo position of the vehicle.BIS Game Engine Scripting Commands Page 225 of 415 Description: Lock the all cargo positions of the vehicle.com/comref/full. lock] Operand types: vehicle: Object [cargo index.html 7/11/2010 .arma2.

lock]: Array Compatibility: Version 5501 required. Type of returned value: Boolean Description: Check whether cargo position of the vehicle is locked. Category: OFP lockedDriver vehicle Operand types: vehicle: Object Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 226 of 415 vehicle lockedCargo cargo index Operand types: vehicle: Object cargo index: Number Compatibility: Version 5501 required. http://www.html 7/11/2010 . lock] Operand types: vehicle: Object [turret path.arma2. Category: OFP vehicle lockedTurret turret path Operand types: vehicle: Object turret path: Array Compatibility: Version 5501 required. Category: OFP vehicle lockTurret [turret path. Type of returned value: Boolean Description: Check whether gunner position of the vehicle turret is locked.com/comref/full. Type of returned value: Boolean Description: Check whether driver position of the vehicle turret is locked.

com/comref/full. This is sometimes used during cut-scenes. Type of returned value: Nothing Description: Control what the unit is looking at (target or position) (format Position) http://www. Example: log 10 . Category: OFP group lockWp lockWP Operand types: group: Object or Group lockWP: Boolean Type of returned value: Nothing Description: Disables switching to the next waypoint (the current waypoint will never complete while lockWp is used).40 required.html 7/11/2010 .BIS Game Engine Scripting Commands Page 227 of 415 Type of returned value: Nothing Description: Lock the gunner position of the vehicle turret. result is 1 Category: Default unit(s) lookAt position Operand types: unit(s): Object or Array position: Object or Array Compatibility: Version 2. Example: groupOne lockWP true Category: OFP log x Operand types: x: Number Type of returned value: Number Description: The base-10 logarithm of x.arma2.

otherSoldier lookAt getMarkerPos "markerOne" Category: OFP map lookAtPos position Operand types: map: Control position: Array Compatibility: Version 2.BIS Game Engine Scripting Commands Page 228 of 415 Example: someSoldier lookAt otherSoldier.arma2. Type of returned value: Nothing Description: Adds the next frame to the map animation.27 required. the position. http://www. Type of returned value: Array Description: Returns an array with the type names of all the vehicle's magazines.75 required.com/comref/full. Category: Editor magazines vehicle Operand types: vehicle: Object Compatibility: Version 1.92 required. position]. the format of position is Position2D. Type of returned value: Nothing Description: Center the map on. Example: magazines player Category: Resistance mapAnimAdd frame Operand types: frame: Array Compatibility: Version 1. and point the camera at. zoom.html 7/11/2010 . The format of frame is [time.

Type of returned value: Boolean Description: Checks whether the map animation has finished.arma2.27 required. Category: OFP markerAlpha markerName Operand types: markerName: String Compatibility: Version 5501 required. getMarkerPos "anim1"] Category: OFP mapAnimClear Compatibility: Version 1.27 required.BIS Game Engine Scripting Commands Page 229 of 415 Example: mapAnimAdd [1. Type of returned value: Number http://www. Category: OFP mapAnimDone Compatibility: Version 1. Category: OFP mapAnimCommit Compatibility: Version 1.html 7/11/2010 . Type of returned value: Nothing Description: Plays the map animation. Type of returned value: Nothing Description: Clears the map animation.27 required.com/comref/full. 0.1.

Example: markerColor "MarkerOne" Category: OFP markerDir markerName Operand types: markerName: String Compatibility: Version 2. Example: markerBrush "MarkerOne" Category: OFP markerColor markerName Operand types: markerName: String Compatibility: Version 1.BIS Game Engine Scripting Commands Page 230 of 415 Description: Gets the marker alpha.html 7/11/2010 . Type of returned value: String Description: Gets the marker color.92 required.arma2. See setMarkerAlpha. See setMarkerBrush. Example: markerAlpha "MarkerOne" Category: OFP markerBrush name Operand types: name: String Compatibility: Version 5501 required.com/comref/full.50 required. Type of returned value: Array http://www. See setMarkerColor. Note: this function is identical to getMarkerColor. Type of returned value: String Description: Gets the marker brush.

Example: markerShape "MarkerOne" Category: OFP markerSize markerName Operand types: markerName: String Compatibility: Version 1.html 7/11/2010 . Type of returned value: Array http://www. See setMarkerDir.BIS Game Engine Scripting Commands Page 231 of 415 Description: Gets the marker direction.50 required.50 required.arma2.com/comref/full. Type of returned value: Array Description: Returns the marker positon in format [x. Example: markerPos "markerOne" Category: OFP markerShape name Operand types: name: String Compatibility: Version 5501 required. Type of returned value: String Description: Gets the marker shape.y].z. Example: markerDir "MarkerOne" Category: OFP markerPos markerName Operand types: markerName: String Compatibility: Version 1. See setMarkerShape. Note: this function is identical to getMarkerPos.

See setMarkerType. Type of returned value: String Description: Gets the type of the marker.html 7/11/2010 .50 required. Example: markerSize "MarkerOne" Category: OFP markerText markerName Operand types: markerName: String Compatibility: Version 2. Note: this function is identical to getMarkerSize.arma2. See setMarkerSize. Type of returned value: Array Description: Gets the marker text. Note: this function is identical to getMarkerType.BIS Game Engine Scripting Commands Page 232 of 415 Description: Gets the marker size. See setMarkerText. Example: markerText "MarkerOne" Category: OFP markerType markerName Operand types: markerName: String Compatibility: Version 1.92 required. Example: markerType "MarkerOne" Category: OFP a max b Operand types: a: Number b: Number Type of returned value: Number Description: http://www.com/comref/full.

b Example: 3 max 2 .arma2.html 7/11/2010 .ext entries hierarchy. Type of returned value: Config Description: Return root of mission description. Type of returned value: String Description: Returns the name of the current mission. Category: OFP PC missionName Compatibility: Version 1. result is 2 Category: Default missionConfigFile Compatibility: Version 2.BIS Game Engine Scripting Commands Page 233 of 415 The greater of a. Category: OFP missionNamespace http://www.b Example: 3 min 2 .80 required.90 required. result is 3 Category: Default a min b Operand types: a: Number b: Number Type of returned value: Number Description: The smaller of a.com/comref/full.

day. Category: OFP missionStart Compatibility: Version 1.com/comref/full. second]. Category: OFP a mod b Operand types: a: Number b: Number Type of returned value: Number Description: The remainder of a divided by b. Category: OFP http://www. minute.html 7/11/2010 . result is 1 Category: Default object modelToWorld modelPos Operand types: object: Object modelPos: Array Compatibility: Version 2. Type of returned value: Namespace Description: Return the global namespace attached to mission.BIS Game Engine Scripting Commands Page 234 of 415 Compatibility: Version 5501 required.80 required. Type of returned value: Array Description: Converts position from object model space to world space. month.92 required. hour.arma2. Type of returned value: Array Description: Returns the time of the mission start in format [year. Note that the remainer is calculated in the real domain. Example: 3 mod 2 .

BIS Game Engine Scripting Commands Page 235 of 415 morale unit Operand types: unit: Object Compatibility: Version 5500 required.arma2. result is 0. (Immediately. Example: morale leader player . Example: soldierOne moveInCargo jeepOne Category: OFP http://www. Type of returned value: Number Description: Checks a current morale level of the unit (-1.5 Category: OFP group move pos Operand types: group: Object or Group pos: Array Type of returned value: Nothing Description: Creates a move waypoint on the given position (format Position) and makes it the currently active group waypoint.com/comref/full. Example: groupOne move getPos player Category: OFP soldier moveInCargo vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Nothing Description: Moves the soldier into the vehicle's cargo position. without animation)..html 7/11/2010 .+1).

Example: soldierOne moveInCommander jeepOne Category: OFP soldier moveInDriver vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Nothing Description: Moves the soldier into the vehicle's driver position. CargoIndex] Operand types: soldier: Object [vehicle.com/comref/full. (Immediately. Example: soldierOne moveInDriver jeepOne Category: OFP soldier moveInGunner vehicle Operand types: http://www. CargoIndex]: Array Type of returned value: Nothing Description: Moves the soldier into a vehicle's specified cargo position. (Immediatetely. without animation). without animation). (Immediately.BIS Game Engine Scripting Commands Page 236 of 415 soldier moveInCargo [vehicle.html 7/11/2010 . Example: soldierOne moveInCargo jeepOne Category: OFP soldier moveInCommander vehicle Operand types: soldier: Object vehicle: Object Type of returned value: Nothing Description: Moves the soldier into the vehicle's commander position. without animation).arma2.

(Immediately. without animation).BIS Game Engine Scripting Commands Page 237 of 415 soldier: Object vehicle: Object Type of returned value: Nothing Description: Moves the soldier into the vehicle's gunner position. Example: soldierOne moveInTurret [tank. 0]] Category: OFP map moveObjectToEnd object Operand types: map: Control object: String Compatibility: Version 2.com/comref/full.arma2.html 7/11/2010 . This means that the object will be drawn last (after all other objects). without animation). turret path] Operand types: soldier: Object [vehicle. http://www. Category: Editor moveOut soldier Operand types: soldier: Object Compatibility: Version 5501 required. Example: soldierOne moveInGunner jeepOne Category: OFP soldier moveInTurret [vehicle. Type of returned value: Nothing Description: Shifts an editor object to the end of the objects array.92 required. turret path]: Array Type of returned value: Nothing Description: Moves the soldier into the vehicle's turret. (Immediately. [0.

Type of returned value: Boolean Description: Check if latest low level moveTo command is finished. http://www.com/comref/full. Example: moveTime player Category: OFP PC person moveTo position Operand types: person: Object position: Array Compatibility: Version 2.61 required.arma2. Type of returned value: Nothing Description: Low level command to person to move to given position.BIS Game Engine Scripting Commands Page 238 of 415 Type of returned value: Nothing Description: Moves the soldier out of vehicle. Category: OFP moveToCompleted person Operand types: person: Object Compatibility: Version 2.html 7/11/2010 .62 required. without animation). (Immediately. Category: OFP moveTime soldier Operand types: soldier: Object Compatibility: Version 5500 required. Type of returned value: Number Description: Returns the current time of the most important RTM animation currently being played on the soldier.

Example: name vehicle player Category: OFP name location Operand types: location: Location Compatibility: Version 2.arma2. Category: OFP musicVolume Type of returned value: Number Description: Checks the current music volume (set by fadeMusic).com/comref/full. the name of the first crew member is returned (in order: commander.BIS Game Engine Scripting Commands Page 239 of 415 Category: OFP moveToFailed person Operand types: person: Object Compatibility: Version 2. gunner). Category: OFP name object Operand types: object: Object Type of returned value: String Description: Returns the name of the variable assigned to the object in the mission editor.html 7/11/2010 . Type of returned value: Boolean Description: Check if latest low level moveTo command failed. driver. http://www.92 required. When used on a vehicle.90 required.

only entities of given type (or its subtype) are listed. radius] or [[typeName1.].]. Type of returned value: Array Description: Find entities in the circle with given radius.. radius]: Compatibility: Version 5501 required. typeName2.arma2. Category: Location position nearEntities radius or [typeName. type]: Array Compatibility: Version 2.BIS Game Engine Scripting Commands Page 240 of 415 Type of returned value: String Description: Return name of global vatiable containing given location. radius] Operand types: position: Object or Array radius or [typeName.. . Type of returned value: Location http://www. Example: _list = position player nearObjects 50 Category: OFP nearestBuilding obj Operand types: obj: Object Type of returned value: Object Description: Returns the nearest building to the given object. If typeName(s) is (are) given... typeName2. type] Operand types: [position. . radius] or [[typeName1. Example: neareastBuilding player Category: OFP nearestLocation [position.90 required.html 7/11/2010 .com/comref/full.

92 required. Pos may be using format [x. [types]. Category: Location nearestLocations [position. Category: Location nearestLocationWithDubbing position Operand types: position: Array Compatibility: Version 5501 required. Category: Location nearestObject pos Operand types: pos: Array Type of returned value: Object Description: Returns the nearest object of the given type to the given position or object.arma2. <position to sort from>]: Array Compatibility: Version 2. "StreetLamp"] Category: OFP http://www. locations will be ordered by distance from this point. distance. [types].html 7/11/2010 . distance. If <position to sort from> is provided. Type of returned value: Array Description: Find the nearest locations (from the given position) of certain types.com/comref/full. Example: nearestObject [player. <position to sort from>] Operand types: [position. "type"] or [object. within the specified distance.y. "type"].BIS Game Engine Scripting Commands Page 241 of 415 Description: Find the nearest location (to the given position) of given type.z. Type of returned value: Location Description: Find the nearest location (to the given position) having it speech non-empty.

]. within the specified distance.com/comref/full.. Pos may be using format [x. 200] Category: OFP http://www. Type of returned value: Object Description: Find object nearest to given position with given type.].z. Type of returned value: Array Description: Returns a list of nearest objects of the given types to the given position or object."Tank"].y...01 required. Type of returned value: Object Description: Find object nearest to given position with given Visitor id. Example: obj = position player nearestObject "Building" Category: Resistance position nearestObject id Operand types: position: Array id: Number Compatibility: Version 2. ["type". Example: obj = position player nearestObject 1234 Category: Resistance nearestObjects pos Operand types: pos: Array Compatibility: Version 2.arma2.92 required...BIS Game Engine Scripting Commands Page 242 of 415 position nearestObject type Operand types: position: Array type: String Compatibility: Version 2. limit]. ["type". Example: nearestObjects [player.html 7/11/2010 .01 required.. limit] or [object. ["Car".

Example: _list = player nearRoads 50 http://www.com/comref/full. Type of returned value: Boolean Description: Check whether all data are loaded to nearObjects will return in reasonable time. radius]: Compatibility: Version 2. Type of returned value: Array Description: Find the road segments within the circle of given radius.arma2.html 7/11/2010 . If typeName is given. Type of returned value: Array Description: Find objects in the circle with given radius.92 required. Example: _list = position player nearObjects 50 Category: OFP position nearObjectsReady radius Operand types: position: Object or Array radius: Number Compatibility: Version 5501 required. radius] Operand types: position: Object or Array radius or [typeName.BIS Game Engine Scripting Commands Page 243 of 415 position nearObjects radius or [typeName. Example: _ok = position player nearObjectsReady 50 Category: OFP position or object nearRoads radius Operand types: position or object: Object or Array radius: Number Compatibility: Version 5500 required. only objects of given type (or its subtype) are listed.

The output is list of items: [position.html 7/11/2010 . Type of returned value: Nothing Description: Creates the new overlay dialog for the specified type of overlay. type.arma2. Type of returned value: Number Description: Return how much vehicle wants to reload its weapons.92 required. distance radius around it. Category: Editor nextMenuItemIndex map Operand types: http://www.com/comref/full. side. subj. cost. object] Category: OFP needReload vehicle Operand types: vehicle: Object Compatibility: Version 2. Category: OFP map newOverlay config Operand types: map: Control config: Config Compatibility: Version 2.BIS Game Engine Scripting Commands Page 244 of 415 Category: OFP unit nearTargets radius Operand types: unit: Object radius: Number Type of returned value: Array Description: Check target database of the unit for all targets in max.92 required.

Type of returned value: Number Description: Returns the total number of user-added menu items belonging to the given menu. Type of returned value: Number Description: Return the time (in seconds) when the next weather change will occur. Category: Editor http://www.92 required.BIS Game Engine Scripting Commands Page 245 of 415 map: Control Compatibility: Version 2. This value can be used to undefine an existing variable.92 required.arma2. Category: OFP nil Type of returned value: Any Description: Nil value. Category: Editor nextWeatherChange Compatibility: Version 2. Example: variableToDestroy = nil Category: Default map nMenuItems menu index Operand types: map: Control menu index: Compatibility: Version 2.html 7/11/2010 .com/comref/full. Type of returned value: Number Description: Returns the next available menu item index.92 required.

result is true Category: Default NumberToDate [year.0.time] Operand types: [year. Example: date = NumberToDate [2008. including itself. Example: player == objNull .arma2.com/comref/full.BIS Game Engine Scripting Commands Page 246 of 415 not a Operand types: a: Boolean Type of returned value: Boolean Description: not a Example: not false . Type of returned value: Array Description: Convert float number to date. result is false Category: OFP objective objStatus status Operand types: objective: String status: String Type of returned value: http://www.html 7/11/2010 .time]: Array Compatibility: Version 5501 required. This value is not equal to anything.5324] Category: OFP objNull Type of returned value: Object Description: A non-existing object.

arma2.BIS Game Engine Scripting Commands Page 247 of 415 Nothing Description: Sets the briefing objective status. Status may be one of: "ACTIVE". Example: "obj_1" objStatus "FAILED" Category: OFP onBriefingGroup sound Operand types: sound: String Compatibility: Version 1. "FAILED".75 required.com/comref/full.75 required. "DONE" or "HIDDEN". Example: onBriefingNotes "NotesVoiceOver" Category: Resistance onBriefingPlan sound Operand types: sound: String http://www. Example: onBriefingGroup "GroupVoiceOver" Category: Resistance onBriefingNotes sound Operand types: sound: String Compatibility: Version 1.html 7/11/2010 . Type of returned value: Nothing Description: Defines a sound (voice) that is played the first time when the Group section in the briefing is selected. Type of returned value: Nothing Description: Defines a sound (voice) that is played the first time when the Notes section in the briefing is selected.

BIS Game Engine Scripting Commands Page 248 of 415 Compatibility: Version 1. Type of returned value: Nothing Description: Defines an action performed when commnad mode change.75 required.html 7/11/2010 .com/comref/full.arma2. Command receives _isHighCommand bool Category: OFP map onDoubleClick command Operand types: map: Control http://www. Example: onBriefingTeamSwitch "TeamSwitchVoiceOver" Category: Resistance onCommandModeChanged command Operand types: command: Compatibility: Version 5501 required.92 required. Example: onBriefingPlan "PlanVoiceOver" Category: Resistance onBriefingTeamSwitch sound Operand types: sound: String Compatibility: Version 2. Type of returned value: Nothing Description: Defines a sound (voice) that is played the first time when the Plan section in the briefing is selected. Type of returned value: Nothing Description: Defines a sound (voice) that is played the first time when the Team switch section in the briefing is selected.

Type of returned value: Nothing http://www.arma2. Type of returned value: Nothing Description: Defines an action performed when palyer clicked on group marker (3D or in a map) Category: OFP onGroupIconOverEnter command Operand types: command: Compatibility: Version 5501 required.html 7/11/2010 . Type of returned value: Any Description: Defines an action performed when the user double clicks on the map.com/comref/full.92 required._alt bool key state Category: Editor onGroupIconClick command Operand types: command: Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 249 of 415 command: String Compatibility: Version 2. Type of returned value: Nothing Description: Defines an action performed when palyer clicked on group marker (3D or in a map) Category: OFP onGroupIconOverLeave command Operand types: command: Compatibility: Version 5501 required. Command receives: _pos array position _units array selected units _shift.

BIS Game Engine Scripting Commands Page 250 of 415 Description: Defines an action performed when palyer clicked on group marker (3D or in a map) Category: OFP onHCGroupSelectionChanged command Operand types: command: Compatibility: Version 5501 required. group player]" Category: Resistance parameters onMapSingleClick command Operand types: parameters: Any command: Compatibility: http://www. Example: onMapSingleClick """SoldierEG"" createUnit [_pos. Command receives _group group selected group _isSelected bool new selection state Category: OFP onMapSingleClick command Operand types: command: Compatibility: Version 1.com/comref/full._alt bool key state If the click is processed. Command receives: _pos array position _units array selected units _shift. command should return true. Type of returned value: Nothing Description: Defines an action performed when the user clicks on the map. Type of returned value: Nothing Description: Defines an action performed when HC group has been selected.html 7/11/2010 .91 required.arma2.

Variables _id and _name are set. Type of returned value: Nothing Description: This statement is launched whenever a player is disconnected from a MP session.html 7/11/2010 . Category: Resistance onPreloadFinished command http://www. Category: Resistance onPlayerDisconnected statement Operand types: statement: Compatibility: Version 2.BIS Game Engine Scripting Commands Page 251 of 415 Version 5500 required.10 required. Type of returned value: Nothing Description: Defines an action performed when the user clicks on the map. Command receives: _pos array position _units array selected units _shift. group player]" Category: OFP onPlayerConnected statement Operand types: statement: Compatibility: Version 2. command should return true. Example: "SoldierEG" onMapSingleClick "_this createUnit [_pos.com/comref/full. Variables _id and _name are set._alt bool key state _this any parameters passed to this function If the click is processed.arma2. Type of returned value: Nothing Description: This statement is launched whenever a player is connected to a MP session.10 required.

html 7/11/2010 . Command receives: _pos array position Category: Editor onTeamSwitch command Operand types: command: Compatibility: Version 5500 required. Category: OFP map onShowNewObject command Operand types: map: Control command: String Compatibility: Version 2. Type of returned value: Any Description: Defines an action performed when the user right clicks on the map and selects New Object.92 required.arma2. Type of returned value: Nothing Description: Defines an action performed just before the preload screen started. Type of returned value: http://www. Set to empty for default behavior.com/comref/full. Category: OFP onPreloadStarted command Operand types: command: Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 252 of 415 Operand types: command: Compatibility: Version 5501 required. Type of returned value: Nothing Description: Defines an action performed after the preload screen finished.

Type of returned value: Number Description: http://www. Command receives: _from object previous unit _to object current units Category: OFP a or b Operand types: a: Boolean b: Boolean Type of returned value: Boolean Description: a or b Example: not alive player or not alive leader player Category: Default unitArray orderGetIn order Operand types: unitArray: Array order: Boolean Type of returned value: Nothing Description: Forces all units in the list to get in their assigned vehicle.html 7/11/2010 .BIS Game Engine Scripting Commands Page 253 of 415 Nothing Description: Defines an action performed when the team switch is finished.92 required.arma2. Example: [unitOne. unitTwo] orderGetIn true Category: OFP overcast Compatibility: Version 2.com/comref/full.

Example: parseNumber "0.125" Category: Default parseText text http://www. Type of returned value: Number Description: Return the overcast forecast. return the ID of the client where the object is local. Type of returned value: Number Description: Parse string containing real number. Otherwise return 0. Category: OFP parseNumber string Operand types: string: String Compatibility: Version 2. Category: OFP owner object Operand types: object: Object Compatibility: Version 5501 required. Type of returned value: Number Description: On server machine.arma2.92 required. Category: OFP overcastForecast Compatibility: Version 2.html 7/11/2010 .BIS Game Engine Scripting Commands Page 254 of 415 Return the current overcast.92 required.com/comref/full.

img image=data\isniper. Type of returned value: Namespace Description: Return the global namespace attached to config parser.1415 Category: Default pickWeaponPool obj Operand types: obj: Object Compatibility: Version 1.&ltbr/&gt. result is 3. http://www.75 required.01 required. Example: txt = parseText "First line&lt. Type of returned value: Structured text Description: Creates a structured text by parsing the given XML description. Category: OFP pi Type of returned value: Number Description: pi (180 degrees converted to radians) Example: pi .Second line" Category: OFP parsingNamespace Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 255 of 415 Operand types: text: String Compatibility: Version 2.com/comref/full.paa/&gt.html 7/11/2010 .arma2. Type of returned value: Nothing Description: Transfers weapons and magazines from the cargo space of object obj to the weapon pool (used in campaigns to transfer weapons to the next mission).

Type of returned value: Nothing Description: When used on a person. a smooth transition to the given action will be initiated. a smooth transition to the given action will be initiated. Category: OFP soldier playAction action Operand types: soldier: Object action: String Compatibility: Version 5500 required. Example: soldierOne playAction "SitDown" Category: OFP soldier playActionNow action Operand types: soldier: Object action: String Compatibility: Version 5501 required.arma2. Example: soldierOne playActionNow "SitDown" Category: OFP http://www.com/comref/full. but all previous playAction are discarded. Type of returned value: Nothing Description: When used on a person.BIS Game Engine Scripting Commands Page 256 of 415 Category: Resistance playableUnits Compatibility: Version 5501 required. Type of returned value: Array Description: Return a list of playable units (occupied by both AI or players).html 7/11/2010 .

Type of returned value: Number Description: Return the player remaining time to respawn.arma2. In MP this value is different on each computer.09 required.92 required. Type of returned value: Number Description: Returns the number of players playing on the given side. Category: OFP playersNumber side Operand types: side: Side Compatibility: Version 1.html 7/11/2010 . Category: OFP playerSide Compatibility: Version 2. This is valid even when the player controlled person is dead (a difference from player side). Type of returned value: Side Description: Returns the player's side.com/comref/full. Example: alive player Category: OFP playerRespawnTime Compatibility: Version 2.BIS Game Engine Scripting Commands Page 257 of 415 player Type of returned value: Object Description: This is the person controlled by the player.80 required. http://www.

com/comref/full. a smooth transition to the given move will be initiated. Type of returned value: Nothing Description: The mission is launched (from the main menu). Example: http://www. mission. If the campaign is empty. If skipBriefing is true.19 required. the intro and briefing are skipped.html 7/11/2010 .BIS Game Engine Scripting Commands Page 258 of 415 Category: OFP soldier playGesture moveName Operand types: soldier: Object moveName: String Compatibility: Version 5500 required. skipBriefing]: Array Compatibility: Version 2. Example: playMission["XOutrage". a smooth transition to the given move will be initiated. Example: soldierOne playGesture "Wave" Category: OFP playMission [campaign.arma2.Noe"] Category: OFP soldier playMove moveName Operand types: soldier: Object moveName: String Type of returned value: Nothing Description: When used on a person. mission] or [campaign. Both campaign and mission are given as their directory name. mission] or [campaign. mission. Type of returned value: Nothing Description: When used on a person."x05Negotiator. skipBriefing] Operand types: [campaign. a single mission is launched.

com/comref/full.BIS Game Engine Scripting Commands Page 259 of 415 soldierOne playMove "Stand" Category: OFP soldier playMoveNow moveName Operand types: soldier: Object moveName: String Compatibility: Version 5501 required. a smooth transition to the given move will be initiated.position].ext file. but all previous playAction are discarded.arma2. Position is in seconds.ext file. Type of returned value: Nothing Description: When used on a person. Example: playMusic "musicname" http://www. The format of nameAndPos is [name. Example: playMusic ["Track13". Example: soldierOne playMoveNow "Stand" Category: OFP playMusic nameAndPos Operand types: nameAndPos: Array Type of returned value: Nothing Description: Plays music defined in the description.html 7/11/2010 . 30] Category: OFP playMusic name Operand types: name: String Type of returned value: Nothing Description: Plays music defined in the description.

html 7/11/2010 .ext file.ext for this mission. Type of returned value: Array Description: Returns the object position in format Position. config]: Array Compatibility: Version 5500 required. config] Operand types: [world.arma2. expression. Config (optional) can reference to the config entry replacing description. expression.com/comref/full. Example: position player Category: OFP http://www. Example: playSound "soundname" Category: OFP position object Operand types: object: Object Compatibility: Version 1. launch an empty mission and execute the given expression. Type of returned value: Nothing Description: Load the given world.50 required.BIS Game Engine Scripting Commands Page 260 of 415 Category: OFP playScriptedMission [world. Category: OFP playSound name Operand types: name: String Type of returned value: Nothing Description: Plays a sound defined in the description.

Category: OFP PC map posWorldToScreen position Operand types: map: Control position: Array http://www. Type of returned value: Array Description: Transform position from camera coordinate space to world coordinate space. Category: Location positionCameraToWorld position Operand types: position: Array Compatibility: Version 2. Example: _worldPos = positionCameraToWorld _cameraPos Category: OFP PC map posScreenToWorld [x.arma2. y]: Array Compatibility: Version 2.html 7/11/2010 .com/comref/full. Type of returned value: Array Description: Convert screen coordinates in map to world coordinates. Type of returned value: Array Description: Return (raw) position of given location. y] Operand types: map: Control [x.90 required.52 required.54 required.BIS Game Engine Scripting Commands Page 261 of 415 position location Operand types: location: Location Compatibility: Version 2.

Type of returned value: Nothing Description: Adjust parameters for specified post process effect Example: "radialBlurr" ppEffectEnable [] Category: Visual array ppEffectCommit scalar Operand types: array: Array scalar: Number http://www. 0.1.92 required.0075.arma2.BIS Game Engine Scripting Commands Page 262 of 415 Compatibility: Version 2. Category: OFP PC number ppEffectAdjust array Operand types: number: Number array: Array Compatibility: Version 2. 0.92 required.1] Category: Visual string ppEffectAdjust array Operand types: string: String array: Array Compatibility: Version 2.54 required.com/comref/full. Type of returned value: Array Description: Convert world coordinates to screen coordinates in map.html 7/11/2010 . Type of returned value: Nothing Description: Set post process effect parameters Example: hndl ppEffectAdjust [0.0075. 0.

. Type of returned value: Nothing Description: Set time when old pars are replaced by last set.92 required.92 required.BIS Game Engine Scripting Commands Page 263 of 415 Compatibility: Version 2. Type of returned value: Nothing Description: Set time when old pars are replaced by last set.arma2.com/comref/full.html 7/11/2010 .92 required. if 0 set immediately Example: hndl ppEffectCommit 0 Category: Visual number ppEffectCommit number Operand types: number: Number number: Number Compatibility: Version 2. Category: Visual ppEffectCommitted effect http://www. if 0 set immediately Example: hndl ppEffectCommit 0 Category: Visual string ppEffectCommit number Operand types: string: String number: Number Compatibility: Version 2. Type of returned value: Nothing Description: Set time when old pars are replaced by last set.. if 0 set immediately Example: .

com/comref/full.arma2.html 7/11/2010 . Type of returned value: Boolean Description: Check whether given post process effect is commited Category: Visual ppEffectCommitted effect Operand types: effect: String Compatibility: Version 5501 required. Type of returned value: Boolean Description: Check whether given post process effect is commited Category: Visual ppEffectCreate effect Operand types: effect: Array Compatibility: Version 5501 required. Type of returned value: Number Description: Create post process effect specified by name and priority http://www.BIS Game Engine Scripting Commands Page 264 of 415 Operand types: effect: Number Compatibility: Version 5501 required. Type of returned value: Array Description: Create post process effect specified by name and priority Category: Visual ppEffectCreate effect Operand types: effect: Array Compatibility: Version 5501 required.

BIS Game Engine Scripting Commands Page 265 of 415 Category: Visual ppEffectDestroy effect Operand types: effect: Array Compatibility: Version 5501 required.92 required. Type of returned value: Nothing Description: Destroy post process effect given by handle Category: Visual number ppEffectEnable bool Operand types: number: Number bool: Boolean Compatibility: Version 2.html 7/11/2010 . Type of returned value: Nothing Description: Enable / disable post process effect Example: hndl ppEffectEnable true Category: Visual string ppEffectEnable bool http://www.arma2. Type of returned value: Nothing Description: Create post process effect specified by name and priority Category: Visual ppEffectDestroy effect Operand types: effect: Number Compatibility: Version 5501 required.com/comref/full.

is overloaded form multiple effects.BIS Game Engine Scripting Commands Page 266 of 415 Operand types: string: String bool: Boolean Compatibility: Version 2. Example: "radialBlurr" ppEffectEnable true.92 required.92 required. is overloaded form multiple effects. Type of returned value: Nothing Description: Enable/disable specified post process effect. "radialBlurr"] ppEffectEnable true Category: Visual precision entity Operand types: entity: Object Compatibility: Version 2. ["chromAberration". Type of returned value: Nothing Description: Enable/disable specified post process effect. Category: OFP preloadCamera position Operand types: http://www.html 7/11/2010 . Example: "radialBlurr" ppEffectEnable true. ["chromAberration". Type of returned value: Number Description: Return the precision of the given entity.92 required.arma2.com/comref/full. "radialBlurr"] ppEffectEnable true Category: Visual array ppEffectEnable bool Operand types: array: Array bool: Boolean Compatibility: Version 2.

arma2. Type of returned value: Boolean Description: Preload all textures and models around given position Category: OFP distance preloadObject object Operand types: distance: Number object: Object or String Compatibility: Version 2. Preload data The object can be defined in the description. Speed is ignored.ext file.speed] or ["name".argument uses format ["text". Category: OFP preloadTitleObj effect Operand types: effect: Array Type of returned value: Boolean Description: Object title . Example: http://www.html 7/11/2010 ."type"."type"].BIS Game Engine Scripting Commands Page 267 of 415 position: Array Compatibility: Version 2. Type of returned value: Boolean Description: Make sure sound can start playing without any delay once we need it.com/comref/full. Type of returned value: Boolean Description: Preload all data for given object.50 required.50 required.50 required. Category: OFP preloadSound sound Operand types: sound: String Compatibility: Version 2.

html 7/11/2010 .sqf" .ext file."type"]. Type of returned value: String Description: Returns the preprocessed content of the given file. Example: preprocessFile "myFunction."plain"] Category: OFP preloadTitleRsc effect Operand types: effect: Array Type of returned value: Boolean Description: Resource title . it supports comments using // or /* and */ and macros defined with #define. The preprocessor is C-like.argument uses format ["name". result is "if a>b then {a} else {b}" Category: OFP preprocessFileLineNumbers filename Operand types: filename: String Compatibility: Version 2.arma2. Type of returned value: String Description: Returns the preprocessed content of the given file. http://www."type". The preprocessor is C-like. it supports comments using // or /* and */ and macros defined with #define.BIS Game Engine Scripting Commands Page 268 of 415 titleObj ["BISLogo".58 required. "PLAIN"] Category: OFP preprocessFile filename Operand types: filename: String Compatibility: Version 1.com/comref/full. Preload data The resource can be defined in the description. Speed is ignored.speed] or ["name". Example: titleRsc ["BIS".82 required.

Type of returned value: Number Description: Return the priority of the task.com/comref/full. Type of returned value: String Description: Returns the name of the vehicle's primary weapon (an empty string if there is none).85 required.75 required.html 7/11/2010 . Type of returned value: Nothing Description: Introduces one or more local variables in the innermost scope.sqf" . Example: primaryWeapon player Category: Resistance priority task Operand types: task: Task Compatibility: Version 2.91 required. result is "if a>b then {a} else {b}" Category: OFP primaryWeapon vehicle Operand types: vehicle: Object Compatibility: Version 1.BIS Game Engine Scripting Commands Page 269 of 415 Example: preprocessFileLineNumbers "myFunction. Category: Identity private variable Operand types: variable: String or Array Compatibility: Version 1.arma2. Category: Default http://www.

Type of returned value: Nothing Description: If loading screen is show. Type of returned value: Number Description: Returns the current position in the progress bar.BIS Game Engine Scripting Commands Page 270 of 415 processDiaryLink link Operand types: link: String Compatibility: Version 5500 required. Type of returned value: Nothing Description: Process commands stored using setVehicleInit. Type of returned value: Nothing Description: Open the diary screen on the record specified by link. set progress bar to the given value (from interval [0.arma2. Category: OFP progressLoadingScreen progress Operand types: progress: Number Compatibility: Version 5501 required.com/comref/full.33 required.html 7/11/2010 . Category: Identity processInitCommands Compatibility: Version 2. 1]) Category: OFP progressPosition control Operand types: control: Control Compatibility: Version 5500 required. http://www.

Example: publicVariable "CTFscoreOne" Category: OFP putWeaponPool obj Operand types: obj: Object Compatibility: Version 1.33 and before. Type of returned value: Nothing Description: Sets the current position in the progress bar.arma2. Only type Number is supported in versions 1.BIS Game Engine Scripting Commands Page 271 of 415 Example: _pos = progressPosition _control Category: OFP PC control progressSetPosition pos Operand types: control: Control pos: Number Compatibility: Version 2. Example: _control sliderSetPosition 0 Category: OFP PC publicVariable varName Operand types: varName: String Type of returned value: Nothing Description: Broadcasts the variable value to all computers. Object and Group. Boolean.92 required. Type of returned value: Nothing Description: Transfers weapons and magazines from the weapon pool (used in campaigns to transfer weapons to the next mission) into the cargo space of object obj.75 required. The following types are supported since 1.html 7/11/2010 .34: Number.com/comref/full. http://www.

75 required. result is 3.html 7/11/2010 .75 required. Example: rad 180 . Category: Resistance queryWeaponPool name Operand types: name: String Compatibility: Version 1.arma2. Category: Resistance rad x Operand types: x: Number Type of returned value: Number Description: Converts x from degrees to radians.com/comref/full.1415 Category: Default radioVolume http://www. Type of returned value: Number Description: Returns the number of magazines of type name in the weapon pool (used in campaigns to transfer weapons to the next mission). Type of returned value: Number Description: Returns the number of weapons of type name in the weapon pool (used in campaigns to transfer weapons to the next mission).BIS Game Engine Scripting Commands Page 272 of 415 Category: Resistance queryMagazinePool name Operand types: name: String Compatibility: Version 1.

Category: OFP rankId unit http://www. Category: OFP rain Compatibility: Version 2. Type of returned value: String Description: Return the rank of the given unit.92 required.arma2. Category: OFP random x Operand types: x: Number Type of returned value: Number Description: The random real value from 0 to x.BIS Game Engine Scripting Commands Page 273 of 415 Type of returned value: Number Description: Checks the current radio volume (set by setRadioVolume).92 required. (0<=random<1) Example: random 1 Category: Default rank unit Operand types: unit: Object Compatibility: Version 2. Type of returned value: Number Description: Return the current rain.com/comref/full.html 7/11/2010 .

This rating is increased for killing enemies. Type of returned value: Number Description: Return the rank of the given unit for comparison.90 required. Type of returned value: Array Description: http://www.com/comref/full. Category: Location registeredTasks teamMember Operand types: teamMember: Compatibility: Version 2. Example: rating player Category: OFP rectangular location Operand types: location: Location Compatibility: Version 2.91 required.html 7/11/2010 . Category: OFP rating unit Operand types: unit: Object Type of returned value: Number Description: Checks the unit rating.arma2.BIS Game Engine Scripting Commands Page 274 of 415 Operand types: unit: Object Compatibility: Version 5500 required. Type of returned value: Boolean Description: Check if given location has rectangular shape. decreased for killing friendlies and can be changed by a mission designer.

92 required. Category: Identity reload vehicle Operand types: vehicle: Object Compatibility: Version 2.com/comref/full.html 7/11/2010 . Category: Identity teamMember registerTask entry name Operand types: teamMember: entry name: String Compatibility: Version 2. Type of returned value: Boolean Description: Register a new task type. Type of returned value: Nothing Description: Reload all weapons.arma2.BIS Game Engine Scripting Commands Page 275 of 415 List all registered task types.92 required. Category: OFP reloadEnabled vehicle Operand types: vehicle: Object Compatibility: Version 2. Parameters are defined in the given config class (subclass of CfgTasks). Type of returned value: Boolean Description: Check whether magazine is reloaded whenever emptied. Category: OFP who remoteControl whom http://www.90 required.

Type of returned value: Nothing Description: Removes the action with the given id.arma2.html 7/11/2010 . Example: player remoteControl gunner _uav Category: OFP unit removeAction index Operand types: unit: Object index: Number Compatibility: Version 1. Type of returned value: Nothing Description: Removes all event handlers of the given type which were added by addEventHandler.85 required. Example: player removeAction 0 Category: OFP object removeAllEventHandlers handlerType Operand types: object: Object handlerType: String Compatibility: Version 1.com/comref/full.BIS Game Engine Scripting Commands Page 276 of 415 Operand types: who: Object whom: Object Compatibility: Version 5501 required. Example: player removeAllEventHandlers "killed" Category: OFP http://www.11 required. Type of returned value: Nothing Description: Switch on remote control of the unit.

string identifier] Operand types: map: Control [object.com/comref/full. string identifier]: Array Compatibility: Version 2.92 required. Type of returned value: Nothing Description: Removes all special items from the unit. Example: removeAllWeapons player Category: OFP map removeDrawIcon [object.BIS Game Engine Scripting Commands Page 277 of 415 removeAllItems unit Operand types: unit: Object Compatibility: Version 5501 required.html 7/11/2010 . Type of returned value: Nothing Description: Removes an icon for an editor object.arma2. Example: removeAllItems player Category: OFP removeAllWeapons unit Operand types: unit: Object Type of returned value: Nothing Description: Removes all weapons from the unit. Category: Editor map removeDrawLinks [from. param type] Operand types: map: Control http://www.

Format of handler is [type.index].com/comref/full. param type]: Array Compatibility: Version 2.92 required. When any handler is removed.arma2.85 required. Example: player removeEventHandler ["killed". Type of returned value: Nothing Description: Removes event handler added by addEventHandler. Index is returned by addEventHandler. all handler indices higher that the deleted one should be decremented. Category: Editor object removeEventHandler handler Operand types: object: Object handler: Array Compatibility: Version 1. Example: group removeGroupIcon id Category: OFP unit removeMagazine weaponName http://www. Type of returned value: Nothing Description: Remove icon with given ID from group.BIS Game Engine Scripting Commands Page 278 of 415 [from.0] Category: OFP group removeGroupIcon icon ID Operand types: group: Group icon ID: Number Compatibility: Version 5501 required. Pass an empty string as param type to remove all draw links for an object. Type of returned value: Nothing Description: Remove all drawn links for the given editor object for the given editor object type.html 7/11/2010 .

When doing so. Example: player removeMagazines "M16" Category: OFP map removeMenuItem index of menu item to delete Operand types: map: Control index of menu item to delete: Number Compatibility: Version 2. application behaviour is undefined. Example: player removeMagazine "M16" Category: OFP unit removeMagazines weaponName Operand types: unit: Object weaponName: String Type of returned value: Nothing Description: Removes all magazines of the given type from the unit. When doing so. application behaviour is undefined. Note: you may create invalid combinations by using this function.arma2.BIS Game Engine Scripting Commands Page 279 of 415 Operand types: unit: Object weaponName: String or Array Type of returned value: Nothing Description: Removes the magazine from the unit. Type of returned value: Nothing Description: Removes a previously added menu item. Note: you may create invalid combinations by using this function. Category: Editor map removeMenuItem text of menu item to delete Operand types: map: Control http://www.com/comref/full.html 7/11/2010 .92 required.

BIS Game Engine Scripting Commands Page 280 of 415 text of menu item to delete: String Compatibility: Version 2. Category: Editor person removeSimpleTask task Operand types: person: Object task: Task Compatibility: Version 5501 required. When doing so.92 required. Category: Identity removeSwitchableUnit person Operand types: person: Object Compatibility: Version 2. Type of returned value: Nothing Description: Removes a previously added menu item. http://www.html 7/11/2010 .arma2. Type of returned value: Nothing Description: Remove a unit from the list of units available for team switch. Category: OFP unit removeWeapon weaponName Operand types: unit: Object weaponName: String Type of returned value: Nothing Description: Removes the weapon from the unit.92 required. Type of returned value: Nothing Description: Remove a simple task from the list of simple tasks. Note: you may create invalid combinations by using this function. application behaviour is undefined.com/comref/full.

This function can be used to add or remove elements from the array. The version format is "Major.arma2. a warning message is shown and false is returned.30". Category: OFP array resize count Operand types: array: Array count: Number Compatibility: Version 1. e. Type of returned value: Nothing Description: Changes the array size. "1. Example: array resize 2 Category: Default http://www. Type of returned value: Boolean Description: Checks whether the appropriate version of the application is available.BIS Game Engine Scripting Commands Page 281 of 415 Example: player removeWeapon "M16" Category: OFP requiredVersion version Operand types: version: String Compatibility: Version 1.com/comref/full.30" Category: OFP resistance Type of returned value: Side Description: The Resistance side.g. If it's not.html 7/11/2010 . Example: requiredVersion "1.21 required.75 required.Minor".

3] Category: OFP restartEditorCamera map Operand types: map: Control Compatibility: Version 2. default respawnDelay from description.arma2.92 required.0. for example).52 required.com/comref/full. count = 0] Operand types: vehicle: Object [delay = -1. Type of returned value: Nothing Description: Set vehicle as respawnable in MP games.html 7/11/2010 . count = 0]: Array Compatibility: Version 2. Example: car respawnVehicle [5. Type of returned value: Nothing Description: Restarts the mission editor camera (if it was deleted by a script. Category: Editor group reveal unit Operand types: group: Object or Group unit: Object Type of returned value: Nothing Description: Reveals the unit to the group. Delay is respawn delay. Count tells how many respawns is processed (default unlimited).BIS Game Engine Scripting Commands Page 282 of 415 vehicle respawnVehicle [delay = -1.ext is used. It does not matter whether the group can know about the unit or not. Example: soldierOne reveal soldierTwo Category: OFP reversedMouseY http://www.

result is -5 Category: Default runInitScript Compatibility: Version 2. Example: round -5.html 7/11/2010 .sqs script.25 .BIS Game Engine Scripting Commands Page 283 of 415 Compatibility: Version 5501 required. Category: OFP round x Operand types: x: Number Type of returned value: Number Description: The round value of x.arma2.33 required. Category: OFP http://www. Type of returned value: Nothing Description: Launch init. Type of returned value: Array Description: Find the road segments connected to the given road segment. Type of returned value: Boolean Description: Return if mouse vertical axe is inverted. Category: OFP roadsConnectedTo road segment Operand types: road segment: Object Compatibility: Version 5500 required.com/comref/full.

arma2. Type of returned value: Number Category: OFP SafeZoneW Compatibility: Version 5501 required. http://www.html 7/11/2010 .com/comref/full.BIS Game Engine Scripting Commands Page 284 of 415 SafeZoneH Compatibility: Version 5501 required. Type of returned value: Number Category: OFP SafeZoneY Compatibility: Version 5501 required. Type of returned value: Number Category: OFP saveGame Type of returned value: Nothing Description: Creates an autosave game (used for Retry). Type of returned value: Number Category: OFP SafeZoneX Compatibility: Version 5501 required.

com/comref/full.92 required. Type of returned value: Nothing Description: Save the current overlay. Type of returned value: Boolean Description: Saves person's identity to objects.75 required.BIS Game Engine Scripting Commands Page 285 of 415 Category: OFP person saveIdentity name Operand types: person: Object name: String Compatibility: Version 1. Example: player saveIdentity "playerIdentity" Category: Resistance saveOverlay map Operand types: map: Control Compatibility: Version 2.html 7/11/2010 .sav file in campaign directory as entry name. http://www.arma2. Example: saveOverlay _map Category: Editor object saveStatus name Operand types: object: Object name: String Compatibility: Version 1.sav file in campaign directory as entry name. Type of returned value: Boolean Description: Saves object's properties to objects.75 required.

The variable is then available to all following missions in the campaign. Category: OFP http://www.BIS Game Engine Scripting Commands Page 286 of 415 Example: player saveStatus "playerState" Category: Resistance saveVar varName Operand types: varName: String Type of returned value: Nothing Description: Saves the variable value into the global campaign space. If the camera is not withing the given range. speed]. The unit will play the given sound.ext file. Category: OFP unit or [unit. If target is given.com/comref/full.arma2.75 required.html 7/11/2010 . the title is not shown. titles will be written to the conversation history. maxTitlesDistance. target]: Object or Array speechName: Array Compatibility: Version 1. Example: saveVar "varOne" Category: OFP savingEnabled Compatibility: Version 5501 required. target] say speechName Operand types: unit or [unit. maxTitlesDistance] or [sound. Type of returned value: Boolean Description: Check if saving the game is enabled. The sound is defined in the description. Type of returned value: Nothing Description: The format of speechName is [sound. If the unit is a person. it will also pefrorm the corresponding lipsync effect.

only difference is sound played as 2D (mono) allways. Category: OFP http://www.arma2.ext file. target]: Object or Array speechName: String Compatibility: Version 5501 required. it will also pefrorm the corresponding lipsync effect. If the unit is a person.com/comref/full. target] say2D speechName Operand types: unit or [unit. Example: soldierOne say "speechId" Category: OFP unit or [unit. Type of returned value: Nothing Description: Functionally same as Say. only difference is sound played as 2D (mono) allways. Example: soldierOne say "speechId" Category: OFP unit or [unit. target] say speechName Operand types: unit or [unit.html 7/11/2010 . target]: Object or Array speechName: String Type of returned value: Nothing Description: The unit will play the given sound. target] say2D speechName Operand types: unit or [unit. The sound is defined in the description.BIS Game Engine Scripting Commands Page 287 of 415 unit or [unit. target]: Object or Array speechName: Array Compatibility: Version 5501 required. If target is given. titles will be written to the conversation history. Type of returned value: Nothing Description: Functionally same as Say.

Category: Default score unit Operand types: unit: Object Type of returned value: http://www. Name is visible in debugger. Type of returned value: Nothing Description: Functionally same as Say. and name is also used as reference in some commands.html 7/11/2010 . target] say3D speechName Operand types: unit or [unit.BIS Game Engine Scripting Commands Page 288 of 415 unit or [unit. target]: Object or Array speechName: Array Compatibility: Version 5501 required. target] say3D speechName Operand types: unit or [unit. Category: OFP unit or [unit. only difference is sound played as 3D allways.com/comref/full. only difference is sound played as 3D allways. Scope name can be defined only once per scope.arma2. Type of returned value: Nothing Description: Functionally same as Say. Example: soldierOne say "speechId" Category: OFP scopeName name Operand types: name: String Type of returned value: Nothing Description: defines name of current scope. target]: Object or Array speechName: String Compatibility: Version 5501 required.

Type of returned value: Nothing Description: Assign a friendly name to the VM script thjis command is executed from. Type of returned value: Array Description: Returns the position on landscape (in world coordinates) corresponding to the given point on screen (in UI coordinates). Example: score unitOne Category: OFP screenToWorld position Operand types: position: Array Compatibility: Version 5501 required. Type of returned value: Boolean Description: Check if script is already finished Category: OFP scriptName name Operand types: name: String Compatibility: Version 5501 required.50 required. Category: OFP scriptDone script Operand types: script: Script Compatibility: Version 2.html 7/11/2010 . Example: http://www.arma2.BIS Game Engine Scripting Commands Page 289 of 415 Number Description: MP: returns the unit's score.com/comref/full.

Example: secondaryWeapon player Category: Resistance array select index Operand types: array: Array index: Boolean Type of returned value: Any Description: If the index is false. Type of returned value: Number Description: Returns the current state of the given scud launcher.75 required. http://www.Launched.Launch preparation. Note: nonintegral values are used to indicate a transition between states.28 required. Type of returned value: String Description: Returns the name of a vehicle's secondary weapon (an empty string if there is none). Example: scudState scudOne>=4 Category: OFP secondaryWeapon vehicle Operand types: vehicle: Object Compatibility: Version 1. it selects the second one. 2 .html 7/11/2010 .arma2.BIS Game Engine Scripting Commands Page 290 of 415 scriptName "Trading" Category: Default scudState scud Operand types: scud: Object Compatibility: Version 1. If it is true. this selects the first element of the array.Launch prepared. The following states are recognized: 0 .Ignition and 4 . 3 .com/comref/full. 1 .No activity.

arma2. _precision.com/comref/full. 2. 1 the second. _sourcesCount]: Array Compatibility: Version 5500 required. _expression. Type of returned value: Config Description: Returns subentry with given index. Category: OFP http://www. _radius. _sourcesCount] Operand types: [_position. 3] select 1 . etc. result is 2 Category: Default selectBestPlaces [_position. Example: (configFile >> "CfgVehicles") select 0 Category: OFP PC array select index Operand types: array: Array index: Number Type of returned value: Any Description: Selects index element of the array. Type of returned value: Array Description: Find the places with the max.html 7/11/2010 . _radius. _expression. Index 0 denotes the first element.BIS Game Engine Scripting Commands Page 291 of 415 Category: Default config select index Operand types: config: Config index: Number Compatibility: Version 2. value of _expression in the given area. Example: [1. _precision.35 required.

html 7/11/2010 . Category: Editor map selectEditorObject object Operand types: map: Control object: String Compatibility: Version 2.92 required. Type of returned value: Nothing Description: Returns a list of currently selected editor objects. Type of returned value: Any Description: Select an editor object. Does not un-select previously selected objects.92 required. http://www. Category: Editor object selectionPosition selection name Operand types: object: Object selection name: String Compatibility: Version 2.92 required. Type of returned value: Nothing Description: Select the subject page in a log.arma2.BIS Game Engine Scripting Commands Page 292 of 415 person selectDiarySubject subject Operand types: person: Object subject: String Compatibility: Version 5500 required.com/comref/full. Category: Identity selectedEditorObjects map Operand types: map: Control Compatibility: Version 2.

Example: group player selectLeader player Category: OFP selectNoPlayer Compatibility: Version 5501 required. then in other levels).33 required. Type of returned value: Nothing Description: Switch player to no unit.html 7/11/2010 . Type of returned value: Nothing Description: Switch player to given unit. Category: OFP selectPlayer unit Operand types: unit: Object Compatibility: Version 2.BIS Game Engine Scripting Commands Page 293 of 415 Type of returned value: Array Description: Search for selection in the object model (first in the memory level. Returns position in model space. Example: http://www.com/comref/full.arma2.33 required. Type of returned value: Nothing Description: Select group leader. Category: OFP group selectLeader unit Operand types: group: Group unit: Object Compatibility: Version 2.

. value1.] Operand types: sender: [receiver. Type of returned value: Task http://www.com/comref/full.html 7/11/2010 . Type of returned value: Nothing Description: Selects the given weapon. Example: soldierOne selectWeapon "LAWLauncher" Category: OFP object sendSimpleCommand command Operand types: object: Object command: String Compatibility: Version 2. Type of returned value: Nothing Description: Sends a simple command to the vehicle's driver / gunner. . parentTask]. name2.arma2. For weapon values see CfgWeapons. name1. name1.BIS Game Engine Scripting Commands Page 294 of 415 selectPlayer aP Category: OFP unit selectWeapon weapon Operand types: unit: Object weapon: String Compatibility: Version 1. value2. priority. value1. [type] or [type.]: Array Compatibility: Version 2. value2.. name2.92 required. . Example: vehicle player sendSimpleCommand "STOP" Category: OFP sender sendTask [receiver. priority...27 required. [type] or [type.26 required. parentTask].

Type of returned value: Nothing Description: Format of element is [index.html 7/11/2010 . Changes an element of the given array.arma2. result. Type is name of registered task type. sentence]: Array Compatibility: Version 2. Category: Identity task sendTaskResult [state. Example: array set [0.75 required.BIS Game Engine Scripting Commands Page 295 of 415 Description: Create a new AI task (subtask of parentTask). Type of returned value: Number Description: Server time synchronized to clients. sentence] Operand types: task: Task [state. Type of returned value: Nothing Description: Send a result of the task to the task sender. result.92 required. Category: Identity serverTime Compatibility: Version 5501 required. Category: OFP array set element Operand types: array: Array element: Array Compatibility: Version 1. "Hello"] Category: Default http://www.com/comref/full. index+1 is called to create it. value]. If the element does not exist.

1 Category: OFP airportId setAirportSide side Operand types: airportId: Number side: Side Compatibility: Version 2. Type of returned value: Nothing Description: Set owner of the airport Example: 0 setAirportSide east Category: OFP vehicle setAmmoCargo ammoCargo Operand types: vehicle: Object ammoCargo: Number Type of returned value: Nothing Description: Sets the amount of ammo resources in the cargo space of a repair vehicle.com/comref/full. soldiers use individual magazines instead.BIS Game Engine Scripting Commands Page 296 of 415 setAccTime accFactor Operand types: accFactor: Number Type of returned value: Nothing Description: Sets the time acceleration coeficient. Ammo resources are used to resupply vehicles. Example: setAccTime 0. It can also be used to slow down time in cutscenes.arma2. An amount of one indicates a full cargo.html 7/11/2010 .92 required. Example: rearmTruckOne setAmmoCargo 0 Category: OFP http://www.

01 required. value2. name2. Example: txt = img setAttributes ["image". Category: OFP setArmoryPoints points Operand types: points: Number Compatibility: Version 5500 required. name2.paa"] Category: OFP group setBehaviour behaviour Operand types: group: Object or Group http://www.. value1. . Type of returned value: Nothing Description: Sets custom camera apreture (-1 to do it automatically). Category: OFP text setAttributes [name1. .html 7/11/2010 . "data\iSoldier.] Operand types: text: Text or String [name1..73 required.. Type of returned value: Nothing Description: Store the given amount of armory points. value1..]: Array Compatibility: Version 2.arma2.com/comref/full. value2.BIS Game Engine Scripting Commands Page 297 of 415 setAperture set Operand types: set: Number Compatibility: Version 2. Type of returned value: Structured text Description: Returns a structured text created by the given structured or plain text by setting attributes to the given values.

com/comref/full. Example: groupOne setBehaviour "SAFE" Category: OFP entity setCameraInterest interest Operand types: entity: Object interest: Number Compatibility: Version 2. "SAFE". Note: This function does not remove the unit's weapons. the vehicle commander is marked instead. If the unit is a vehicle. Type of returned value: Nothing Description: Set camera interest for given entity.arma2. Behaviour is one of: "CARELESS". "COMBAT" or "STEALTH".BIS Game Engine Scripting Commands Page 298 of 415 behaviour: String Type of returned value: Nothing Description: Sets the group behaviour mode. A captive is neutral to everyone.57 required.html 7/11/2010 . "AWARE". Example: setCaptive player Category: OFP group setCombatMode mode Operand types: http://www. Example: _soldier setCameraInterest 50 Category: OFP person setCaptive captive Operand types: person: Object captive: Type of returned value: Nothing Description: Marks the unit as captive.

Example: groupOne setCombatMode "BLUE" Category: OFP person setCurrentTask task Operand types: person: Object task: Task Compatibility: Version 5501 required. Type of returned value: Nothing Description: Set the task as a current task of the person. Category: OFP object setDamage damage Operand types: object: Object damage: Number Compatibility: http://www.arma2. "YELLOW" (Fire at will) or "RED" (Fire at will.html 7/11/2010 . Category: Identity group setCurrentWaypoint waypoint Operand types: group: Group waypoint: Array Compatibility: Version 5129 required. "GREEN" (Hold fire . engage at will). Type of returned value: Nothing Description: Switch the group to process the given waypoint.BIS Game Engine Scripting Commands Page 299 of 415 group: Object or Group mode: String Type of returned value: Nothing Description: Sets the group's combat mode (engagement rules). Mode can be one of: "BLUE" (Never fire). "WHITE" (Hold fire.defend only).com/comref/full. engage at will).

damage 1 means it's completely destroyed / dead. Type of returned value: Nothing Description: Sets the actual mission date and time. Note: this function is identical to setDammage.html 7/11/2010 . Damage 0 means the object is fully functional. damage 1 means it's completely destroyed / dead.50 required. Type of returned value: Nothing Description: Damages / repairs the object. day. Damage 0 means the object is fully functional. hour.86 required. hour. planningMode. Category: OFP object setDestination [position. forceReplan]: Array Compatibility: http://www.arma2. forceReplan] Operand types: object: Object [position. month. month. Example: player setdammage 1 Category: OFP setDate [year. It was introduced to fix a spelling error in the original function name. minute] Operand types: [year.com/comref/full. Example: player setdamage 1 Category: OFP obj setDammage dammage Operand types: obj: Object dammage: Number Type of returned value: Nothing Description: Damages / repairs the object. planningMode. minute]: Array Compatibility: Version 1. day.BIS Game Engine Scripting Commands Page 300 of 415 Version 1.

angle. Type of returned value: Nothing Description: Set a new direction (angle) of given location. texture. maintain size?. Type of returned value: Nothing Description: Set the destination for path planning of the pilot. Category: Location map setDrawIcon [object.90 required.com/comref/full. Category: OFP obj setDir heading Operand types: obj: Object heading: Number Type of returned value: Nothing Description: Sets the object heading. width. maintain size?. color. is3D. priority] Operand types: map: Control [object. Example: player setDir 180 Category: OFP location setDirection direction Operand types: location: Location direction: Number Compatibility: Version 2. height.BIS Game Engine Scripting Commands Page 301 of 415 Version 2. offset. Type of returned value: Nothing http://www.html 7/11/2010 . offset. priority]: Array Compatibility: Version 2. angle. string identifier. width.arma2. is3D. The accepted heading range is from 0 to 360. draw line?. color. shadow. draw line?.92 required. height. texture. string identifier.92 required. shadow.

3D or PREVIEW. If maintain size is false.56 required. icon will not scale depending on the scale of the map.arma2.05 Category: OFP map setEditorMode mode Operand types: map: Control mode: String Compatibility: Version 2. Example: _source setDropInterval 0.editor type.subordinates also] Operand types: map: Control [objects.scope.editor type.condition. Type of returned value: Nothing Description: Sets map mode to MAP.com/comref/full. Type of returned value: Nothing Description: http://www. Category: Editor particleSource setDropInterval interval Operand types: particleSource: Object interval: Number Compatibility: Version 2. the icon will maintain size if map scale is below that number. Type of returned value: Nothing Description: Set interval of emitting particles from particle source.condition.scope.92 required. If maintain size is a number. Category: Editor map setEditorObjectScope [objects. is3D. show line and priority are optional.html 7/11/2010 .92 required.BIS Game Engine Scripting Commands Page 302 of 415 Description: Set the icon to be shown in 2D editor for the specified editor object.subordinates also]: Array Compatibility: Version 2.

BIS Game Engine Scripting Commands Page 303 of 415 This command defines the level of access a user has to editor objects. editor type is the editor type to effect (eg unit).vehicle. LINKTO. SELECT. If the result is an object. if true then subordinates in the editor will be assigned the same scope as the parent.86 required. objects is an array of either Editor Objects (eg [_unit_0]) or actual Game Objects (eg [player]). Category: Editor trigger or waypoint setEffectCondition statement Operand types: trigger or waypoint: Object or Array statement: String Compatibility: Version 1.html 7/11/2010 .false]. the effect was launched if the result is the player or the player vehicle. LINKFROM. the effect was launched. condition is an executable string that must evaluate to true or false. If true. VIEW. If the result is an array. If the result is a boolean and true. Example: _map setEditorObjectScope [[]. the scope of the evaluated editor object will be modified. subordinates also is a boolean value.arma2. or for none. the effect was launched if the result contains the player or the player vehicle. scope is one of HIDE. Example: setFace "Face10" Category: OFP person setFaceanimation blink http://www.side effectiveCommander _x != side player. ALLNODRAG.HIDE. ALLNOTREE or ALL.com/comref/full. Type of returned value: Nothing Description: The statement is executed when the trigger or waypoint is activated and the effects are launched depending on the result. If the array is empty then the command will automatically parse all editor objects. Example: trigger setEffectCondition "thisList" Category: OFP person setFace soldier Operand types: person: Object soldier: String Type of returned value: Nothing Description: Sets the person's face.

the flag is returned to the flagpole. When the owner is set to objNull. Blink is in the range from 0 to 1. Example: setFlagOwner objNull Category: OFP flag setFlagSide side Operand types: flag: Object side: Side Type of returned value: Nothing Description: Sets the flag side. Example: setFaceAnimation 0.arma2. Example: setFlagSide east Category: OFP flag setFlagTexture texture Operand types: flag: Object texture: String http://www.com/comref/full.html 7/11/2010 .BIS Game Engine Scripting Commands Page 304 of 415 Operand types: person: Object blink: Number Type of returned value: Nothing Description: Sets the facial animation phase (eye blinking).5 Category: OFP flag setFlagOwner owner Operand types: flag: Object owner: Object Type of returned value: Nothing Description: Sets the flag owner.

5 Category: OFP group setFormation formation Operand types: group: Object or Group formation: String Type of returned value: Nothing Description: Sets the group formation. "VEE" or "LINE".html 7/11/2010 . If the texture is "".com/comref/full.BIS Game Engine Scripting Commands Page 305 of 415 Type of returned value: Nothing Description: Sets the flag texture. Example: 1800 setFog 0. "STAG COLUMN". Formation is one of: "COLUMN".pac" Category: OFP time setFog fog Operand types: time: Number fog: Number Type of returned value: Nothing Description: Changes the fog value smoothly during the given time (in seconds). "ECH RIGHT". the flag is not drawn. A time of zero means there will be an immediate change. Example: groupOne setFormation "LINE" Category: OFP object setFormationTask task Operand types: object: Object task: String http://www. "ECH LEFT". Example: setFlagTexture "usa_vlajka. A fog level of zero is minimum fog and a fog level of one is maximum fog. "WEDGE".arma2.

BIS Game Engine Scripting Commands Page 306 of 415 Compatibility: Version 2. Category: OFP FSM handle setFSMVariable [name. Example: player setformdir 180 Category: OFP side1 setFriend [side2.86 required. Category: OFP group setFormDir heading Operand types: group: Object or Group heading: Number Type of returned value: Nothing Description: Sets the formation heading. value] Operand types: side1: Side [side2. value] Operand types: FSM handle: Number [name. value]: Array Compatibility: Version 1.html 7/11/2010 . otherwise it's friendly. http://www.com/comref/full. When the group is moving.arma2.92 required. For a value smaller than 0. this value is overridden by the movement direction. Type of returned value: Nothing Description: Set the current task of the formation member. Type of returned value: Nothing Description: Sets how friendly side1 is with side2. The formation is facing this direction unless an enemy is seen. The accepted heading range is from 0 to 360. value]: Array Compatibility: Version 5501 required.6 it results in being enemy.

html 7/11/2010 . The FSM handle is the number returned by the execFSM command.arma2. A fuel level of one is a full gas tank.com/comref/full. Type of returned value: Nothing http://www.BIS Game Engine Scripting Commands Page 307 of 415 Type of returned value: Nothing Description: Set variable to given value in the variable space of given FSM. Example: refuelTruckOne setFuelCargo 0 Category: OFP group setGroupIcon properties Operand types: group: Group properties: Array Compatibility: Version 5501 required. A fuel level of one is a full gas tank. Category: OFP vehicle setFuel amount Operand types: vehicle: Object amount: Number Type of returned value: Nothing Description: Sets the fuel amount. Example: jeepOne setFuel 0 Category: OFP vehicle setFuelCargo amount Operand types: vehicle: Object amount: Number Type of returned value: Nothing Description: Sets the fuel amount in the cargo space of a refuelling vehicle.

Type of returned value: Nothing Description: Set group icons parameters.scale."text".1. [color.arma2. Type of returned value: Nothing Description: Sets if group icons raises onclick and onover events.bool] Example: group setGroupIconParams [[1.1].string.[offsetX.com/comref/full. Example: setGroupIcon[id.1. Type of returned value: http://www.BIS Game Engine Scripting Commands Page 308 of 415 Description: Set group icons properties."b_inf".html 7/11/2010 .float. Example: selectableGroupIcons true Category: OFP setGroupIconsVisible array Operand types: array: Array Compatibility: Version 5501 required.ofsetY]] Category: OFP group setGroupIconParams properties Operand types: group: Group properties: Array Compatibility: Version 5501 required.show] Category: OFP setGroupIconsSelectable bool Operand types: bool: Boolean Compatibility: Version 5501 required.

BIS Game Engine Scripting Commands Page 309 of 415 Nothing Description: Sets if group icons are visible. damage] Operand types: object: Object [part. .] Operand types: group: Object or Group [nameFomat. HidePosition can be taken using getHideFrom. parameters are names of subclasses of CLASS_NAME with the description of the name subpart. Category: OFP object setHideBehind [objectWhereHide.. Type of returned value: Nothing Description: It sets the data for hiding. hidePosition] Operand types: object: Object [objectWhereHide. Type of returned value: Nothing Description: http://www.arma2.30 required. Example: showGroupIcons [true. .com/comref/full. nameParam1. damage]: Array Compatibility: Version 2. ObjectWhereHide can be taken using findCover... hidePosition]: Array Compatibility: Version 2.]: Array Type of returned value: Nothing Description: Sets the group identity.92 required.. nameFormat contains strings "%CLASS_NAME" where CLASS_NAME is name of class in CfgWorlds. Category: OFP object setHit [part. nameParam1.html 7/11/2010 .true] Category: OFP group setGroupid [nameFomat.

Example: vehicle player setHit ["engine". Identities are defined in the descripion. g. 1] Category: OFP person setIdentity identity Operand types: person: Object identity: String Type of returned value: Nothing Description: Sets the identity of a person. b]: Array Compatibility: Version 2.arma2. damage 1 means completely destroyed / dead. Damage 0 means fully functional.90 required. g. Type of returned value: Nothing Description: http://www.ext file of the mission or campaign. Category: Location light setLightAmbient [r. b] Operand types: light: Object [r.html 7/11/2010 .BIS Game Engine Scripting Commands Page 310 of 415 Damage / repair part of object.58 required. Example: setIdentity "JohnDoe" Category: OFP location setImportance importance Operand types: location: Location importance: Number Compatibility: Version 2.com/comref/full. Type of returned value: Nothing Description: Set a new importance of given location.

Type of returned value: Nothing Description: Sets the marker alpha.arma2. g. Type of returned value: Nothing Description: Set diffuse color of light.5 Category: OFP http://www. b] Operand types: light: Object [r.html 7/11/2010 . g.58 required. Example: "MarkerOne" setMarkerAlpha 0. Category: OFP light setLightColor [r.BIS Game Engine Scripting Commands Page 311 of 415 Set ambient color of light.58 required. The marker is modified on all computers in a network session.com/comref/full. b]: Array Compatibility: Version 2. Category: OFP marker setMarkerAlpha alpha Operand types: marker: String alpha: Number Compatibility: Version 5501 required. Category: OFP light setLightBrightness brightness Operand types: light: Object brightness: Number Compatibility: Version 2. Type of returned value: Nothing Description: Set brightness of light.

The marker is only modified on the computer where the command is called. Type of returned value: Nothing Description: Selects the fill texture for the marker ("RECTANGLE" or "ELLIPSE").com/comref/full.86 required.html 7/11/2010 . Example: "Marker1" setMarkerBrush "DiagGrid" Category: OFP name setMarkerBrushLocal brush Operand types: name: String brush: String Compatibility: Version 2. Type of returned value: Nothing Description: Selects the fill texture for the marker ("RECTANGLE" or "ELLIPSE"). Brush is the name of the subclass in CfgMarkerBrushes.arma2.92 required.5 Category: OFP name setMarkerBrush brush Operand types: name: String brush: String Compatibility: Version 1.BIS Game Engine Scripting Commands Page 312 of 415 marker setMarkerAlphaLocal alpha Operand types: marker: String alpha: Number Compatibility: Version 5501 required. The marker is only modified on the computer where the command is called. http://www. Type of returned value: Nothing Description: Sets the marker alpha. Example: "MarkerOne" setMarkerAlpha 0. Brush is the name of the subclass in CfgMarkerBrushes. The marker is modified on all computers in a network session.

The marker is modified on all computers in a network session. Color is one of: "Default". "ColorBlack". Example: "MarkerOne" setMarkerColor "ColorBlack" Category: OFP marker setMarkerColorLocal color Operand types: marker: String color: String Compatibility: Version 2. "ColorBlue". "ColorYellow" or "ColorWhite". The marker is only modified on the computer where the command is called. "ColorYellow" or "ColorWhite". Type of returned value: Nothing Description: Sets the marker color.92 required.arma2.com/comref/full. "ColorRed". Type of returned value: Nothing Description: Sets the marker color.21 required. "ColorGreen". "ColorGreenAlpha". "ColorGreenAlpha".html 7/11/2010 . "ColorRed". Color is one of: "Default". "ColorBlue". "ColorRedAlpha". "ColorGreen". "ColorBlack". Example: "MarkerOne" setMarkerColorLocal "ColorBlack" Category: OFP name setMarkerDir angle Operand types: name: String angle: Number http://www.BIS Game Engine Scripting Commands Page 313 of 415 Example: "Marker1" setMarkerBrushLocal "DiagGrid" Category: OFP marker setMarkerColor color Operand types: marker: String color: String Compatibility: Version 1. "ColorRedAlpha".

Angle is in degrees. The marker is modified on all computers in a network session. Example: "Marker1" setMarkerDir 90 Category: OFP name setMarkerDirLocal angle Operand types: name: String angle: Number Compatibility: Version 2.BIS Game Engine Scripting Commands Page 314 of 415 Compatibility: Version 1.86 required.html 7/11/2010 . The marker is only modified on the computer where the command is called. Type of returned value: Nothing Description: Sets the orientation of the marker.arma2. Type of returned value: Nothing Description: Sets the orientation of the marker.92 required. Example: "MarkerOne" setMarkerPos getMarkerPos "MarkerTwo" Category: OFP markerName setMarkerPosLocal pos http://www. Example: "Marker1" setMarkerDirLocal 90 Category: OFP markerName setMarkerPos pos Operand types: markerName: String pos: Array Type of returned value: Nothing Description: Moves the marker.com/comref/full. The format of pos is Position2D. Angle is in degrees. The marker is modified on all computers in a network session.

Example: "Marker1" setMarkerShapeLocal "RECTANGLE" Category: OFP http://www. Shape can be "ICON". Type of returned value: Nothing Description: Moves the marker. Type of returned value: Nothing Description: Selects the shape (type) of the marker. Type of returned value: Nothing Description: Selects the shape (type) of the marker. The marker is only modified on the computer where the command is called.BIS Game Engine Scripting Commands Page 315 of 415 Operand types: markerName: String pos: Array Compatibility: Version 2. The marker is modified on all computers in a network session.86 required. The format of pos is Position2D. Shape can be "ICON".arma2. The marker is only modified on the computer where the command is called.92 required.com/comref/full. "RECTANGLE" or "ELLIPSE". Example: "MarkerOne" setMarkerPosLocal getMarkerPos "MarkerTwo" Category: OFP name setMarkerShape shape Operand types: name: String shape: String Compatibility: Version 1. Example: "Marker1" setMarkerShape "RECTANGLE" Category: OFP name setMarkerShapeLocal shape Operand types: name: String shape: String Compatibility: Version 2. "RECTANGLE" or "ELLIPSE".92 required.html 7/11/2010 .

Size is in format [a-axis.html 7/11/2010 .86 required. Type of returned value: Nothing Description: Sets the marker size.com/comref/full. The marker is modified on all computers in a network session. Size is in format [a-axis.arma2.BIS Game Engine Scripting Commands Page 316 of 415 marker setMarkerSize size Operand types: marker: String size: Array Compatibility: Version 1.92 required. Example: "MarkerOne" setMarkerSizeLocal [100. 200] Category: OFP marker setMarkerSizeLocal size Operand types: marker: String size: Array Compatibility: Version 2.21 required. http://www. 200] Category: OFP name setMarkerText text Operand types: name: String text: String Compatibility: Version 1. b-axis]. Type of returned value: Nothing Description: Sets the text label of an existing marker. The marker is only modified on the computer where the command is called. Example: "MarkerOne" setMarkerSize [100. b-axis]. Type of returned value: Nothing Description: Sets the marker size. The marker is modified on all computers in a network session.

"Unknown".92 required. "Destroy". "Dot". Category: OFP markerName setMarkerType markerType Operand types: markerName: String markerType: String Type of returned value: Nothing Description: Sets the marker type. "Pickup". "Flag1". "Marker". "Join". Type may be any of: "Flag".com/comref/full.arma2. Example: "MarkerOne" setMarkerType "Arrow" Category: OFP markerName setMarkerTypeLocal markerType Operand types: markerName: String markerType: String Compatibility: Version 2. "Arrow" or "Empty". "Warning". "End". Category: OFP name setMarkerTextLocal text Operand types: name: String text: String Compatibility: Version 2.html 7/11/2010 . Example: "Marker1" setMarkerTextLocal You are here.BIS Game Engine Scripting Commands Page 317 of 415 Example: "Marker1" setMarkerText You are here.92 required. "Start". Type of returned value: http://www. Type of returned value: Nothing Description: Sets the text label of an existing marker. The marker is only modified on the computer where the command is called. The marker is modified on all computers in a network session.

"Start". "Cynic". The following values are recognized: "Default".arma2.com/comref/full. The marker is only modified on the computer where the command is called. "Dot". "Surprised". Type of returned value: Nothing Description: Move (UI) mouse pointer to specified position of the screen. y] Operand types: [x. Example: setMousePosition [0. "Unknown". "Destroy".5] Category: OFP trigger or waypoint setMusicEffect track Operand types: trigger or waypoint: Object or Array track: String http://www. "Flag1". Type may be any of: "Flag". y]: Array Compatibility: Version 2. "Hurt". "Ironic". Example: setMimic "Angry" Category: OFP setMousePosition [x.html 7/11/2010 . "Warning".BIS Game Engine Scripting Commands Page 318 of 415 Nothing Description: Sets the marker type.91 required. "Agresive" and "Angry". "End". "Sad". "Smile". "Arrow" or "Empty". "Normal".5. "Pickup". "Marker". "Join". Example: "MarkerOne" setMarkerTypeLocal "Arrow" Category: OFP person setMimic mimic Operand types: person: Object mimic: String Type of returned value: Nothing Description: Sets a unit's mimic. 0.

[name1.92 required.90 required. Category: Editor map setObjectProxy [object.BIS Game Engine Scripting Commands Page 319 of 415 Compatibility: Version 1.92 required. . Track is a subclass name of CfgMusic. "$NONE$" (no change) or "$STOP$" (stops the current music track)..arma2. . Type of returned value: Any Description: Set object arguments in mission editor.html 7/11/2010 .]] Operand types: map: Control [object. value1. proxy object]: Array Compatibility: Version 2. Type of returned value: Nothing Description: Defines the music track played on activation..]]: Array Compatibility: Version 2.86 required. Type of returned value: Nothing Description: Set which global variable will contain given location. Category: Location map setObjectArguments [object. http://www. proxy object] Operand types: map: Control [object.. [name1.com/comref/full. value1.. Example: trigger setMusicEffect "Track1" Category: OFP location setName name Operand types: location: Location name: String Compatibility: Version 2.

BIS Game Engine Scripting Commands Page 320 of 415 Type of returned value: Any Description: Set the proxy object associated with the given editor object. velocity]: Array Compatibility: Version 2. storms and showers are very likely.arma2. Type of returned value: Nothing Category: Resistance time setOvercast overcast Operand types: time: Number overcast: Number Type of returned value: Nothing Description: Changes the overcast level to the given value smoothly during the given time (in seconds). Type of returned value: Nothing Description: Update particle source to create particles on circle with given radius. Example: 1800 setOvercast 0. Velocity is transformed and http://www. An overcast level of zero means clear (sunny) weather and with an overcast level of one.5 Category: OFP particleSource setParticleCircle [radius. velocity] Operand types: particleSource: Object [radius.75 required.html 7/11/2010 .56 required. A time of zero means an immediate change.com/comref/full. Category: Editor object setObjectTexture texture Operand types: object: Object texture: Array Compatibility: Version 1.

com/comref/full. Type of returned value: Nothing Description: Set randomization of particle source parameters. rotationVelocity. randomDirectionPeriod. randomDirectionIntensity.arma2. randomDirectionIntensity. color. rotationVelocity.56 required.56 required. {angle}] Operand types: particleSource: Object [lifeTime. position. Array is in format ParticleArray. Category: OFP particleSource setParticleRandom [lifeTime.html 7/11/2010 . Example: setPlayable aP http://www. Category: OFP setPlayable unit Operand types: unit: Object Compatibility: Version 2. {angle}]: Array Compatibility: Version 2. moveVelocity. Category: OFP particleSource setParticleParams array Operand types: particleSource: Object array: Array Compatibility: Version 2. randomDirectionPeriod.92 required. position. size.BIS Game Engine Scripting Commands Page 321 of 415 added to total velocity. color. Type of returned value: Nothing Description: Set parameters to particle source. moveVelocity. size. Type of returned value: Nothing Description: Create MP role for the unit.

Example: player setPosASL [getposASL player select 0. Type of returned value: Nothing Description: Sets the object position.arma2. getposASL player select 1 + 10.53 required. getpos player select 1 + 10] Category: OFP obj setPosASL pos Operand types: obj: Object pos: Array Compatibility: Version 2.BIS Game Engine Scripting Commands Page 322 of 415 Category: OFP obj setPos pos Operand types: obj: Object pos: Array Type of returned value: Nothing Description: Sets the object position. The pos array uses the PositionASL format. The version of the command does not offset based on object center.html 7/11/2010 . The pos array uses the PositionASL format. Example: player setPos [getpos player select 0. The pos array uses the Position format. getPosASL select 2] Category: OFP obj setPosASL2 pos Operand types: obj: Object pos: Array Compatibility: Version 2.53 required. Type of returned value: Nothing Description: Sets the object position. Example: http://www.com/comref/full.

A time of zero means an immediate change. Type of returned value: Nothing Description: Changes the rain density smoothly during the given time (in seconds). Type of returned value: Nothing Description: Set a new position of given location. A rain level of zero is no rain and a rain level of one is maximum rain.BIS Game Engine Scripting Commands Page 323 of 415 player setPosASL [getposASL player select 0.7. Example: 0 setRadioMsg "Alpha Radio" Category: OFP time setRain rainDensity Operand types: time: Number rainDensity: Number Compatibility: Version 1. getposASL player select 1 + 10.90 required. 0. Rain is not possible when overcast is smaller than 0.75 required. Use "NULL" to disable the radio slot. map radio) to the given text. Example: http://www.arma2. getPosASL select 2] Category: OFP location setPosition position Operand types: location: Location position: Array Compatibility: Version 2. Category: Location index setRadioMsg text Operand types: index: Number text: String Type of returned value: Nothing Description: Sets the radio message (0.html 7/11/2010 .com/comref/full.

arma2.com/comref/full. MAJOR or COLONEL. CORPORAL. Possible values: PRIVATE.html 7/11/2010 . LIEUTENANT. Type of returned value: Nothing Description: Set if given location has rectangular shape.92 required. Category: Location vehicle setRepairCargo amount Operand types: vehicle: Object amount: Number Type of returned value: Nothing Description: Sets the amount or repair resources in the cargo space of a repair vehicle. SERGEANT. Example: player setRank "COLONEL" Category: OFP location setRectangular rectangular Operand types: location: Location rectangular: Boolean Compatibility: Version 2. Type of returned value: Nothing Description: Sets rank of given unit.BIS Game Engine Scripting Commands Page 324 of 415 60 setRain 1 Category: OFP unit setRank rank Operand types: unit: Object rank: String Compatibility: Version 2. Example: http://www. An amount of one is a full cargo space.90 required. CAPTAIN.

Category: Identity task setSimpleTaskDestination position Operand types: task: Task position: Array Compatibility: Version 5500 required. Category: Identity http://www. descriptionHUD]: Array Compatibility: Version 5500 required. Type of returned value: Nothing Description: Set a new target side of given location. Type of returned value: Nothing Description: Attach descriptions to the simple task. descriptionShort.com/comref/full.arma2.BIS Game Engine Scripting Commands Page 325 of 415 repairTruckOne setRepairCargo 0 Category: OFP location setSide side Operand types: location: Location side: Side Compatibility: Version 2. Type of returned value: Nothing Description: Attach a destination to the simple task. descriptionShort.90 required.html 7/11/2010 . descriptionHUD] Operand types: task: Task [description. Category: Location task setSimpleTaskDescription [description.

Type of returned value: Nothing Description: Set a new size (width.BIS Game Engine Scripting Commands Page 326 of 415 location setSize [sizeX. 1] Category: OFP PC http://www. sizeZ] Operand types: location: Location [sizeX. skill] Operand types: vehicle: Object [type. Value of skill may vary from 0 to 1.html 7/11/2010 . Example: hero setSkill ["Endurance".90 required. skill]: Array Compatibility: Version 2.65 required. Type of returned value: Nothing Description: Sets skill of given type of person (commander unit). Type of returned value: Nothing Description: Sets ability levell of person (commander unit).arma2.com/comref/full. Value of skill may vary from 0 to 1. sizeZ]: Array Compatibility: Version 2.75 required. Example: hero setSkill 1 Category: Resistance vehicle setSkill [type. Category: Location vehicle setSkill skill Operand types: vehicle: Object skill: Number Compatibility: Version 1. height) of given location.

BIS Game Engine Scripting Commands Page 327 of 415 trigger or waypoint setSoundEffect [sound. Example: player setTargetAge "10 MIN" http://www. "30 MIN".32 required. "120 MIN" or "UNKNOWN". soundEnv. Example: trigger setSoundEffect ["Alarm". Possible age values are: "ACTUAL". voice. ""] Category: OFP group setSpeedMode mode Operand types: group: Object or Group mode: String Type of returned value: Nothing Description: Sets the group speed mode.86 required. "". "60 MIN".com/comref/full. "". "5 MIN". "10 MIN". They behave like the target was seen age seconds ago. soundEnv. voice. maintain formation) or "FULL" (do not wait for any other units in the formation). Mode may be one of: "LIMITED" (half speed).arma2. soundDet]: Array Compatibility: Version 1. Example: groupOne setSpeedMode "LIMITED" Category: OFP object setTargetAge age Operand types: object: Object age: String Compatibility: Version 2. "NORMAL" (full speed. Type of returned value: Nothing Description: Sets how the target is known to the other centers.html 7/11/2010 . Sound / voice plays a 2D / 3D sound from CfgSounds. Type of returned value: Nothing Description: Defines the different sound effects. SoundDet (only for triggers) creates a dynamic sound object attached to a trigger defined in CfgSFX. SoundEnv plays an enviromental sound from CfgEnvSounds. "15 MIN". soundDet] Operand types: trigger or waypoint: Object or Array [sound.

Type of returned value: Nothing Description: Set a result of the task.125.com/comref/full.92 required. Category: Identity task setTaskState state Operand types: task: Task state: String Compatibility: Version 2.25 and 3.75 required.5 Category: OFP http://www. 12.89 required. Category: Identity setTerrainGrid grid Operand types: grid: Number Compatibility: Version 1. result] Operand types: task: Task [state. the nearest supported resolution is used instead. 6. 25.5.arma2. For default landscapes the supported resolutions are: 50. Example: setTerrainGrid 12.BIS Game Engine Scripting Commands Page 328 of 415 Category: OFP task setTaskResult [state.html 7/11/2010 . Type of returned value: Nothing Description: Sets the desired terrain resolution (in meters). If you select an unsupported resolution. Type of returned value: Nothing Description: Set a new state of the task. result]: Array Compatibility: Version 2.

text]: Array Compatibility: Version 1. "LOGIC". "CIV". "EAST". "WEST". type. "GROUP". "HOTEL". "LEADER" or "MEMBER". Text is shown as text itself."] Category: OFP trigger setTriggerActivation [by.com/comref/full. vehicle or group member): "NONE". repeating] Operand types: trigger: Object [by. "ALPHA".90 required. For "TEXT". "ECHO". "STATIC". Type can be "NONE". Category: Location trigger or waypoint setTitleEffect [type. Type of returned value: Nothing Description: Defines the trigger activation type. "OBJECT". "FOXTROT".86 required. Type of returned value: Nothing Description: Defines the title effect. "VEHICLE". a subclass of CfgTitles. "BLACK IN". type. radio. "WHITE OUT" or "WHITE IN". text defines a resource class.86 required. effect. "PLAIN DOWN". "GUER".who activates trigger (side. "ANY". effect. "PLAIN DOWN". "INDIA". "BRAVO". "DELTA".BIS Game Engine Scripting Commands Page 329 of 415 location setText text Operand types: location: Location text: String Compatibility: Version 2. a subclass of RscTitles. text defines the shown object. "GOLF". Type of returned value: Nothing Description: Set a new text attached to given location. the effect defines a subtype: "PLAIN".arma2.html 7/11/2010 . "JULIET". For "OBJECT". The first argument . text] Operand types: trigger or waypoint: Object or Array [type. "BLACK". "BLACK OUT". The second argument - http://www. "RES" or "TEXT". Example: trigger setTitleEffect ["TEXT". "BLACK FADED". repeating]: Array Compatibility: Version 1. "Hello world. For "RES". "CHARLIE".

"ok = false"] Category: OFP trigger setTriggerText text http://www. activ. The third argument . Activ and desactiv expressions are launched upon trigger activation / deactivation.arma2. desactiv]: Array Compatibility: Version 1. Example: trigger setTriggerArea [100. The area is rectangular or elliptic. "EAST D". It is rotated angle degrees. activ. "EAST D".html 7/11/2010 . true] Category: OFP trigger setTriggerArea [a. Variable thisList contains all vehicles which caused the activation. b. "GUER D" or "CIV D". "WEST D". angle. rectangle]: Array Compatibility: Version 1. angle.whether the activation is repeating. desactiv] Operand types: trigger: Object [cond. Example: trigger setTriggerActivation ["WEST". false] Category: OFP trigger setTriggerStatements [cond.com/comref/full. "ok = true". b. Example: trigger setTriggerStatements ["this".86 required. 45. Type of returned value: Nothing Description: The first argument can modify the condition of when the trigger is activated. Type of returned value: Nothing Description: Defines the area controlled by the trigger. the height is 2 * b.86 required.BIS Game Engine Scripting Commands Page 330 of 415 when is it activated (presention or detection by the specified side): "PRESENT". rectangle] Operand types: trigger: Object [a. The result of the activation defined by trigger activation is in variable this. 50. the width is 2 * a. "NOT PRESENT".

Type of returned value: Nothing Description: Defines the time between condition satisfaction and trigger activation (randomly from min to max. interruptable]: Array Compatibility: Version 1. Example: trigger setTriggerTimeout [5.arma2. If the last argument is true. Example: trigger setTriggerType "END1" http://www.html 7/11/2010 . "END2". This is used for example as a radio slot label for radio activated triggers. "SWITCH". "END6".BIS Game Engine Scripting Commands Page 331 of 415 Operand types: trigger: Object text: String Compatibility: Version 1. a waypoints switch or an end of mission): "NONE". "LOOSE" or "WIN".86 required. mid. the condition must be fullfilled all the time. Type of returned value: Nothing Description: Sets the text label attached to the trigger object. interruptable] Operand types: trigger: Object [min. "END3". 10. max. Type of returned value: Nothing Description: Sets the type of action processed by the trigger after activation (no action.com/comref/full. "END1". "END4". "END5". mid. Example: trigger setTriggerText "Call for support" Category: OFP trigger setTriggerTimeout [min.86 required. 7. max. with an average value mid). false] Category: OFP trigger setTriggerType action Operand types: trigger: Object action: String Compatibility: Version 1.86 required.

33 required.com/comref/full. Type of returned value: Nothing Description: Set a new type of given location.0 Category: OFP http://www.arma2. Example: player setUnitSkill 1.0.2 to 1. Type of returned value: Nothing Description: Set / reset the unconscious life state of the given unit (in MP works only for a local unit).90 required. Category: Location unit setUnconscious set Operand types: unit: Object set: Boolean Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 332 of 415 Category: OFP location setType type Operand types: location: Location type: String Compatibility: Version 2. Skill may vary from 0. Category: OFP unit setUnitAbility skill Operand types: unit: Object skill: Number Compatibility: Version 2. Type of returned value: Nothing Description: Sets skill of given unit.html 7/11/2010 .

BIS Game Engine Scripting Commands Page 333 of 415 unit setUnitPos mode Operand types: unit: Object mode: String Type of returned value: Nothing Description: Sets the unit position rules. LIEUTENANT.33 required. "UP" or "AUTO". CAPTAIN.com/comref/full. Type of returned value: Nothing Description: Sets rank of given unit. MAJOR or COLONEL. Example: soldierOne setUnitPosWeak "Down" Category: OFP unit setUnitRank rank Operand types: unit: Object rank: String Compatibility: Version 2. SERGEANT. Mode may be one of: "DOWN".arma2. Example: player setUnitRank "COLONEL" Category: OFP http://www. CORPORAL. Possible values: PRIVATE. Example: soldierOne setUnitPos "Down" Category: OFP unit setUnitPosWeak mode Operand types: unit: Object mode: String Compatibility: Version 5117 required.html 7/11/2010 . for usage in formation FSM (to avoid collision with setUnitPos used by the mission). Type of returned value: Nothing Description: Equal to setUnitPos.

BIS Game Engine Scripting Commands Page 334 of 415 namespace setVariable [name. public]: Array Compatibility: Version 2. public] Operand types: object: Object [name. Category: OFP map setVariable [name.com/comref/full. Type of returned value: Nothing Description: Set variable to given value in the variable space of given object. Type of returned value: Nothing Description: Set variable to given value in the variable space of given group. Category: OFP object setVariable [name. value.92 required. value. If public is true then the value is broadcast to all computers. Type of returned value: Nothing Description: Set variable to given value in the given namespace. Category: Default group setVariable [name. value] Operand types: group: Group [name.arma2. If public is true then the value is broadcast to all computers. value] http://www.html 7/11/2010 . value]: Array Compatibility: Version 5501 required. value]: Array Compatibility: Version 5501 required. value] Operand types: namespace: Namespace [name.

92 required. z.BIS Game Engine Scripting Commands Page 335 of 415 Operand types: map: Control [name. Category: Identity location setVariable [name. Type of returned value: Nothing Description: Set variable to given value in the variable space of given task. Category: Location object setVectorDir [x. value]: Array Compatibility: Version 2. Type of returned value: Nothing Description: Set variable to given value in the variable space of given map.arma2. y] Operand types: object: Object [x. y]: Array Compatibility: Version 2.html 7/11/2010 . Type of returned value: http://www. value]: Array Compatibility: Version 2.92 required. Type of returned value: Nothing Description: Set variable to given value in the variable space of given location.com/comref/full. value] Operand types: location: Location [name. value] Operand types: task: Task [name. Category: Editor task setVariable [name.61 required. z.92 required. value]: Array Compatibility: Version 2.

com/comref/full. Direction vector will remain unchanged. y].arma2. y] Operand types: object: Object [x.html 7/11/2010 . z]] Operand types: object: Object [[x. The value ranges from 0 to 1. Type of returned value: Nothing Description: Sets how much ammunition (compared to the current configuration of magazines. y]. y. z]]: Array Compatibility: Version 5164 required. y]: Array Compatibility: Version 2. Example: http://www. but fully loaded) the vehicle has. z. Category: OFP object setVehicleAmmo value Operand types: object: Object value: Number Compatibility: Version 2.[x. Type of returned value: Nothing Description: Set object's direction and up vector Category: OFP object setVectorUp [x. y. z.[x.BIS Game Engine Scripting Commands Page 336 of 415 Nothing Description: Set object's direction vector. z. z. Type of returned value: Nothing Description: Set object's up vector. Category: OFP object setVectorDirAndUp [[x. Up vector will remain unchanged.32 required.61 required.

33 required. Type of returned value: Nothing Description: Sets the armor (or health for men) state of the vehicle (a value from 0 to 1). By this id vehicle is referenced by triggers and waypoints. Example: player setVehicleId 1 Category: OFP vehicle setVehicleInit statement Operand types: vehicle: Object statement: String Compatibility: Version 2. Example: player setVehicleArmor 0.html 7/11/2010 .32 required. Type of returned value: Nothing Description: Sets id (integer value) to vehicle.arma2.BIS Game Engine Scripting Commands Page 337 of 415 player setVehicleAmmo 0 Category: OFP object setVehicleArmor value Operand types: object: Object value: Number Compatibility: Version 2.33 required. Type of returned value: Nothing Description: http://www.com/comref/full.5 Category: OFP object setVehicleId id Operand types: object: Object id: Number Compatibility: Version 2.

BIS Game Engine Scripting Commands

Page 338 of 415

Execute statement attached to vehicle. This statement is also propagated over network in MP games. Example: soldier3 setVehicleInit "this allowfleeing 0" Category: OFP

vehicle setVehicleLock state
Operand types: vehicle: Object state: String Compatibility: Version 2.33 required. Type of returned value: Nothing Description: Set how vehicle is locked for player. Possible values: UNLOCKED, DEFAULT or LOCKED. Example: veh1 setVehicleLock "LOCKED" Category: OFP

object setVehiclePosition [position, markers, placement]
Operand types: object: Object [position, markers, placement]: Array Compatibility: Version 2.32 required. Type of returned value: Nothing Description: Changes the object position. If the markers array contains more than one marker names, the position of a random one is used. Otherwise, the given position is used. The object is placed inside a circle with this position as its center and placement as its radius. Example: player setVehiclePosition [[0, 0, 0], ["Marker1"], 0] Category: OFP

object setVehicleVarName name
Operand types: object: Object

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 339 of 415

name: String Compatibility: Version 2.32 required. Type of returned value: Nothing Description: Sets the name of the variable which contains a reference to this object. It is necessary in MP to change the variable content after a respawn. Example: player setVehicleVarName "aP" Category: OFP

vehicle setVelocity [x, z, y]
Operand types: vehicle: Object [x, z, y]: Array Compatibility: Version 1.80 required. Type of returned value: Nothing Description: Sets the velocity (speed vector) of a vehicle. Category: OFP

setViewDistance distance
Operand types: distance: Number Type of returned value: Nothing Description: Sets the rendering distance. Default is 900 meters. The accepted range is from 500 to 5000 meters. Example: setviewdistance 2000 Category: OFP

map setVisibleIfTreeCollapsed [object, visible if tree collapsed]
Operand types: map: Control [object, visible if tree collapsed]: Array Compatibility:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 340 of 415

Version 2.92 required. Type of returned value: Nothing Description: Sets whether or not the object is visible even if the tree is collapsed. Category: Editor

waypoint setWaypointBehaviour mode
Operand types: waypoint: Array mode: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Switches the unit behaviour when the waypoint becomes active. Possible values are: "UNCHANGED", "CARELESS", "SAFE", "AWARE", "COMBAT" and "STEALTH". Example: [grp, 2] setWaypointBehaviour "AWARE" Category: OFP

waypoint setWaypointCombatMode mode
Operand types: waypoint: Array mode: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: The group combat mode is switched when the waypoint becomes active. Possible values are: "NO CHANGE", "BLUE", "GREEN", "WHITE", "YELLOW" and "RED". Example: [grp, 2] setWaypointCombatMode "RED" Category: OFP

waypoint setWaypointCompletionRadius radius
Operand types: waypoint: Array

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 341 of 415

radius: Number Compatibility: Version 5500 required. Type of returned value: Nothing Description: Set the radius around the waypoint where is the waypoint completed. Example: [grp, 2] setWaypointCompletionRadius 30 Category: OFP

waypoint setWaypointDescription text
Operand types: waypoint: Array text: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Sets the description shown in the HUD while the waypoint is active. Example: [grp, 2] setWaypointDescription "Move here." Category: OFP

waypoint setWaypointFormation formation
Operand types: waypoint: Array formation: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Switches the group formation when the waypoint becomes active. Possible values are: "NO CHANGE", "COLUMN", "STAG COLUMN", "WEDGE", "ECH LEFT", "ECH RIGHT", "VEE" and "LINE". Example: [grp, 2] setWaypointFormation "LINE" Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 342 of 415

waypoint setWaypointHousePosition pos
Operand types: waypoint: Array pos: Number Compatibility: Version 1.86 required. Type of returned value: Nothing Description: For waypoints attached to a house, this defines the target house position. Example: [grp, 2] setWaypointHousePosition 1 Category: OFP

waypoint setWaypointPosition [center, radius]
Operand types: waypoint: Array [center, radius]: Array Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Moves the waypoint to a random position in a circle with the given center and radius. Example: [grp, 2] setWaypointPosition [position player, 0] Category: OFP

waypoint setWaypointScript command
Operand types: waypoint: Array command: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Attaches a script to a scripted waypoint. Command consist of a script name and additional script arguments. Example: [grp, 2] setWaypointScript "find.sqs player" Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 343 of 415

waypoint setWaypointSpeed mode
Operand types: waypoint: Array mode: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Switches the group speed mode when the waypoint becomes active. Possible values are: "UNCHANGED", "LIMITED", "NORMAL" and "FULL". Example: [grp, 2] setWaypointSpeed "FULL" Category: OFP

waypoint setWaypointStatements [condition, statement]
Operand types: waypoint: Array [condition, statement]: Array Compatibility: Version 1.86 required. Type of returned value: Nothing Description: The waypoint is done only when the condition is fulfilled. When the waypoint is done, the statement expression is executed. Example: [grp, 2] setWaypointStatements ["true", ""] Category: OFP

waypoint setWaypointTimeout [min, mid, max]
Operand types: waypoint: Array [min, mid, max]: Array Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Defines the time between condition satisfaction and waypoint finish (randomly from min to max, with an average value mid).

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 344 of 415

Example: [grp, 2] setWaypointTimeout [5, 10, 6] Category: OFP

waypoint setWaypointType type
Operand types: waypoint: Array type: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Changes the waypoint type. Type can be: "MOVE", "DESTROY", "GETIN", "SAD", "JOIN", "LEADER", "GETOUT", "CYCLE", "LOAD", "UNLOAD", "TR UNLOAD", "HOLD", "SENTRY", "GUARD", "TALK", "SCRIPTED", "SUPPORT", "GETIN NEAREST", "AND" or "OR". Example: [grp, 2] setWaypointType "HOLD" Category: OFP

setWind [x, z, forced]
Operand types: [x, z, forced]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Set current (forced == false) or permanent (forced == true) wind direction and force. Category: OFP

wapoint setWPPos position
Operand types: wapoint: Array position: Array Compatibility: Version 1.21 required. Type of returned value: Nothing Description: Sets the waypoint position. Waypoint uses format Waypoint. Position uses format Position2D.

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 345 of 415

Example: [groupOne, 1] setWPPos getMarkerPos "MarkerOne" Category: OFP

map show3DIcons bool
Operand types: map: Control bool: Boolean Compatibility: Version 2.92 required. Type of returned value: Nothing Description: Toggle the drawing of 3D icons. Category: Editor

showCinemaBorder show
Operand types: show: Boolean Type of returned value: Nothing Description: Forces drawing of the cinema borders. This is normally used in cutscenes to indicate the player has no control. Category: OFP

showCommandingMenu class name
Operand types: class name: String Compatibility: Version 5500 required. Type of returned value: Nothing Description: Create the commanding menu described by the given config class. When class name is empty, current commanding menu is hidden. Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

92 required.arma2. Type of returned value: Nothing Description: Enable / disable showing of HUD.com/comref/full. Category: Editor http://www.BIS Game Engine Scripting Commands Page 346 of 415 showCompass show Operand types: show: Boolean Type of returned value: Nothing Description: Enables the compass (the default is true).html 7/11/2010 . Type of returned value: Nothing Description: Show/hide map legend. Category: OFP showGps show Operand types: show: Boolean Type of returned value: Nothing Description: Enables the GPS receiver (the default is false). Category: OFP showHUD enable Operand types: enable: Boolean Compatibility: Version 5501 required. Category: OFP map showLegend bool Operand types: map: Control bool: Boolean Compatibility: Version 2.

BIS Game Engine Scripting Commands

Page 347 of 415

showMap show
Operand types: show: Boolean Type of returned value: Nothing Description: Enables the map (the default is true). Example: showMap true Category: OFP

shownCompass
Type of returned value: Boolean Description: Checks whether the player has the compass enabled. Category: OFP

map showNewEditorObject [type, class, side, position]
Operand types: map: Control [type, class, side, position]: Array Compatibility: Version 2.92 required. Type of returned value: Any Description: Show the add editor object dialog, type is editor object type, class is class definition to automatically select, side filters by a certain side, pos is position to create the object. Category: Editor

shownGps
Type of returned value: Boolean Description: Checks whether the player has the GPS receiver enabled. Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 348 of 415

shownMap
Type of returned value: Boolean Description: Checks whether the player has the map enabled. Category: OFP

shownPad
Type of returned value: Boolean Description: Checks whether the player has the notebook enabled. Category: OFP

shownRadio
Type of returned value: Boolean Description: Checks whether the player has the radio transmitter enabled. Category: OFP

shownWarrant
Type of returned value: Boolean Description: Checks whether the player has the ID card enabled. (Obsolete). Category: OFP

shownWatch
Type of returned value: Boolean Description: Checks whether the player has the watch enabled. Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 349 of 415

showPad show
Operand types: show: Boolean Type of returned value: Nothing Description: Enables the notepad (the default is true). Category: OFP

showRadio show
Operand types: show: Boolean Type of returned value: Nothing Description: Enables the radio (the default is false). Category: OFP

showSubtitles enable
Operand types: enable: Boolean Compatibility: Version 5501 required. Type of returned value: Boolean Description: Enable / disable showing of subtitles. Return the previous state. Category: OFP

showWarrant show
Operand types: show: Boolean Type of returned value: Nothing Description: Obsolete. Enables the ID card (the default is false). Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 350 of 415

showWatch show
Operand types: show: Boolean Type of returned value: Nothing Description: Enables the watch (the default is true). Category: OFP

waypoint showWaypoint show
Operand types: waypoint: Array show: String Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Sets the condition determining when the waypoint is shown. Possible values are: "NEVER", "EASY" and "ALWAYS". Example: [grp, 2] showWaypoint "ALWAYS" Category: OFP

side location
Operand types: location: Location Compatibility: Version 2.90 required. Type of returned value: Side Description: Return target side of given location. Category: Location

side unit
Operand types: unit: Object

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 351 of 415

Type of returned value: Side Description: Returns the side of the unit. Example: side player == west Category: OFP

side group
Operand types: group: Group Compatibility: Version 5501 required. Type of returned value: Side Description: Returns the side of the group. Example: side group player == west Category: OFP

unit sideChat chatText
Operand types: unit: Object or Array chatText: String Type of returned value: Nothing Description: Types text to the side radio channel. Note: this function only types text to the list, it does not broadcast the message. If you want the message to show on all computers, you have to execute it on all of them. Example: soldierOne sideChat "Show this text" Category: OFP

sideEnemy
Compatibility: Version 1.78 required. Type of returned value:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 352 of 415

Side Description: The Enemy side (used for renegades). Category: OFP

sideFriendly
Compatibility: Version 1.78 required. Type of returned value: Side Description: The Friendly side (used for captives). Category: OFP

sideLogic
Compatibility: Version 1.86 required. Type of returned value: Side Description: The Logic side. Category: OFP

unit sideRadio radioName
Operand types: unit: Object or Array radioName: String Type of returned value: Nothing Description: Sends the message to the side radio channel. The message is defined in the description.ext file or radio protocol. Example: soldierOne sideRadio "messageOne" Category: OFP

sideUnknown

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 353 of 415

Compatibility: Version 5501 required. Type of returned value: Side Description: The unknown side. Category: OFP

simpleTasks person
Operand types: person: Object Compatibility: Version 5501 required. Type of returned value: Array Description: Return all simple tasks assigned to given person. Category: Identity

simulationEnabled entity
Operand types: entity: Object Compatibility: Version 5500 required. Type of returned value: Boolean Description: Check if the entity has enabled simulation. Category: OFP

sin x
Operand types: x: Number Type of returned value: Number Description: The sine of x, the argument is in degrees. Example: sin 30 , result is 0.5 Category: Default

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 354 of 415

size location
Operand types: location: Location Compatibility: Version 2.90 required. Type of returned value: Array Description: Return size of given location (width, height). Category: Location

sizeOf typeName
Operand types: typeName: String Compatibility: Version 5160 required. Type of returned value: Number Description: Return the size of the entity of given type. Category: OFP

skill person
Operand types: person: Object Compatibility: Version 1.75 required. Type of returned value: Number Description: Returns the current level of ability of the person. Example: skill player Category: Resistance

vehicle skill type
Operand types: vehicle: Object

http://www.arma2.com/comref/full.html

7/11/2010

65 required. Value of skill may vary from 0 to 1. Duration is in hours.com/comref/full. Type of returned value: Number Description: Returns skill of given type of person (commander unit).60 required. Example: skipTime 2. Example: hero skill "Endurance" Category: OFP PC skipTime duration Operand types: duration: Number Type of returned value: Nothing Description: Skips the specified time. Example: sleep 0. Daytime is adjusted. a weather change is estimated and no changes to any units are done.html 7/11/2010 . Type of returned value: Nothing Description: Suspend execution of script for given time.arma2.5 Category: OFP sleep delay Operand types: delay: Number Compatibility: Version 2.5 Category: OFP sliderPosition idc Operand types: idc: Number http://www.BIS Game Engine Scripting Commands Page 355 of 415 type: String Compatibility: Version 2.

Type of returned value: Array Description: Returns the limits (as an array [min. Type of returned value: Number Description: Returns the current thumb position of the given slider.79 required. Example: _pos = sliderPosition 101 Category: Resistance sliderPosition control Operand types: control: Control Compatibility: Version 2. max]) of the slider with id idc of the topmost user dialog.92 required.BIS Game Engine Scripting Commands Page 356 of 415 Compatibility: Version 1. Example: _limits = sliderRange 100 Category: Resistance sliderRange control Operand types: control: Control http://www. Example: _pos = sliderPosition _control Category: OFP PC sliderRange idc Operand types: idc: Number Compatibility: Version 1. Type of returned value: Number Description: Returns the current thumb position of the slider with id idc of the topmost user dialog.79 required.com/comref/full.arma2.html 7/11/2010 .

Type of returned value: Nothing Description: Sets the current thumb position of the given slider. pos] Operand types: [idc. min. Type of returned value: Array Description: Returns the limits (as an array [min.92 required.79 required.html 7/11/2010 . pos]: Array Compatibility: Version 1. max]) of the given slider. 0] Category: Resistance control sliderSetPosition pos Operand types: control: Control pos: Number Compatibility: Version 2. max] Operand types: http://www. Example: sliderSetPosition [100. Type of returned value: Nothing Description: Sets the current thumb position of the slider with id idc of the topmost user dialog. Example: _limits = sliderRange _control Category: OFP PC sliderSetPosition [idc.com/comref/full.92 required.BIS Game Engine Scripting Commands Page 357 of 415 Compatibility: Version 2. Example: _control sliderSetPosition 0 Category: OFP PC sliderSetRange [idc.arma2.

arma2. line. Type of returned value: Nothing Description: Sets the limits of the slider with id idc of the topmost user dialog. 0. 2. max] Operand types: control: Control [min.0] Category: Resistance control sliderSetSpeed [line. 0. Type of returned value: Nothing Description: Sets the limits of the slider with id idc of the given slider.79 required. min. 10] Category: OFP PC sliderSetSpeed [idc.92 required. Example: sliderSetRange [100. Example: sliderSetSpeed [100. page] http://www. A click on the scale outside the thumb results in a move per page) of the slider with id idc of the topmost user dialog.BIS Game Engine Scripting Commands Page 358 of 415 [idc.html 7/11/2010 .5. 10] Category: Resistance control sliderSetRange [min. page] Operand types: [idc. max]: Array Compatibility: Version 1. line. Type of returned value: Nothing Description: Sets the speed (a click on the arrow results in a move per line. max]: Array Compatibility: Version 2.com/comref/full. Example: _control sliderSetRange [0.79 required. page]: Array Compatibility: Version 1.

html 7/11/2010 . Example: _control sliderSetSpeed [0.0] Category: OFP PC sliderSpeed idc Operand types: idc: Number Compatibility: Version 1. 2. page]) of the slider with id idc of the topmost user dialog. Type of returned value: Array Description: Returns the speed (as an array [line.BIS Game Engine Scripting Commands Page 359 of 415 Operand types: control: Control [line. Example: _speed = sliderSpeed Category: Resistance sliderSpeed control Operand types: control: Control Compatibility: Version 2.92 required. Type of returned value: Array Description: Returns the speed (as an array [line. Type of returned value: Nothing Description: Sets the speed (a click on the arrow results in a move per line.92 required. A click on the scale outside the thumb results in a move per page) of the given slider. page]: Array Compatibility: Version 2.5.79 required. Example: _speed = sliderSpeed _control Category: OFP PC someAmmo unit http://www.com/comref/full. page]) of the given slider.arma2.

50 required. Category: OFP speed obj Operand types: obj: Object Type of returned value: Number Description: Returns the object speed (in km/h). Argument is passed to the script as local variable _this. Example: speed player Category: OFP http://www. Category: OFP arguments spawn script Operand types: arguments: Any script: Code Compatibility: Version 2.html 7/11/2010 . Type of returned value: Script Description: Executes a script.BIS Game Engine Scripting Commands Page 360 of 415 Operand types: unit: Object Type of returned value: Boolean Description: Checks whether the unit has some ammo remaining. Example: someAmmo vehicle player Category: OFP soundVolume Type of returned value: Number Description: Checks the current sound volume (set by setSoundVolume).arma2.com/comref/full.

/: for type http://www.html 7/11/2010 .arma2. result is 3 Category: Default startLoadingScreen [text] or [text. Example: sqrt 9 . "NORMAL" or "FULL").com/comref/full. Type of returned value: Nothing Description: Shows loading screen with the given text./ step step Operand types: for /. using the given resource.. When loading screen is shown.. Category: OFP for /.BIS Game Engine Scripting Commands Page 361 of 415 speedMode grp Operand types: grp: Object or Group Type of returned value: String Description: Returns the speed mode of the group ("LIMITED". Example: speedMode group player Category: OFP sqrt x Operand types: x: Number Type of returned value: Number Description: The square root of x. resource]: Array Compatibility: Version 5501 required. simulation and scene drawing is disabled. resource] Operand types: [text] or [text... scripts run at full speed.

. Example: for "_x" from 20 to 10 step -2 do {. If you want to count down. This function is obsolete. Example: stopped jeepOne Category: OFP str any value Operand types: any value: Any Compatibility: Version 2.html 7/11/2010 .com/comref/full. Default value is 1. Use disableAI to get better control over stopping a unit. Type of returned value: http://www. Example: soldierOne stop true Category: OFP stopped unit Operand types: unit: Object Type of returned value: Boolean Description: Checks whether the unit is stopped using the "stop" command.arma2. and set negative.BIS Game Engine Scripting Commands Page 362 of 415 step: Number Type of returned value: for type Description: Optionaly can set step. step must be specified.code.00 required..} Category: Default unit stop stop Operand types: unit: Object stop: Boolean Type of returned value: Nothing Description: Stops an AI unit.

Example: supportInfo "b:select*" . t:name* or *:*. type of input operands is included). y]: Array Compatibility: Version 2. result is ["b:ARRAY select SCALAR".00 required.arma2. 'n' . result is "5" Category: Default supportInfo mask Operand types: mask: String Compatibility: Version 2.unary operator.html 7/11/2010 . http://www. t:*. Type of returned value: Array Description: Creates list of supported operators and type.BIS Game Engine Scripting Commands Page 363 of 415 String Description: Converts any variable to a string. Category: OFP surfaceType [x. y] Operand types: [x. 'u' .58 required."b:ARRAY select BOOL"] Category: Default surfaceIsWater [x.com/comref/full. `mask` can contain wildcards. for example: *:name. y]: Array Compatibility: Version 2.nullary operator.type. In this case. `mask` parameter can be empty string. Type of returned value: Boolean Description: Returns whether water is on given position. 'b' . y] Operand types: [x. Each field of array has format: "x:name" where x is 't' .58 required.binary operator. or one of field. Example: str(2+3) . function returns empty array. 'name' is operator's/type's name (in case operator. if operator is not included in list.

BIS Game Engine Scripting Commands

Page 364 of 415

Type of returned value: String Description: Returns what surface is on given position. Category: OFP

switch exp
Operand types: exp: Any Type of returned value: Switch Type Description: Begins switch form Example: switch (_a) do { case 1: {block}; case 2 : {block}; default {block};} Category: Default

switchableUnits
Compatibility: Version 2.92 required. Type of returned value: Array Description: Return a list of units accessible through team switch. Category: OFP

soldier switchAction action
Operand types: soldier: Object action: String Compatibility: Version 5500 required. Type of returned value: Nothing Description: When used on a person, the given action is started immediately (there is no transition). Use switchmove "" to switch back to the default movement if there is no transition back, otherwise the person may be stuck. Example: soldierOne switchAction "SitDown"

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 365 of 415

Category: OFP

unit switchCamera mode
Operand types: unit: Object mode: String Type of returned value: Nothing Description: Switches the camera to the given vehicle / camera. Mode is one of: "INTERNAL" (1st person), "GUNNER" (optics / sights), "EXTERNAL" (3rd person) or "GROUP" (group). Example: sniperOne switchCamera "gunner" Category: OFP

soldier switchGesture moveName
Operand types: soldier: Object moveName: String Compatibility: Version 5500 required. Type of returned value: Nothing Description: When used on a person, the given move is started immediately (there is no transition). Example: soldierOne switchGesture "Wave" Category: OFP

lamppost switchLight mode
Operand types: lamppost: Object mode: String Type of returned value: Nothing Description: Controls the lamppost mode. Mode may be "ON", "OFF" and "AUTO". "AUTO" is default and means the lampost is only on during nighttime. Example:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 366 of 415

nearestObject [player, "StreetLamp"] switchLight "Off" Category: OFP

soldier switchMove moveName
Operand types: soldier: Object moveName: String Type of returned value: Nothing Description: When used on a person, the given move is started immediately (there is no transition). Use switchmove "" to switch back to the default movement if there is no transition back, otherwise the person may be stuck. Example: soldierOne switchMove "FXStandDip" Category: OFP

synchronizedObjects unit
Operand types: unit: Object Compatibility: Version 5501 required. Type of returned value: Array Description: Return the list of objects synchronized with the given unit. Category: OFP

unit synchronizeObjectsAdd [objects]
Operand types: unit: Object [objects]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Add given objects to the unit's list of synchronized objects. Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 367 of 415

unit synchronizeObjectsRemove [objects]
Operand types: unit: Object [objects]: Array Compatibility: Version 5501 required. Type of returned value: Nothing Description: Remove given objects from the unit's list of synchronized objects. Category: OFP

trigger synchronizeTrigger [waypoint1, waypoint2, ...]
Operand types: trigger: Object [waypoint1, waypoint2, ...]: Array Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Synchronizes the trigger with waypoints. Each waypoint is given as an array [group, index]. Example: trigger synchronizeWaypoint [] Category: OFP

waypoint synchronizeWaypoint [waypoint1, waypoint2, ...]
Operand types: waypoint: Array [waypoint1, waypoint2, ...]: Array Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Synchronizes the waypoint with other waypoints. Each waypoint is given as an array [group, index]. Example: [group1, 2] synchronizeWaypoint [[group2, 3]] Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 368 of 415

trigger synchronizeWaypoint [waypoint1, waypoint2, ...]
Operand types: trigger: Object [waypoint1, waypoint2, ...]: Array Compatibility: Version 1.86 required. Type of returned value: Nothing Description: Synchronizes the trigger with waypoints. Each waypoint is given as an array [group, index]. Example: trigger synchronizeWaypoint [] Category: OFP

tan x
Operand types: x: Number Type of returned value: Number Description: The tangens of x, the argument is in degrees. Example: tan 45 , result is 1 Category: Default

[speaker, side, unit, place, time] targetsAggregate candidates
Operand types: [speaker, side, unit, place, time]: Array candidates: Array Compatibility: Version 2.92 required. Type of returned value: Array Description: Aggregate candidates. Category: Conversations

speaker targetsQuery [receiver, side, unit, place, time]
Operand types:

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 369 of 415

speaker: Object [receiver, side, unit, place, time]: Array Compatibility: Version 2.92 required. Type of returned value: Array Description: Find all targets known to sender matching given query. Category: Conversations

taskChildren task
Operand types: task: Task Compatibility: Version 2.92 required. Type of returned value: Array Description: Return the child tasks of the specified task. Category: Identity

taskCompleted task
Operand types: task: Task Compatibility: Version 2.89 required. Type of returned value: Boolean Description: Return if task is completed. (state Succeeded, Failed or Canceled) Category: Identity

taskDescription task
Operand types: task: Task Compatibility: Version 5501 required. Type of returned value: Array Description: Returns the descripction of the task.

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 370 of 415

Category: Identity

taskDestination task
Operand types: task: Task Compatibility: Version 2.92 required. Type of returned value: Array Description: Returns the position of the task (as specified by destination parameter in config). Category: Identity

taskHint text
Operand types: text: Array Type of returned value: Nothing Description: Shows info about new,changed or failed task. The text can contain several lines. \n is used to indicate the end of a line. Example: taskHint "Capture town." Category: OFP

taskNull
Compatibility: Version 5153 required. Type of returned value: Task Description: A non-existing task. This value is not equal to anything, including itself. Example: taskNull == taskNull , result is false Category: Identity

taskParent task

http://www.arma2.com/comref/full.html

7/11/2010

BIS Game Engine Scripting Commands

Page 371 of 415

Operand types: task: Task Compatibility: Version 2.92 required. Type of returned value: Task Description: Return the parent task of the specified task. Category: Identity

taskResult task
Operand types: task: Task Compatibility: Version 2.92 required. Type of returned value: Array Description: Return the result of the given task. Category: Identity

taskState task
Operand types: task: Task Compatibility: Version 2.89 required. Type of returned value: String Description: Return the state of the given task. Category: Identity

teamSwitch
Compatibility: Version 2.92 required. Type of returned value: Nothing Description: Invoke the team switch dialog (force it even when conditions are noy met). Category: OFP

http://www.arma2.com/comref/full.html

7/11/2010

http://www. Type of returned value: Structured text Description: Creates a structured text containing the given plain text.com/comref/full.BIS Game Engine Scripting Commands Page 372 of 415 teamSwitchEnabled Compatibility: Version 2.01 required. Type of returned value: String Description: Return text attached to given location. Category: Location text text Operand types: text: String Compatibility: Version 2.92 required. Type of returned value: Boolean Description: Check if tam switch is currently enabled.arma2. Type of returned value: Nothing Description: Terminate (abort) the script Category: OFP text location Operand types: location: Location Compatibility: Version 2. Category: OFP terminate script Operand types: script: Script Compatibility: Version 2.90 required.html 7/11/2010 .50 required.

BIS Game Engine Scripting Commands Page 373 of 415 Example: txt2 = text "Hello world. result is 1 Category: Default if then else Operand types: if: If Type else: Array Compatibility: Version 1. the argument is in degrees.{c=2}] http://www. Type of returned value: Any Description: The first or second element of the array is executed depending on the result of the if condition.com/comref/full. The result of the executed expression is returned as a result (the result may be nothing).html 7/11/2010 .if (a>b) then [{c=1}. Example: if (a>b) then {c=1} else {c=2}. Example: tg 45 ." Category: OFP textLog anything Operand types: anything: Any Type of returned value: Nothing Description: Dumps the argument value into the debugging output.85 required. Example: textLog player Category: OFP tg x Operand types: x: Number Type of returned value: Number Description: The tangens of x.arma2.

85 required.arma2. Example: if (a>b) then {c=1} Category: Default throw expression Operand types: expression: Any Type of returned value: Nothing Description: Throws an exception. Type of returned value: Any Description: The code is executed when the if condition is met. Example: throw "invalid argument" Category: Default time Type of returned value: Number Description: Returns the time that elapsed since the mission started (in seconds). the last value calculated in the code is returned. The exception is processed by first catch block. If the code is not executed. See try.html 7/11/2010 . If the code is executed. Category: OFP titleCut effect http://www. nothing is returned.com/comref/full.BIS Game Engine Scripting Commands Page 374 of 415 Category: Default if then codeToExecute Operand types: if: If Type codeToExecute: Code Compatibility: Version 1.

arma2. Category: OFP titleFadeOut duration Operand types: duration: Number Compatibility: Version 5126 required."plain"] Category: OFP titleRsc effect Operand types: effect: Array Type of returned value: Nothing Description: Resource title . Example: titleObj ["BISLogo".speed] or ["name".the argument uses format ["name".BIS Game Engine Scripting Commands Page 375 of 415 Operand types: effect: Array Type of returned value: Nothing Description: Obsolete."type"]."type". Example: titleFadeIn 1.0 Category: OFP titleObj effect Operand types: effect: Array Type of returned value: Nothing Description: Object title ."type".the argument uses format ["text". it's assumed to be one.speed] or ["name"."type"]. If speed is not http://www. Type of returned value: Nothing Description: Terminate the title effect and set duration of the fade out phase to the given time. If speed is not given. The object can be defined in the description.ext file.com/comref/full.html 7/11/2010 .

it's assumed to be one.} Category: Default toArray string Operand types: string: String Compatibility: Version 5195 required."type". http://www. Example: titleText ["Show this text"."type"].ext file.com/comref/full. "PLAIN"] Category: OFP titleText effect Operand types: effect: Array Type of returned value: Nothing Description: Text title . Type of returned value: Array Description: Convert the string to the array of characters. Example: titleRsc ["BIS".the argument uses format ["text". it's assumed to be one. "PLAIN"] Category: OFP for "_var" from a to b Operand types: for "_var" from a: for type b: Number Type of returned value: for type Description: Continue sequence of 'for' command.code.. If speed is not given.BIS Game Engine Scripting Commands Page 376 of 415 given.arma2.html 7/11/2010 .speed] or ["text". Example: for "_x" from 10 to 20 do {. Resource can be defined in the description..

com/comref/full.BIS Game Engine Scripting Commands Page 377 of 415 Example: toArray "ArmA" . result is "ArmA" Category: Default toUpper string Operand types: string: String Compatibility: Version 5195 required.html 7/11/2010 . 65] . Type of returned value: String Description: Convert the array of characters to the string. 114. http://www. Example: toLower "ArmA" . Type of returned value: String Description: Convert the string to lower case. Example: toString [65. 109. 109. Type of returned value: String Description: Convert the string to upper case. 65] Category: Default toLower string Operand types: string: String Compatibility: Version 5195 required.arma2. result is [65. 114. result is "arma" Category: Default toString characters Operand types: characters: Array Compatibility: Version 5195 required.

b. repeating] Category: OFP triggerArea trigger Operand types: trigger: Object Compatibility: Version 5501 required. Type of returned value: Array Description: Returns trigger area in the form [a. result is "ARMA" Category: Default triggerActivated trigger Operand types: trigger: Object Compatibility: Version 5501 required. Type of returned value: Array Description: Returns trigger activation in the form [by. type. rectangle] Category: OFP triggerAttachedVehicle trigger http://www.arma2. Category: OFP triggerActivation trigger Operand types: trigger: Object Compatibility: Version 5501 required.html 7/11/2010 . angle.com/comref/full.BIS Game Engine Scripting Commands Page 378 of 415 Example: toUpper "ArmA" . Type of returned value: Boolean Description: Returns true if the trigger has been activated.

"LEADER" or "MEMBER". Example: trigger triggerAttachObject 1234 Category: OFP trigger triggerAttachVehicle [] or [vehicle] Operand types: trigger: Object [] or [vehicle]: Array Compatibility: Version 1. Example: trigger triggerAttachVehicle [player] Category: OFP http://www.86 required. When the source is "GROUP". Type of returned value: Nothing Description: Assigns a static object to the trigger. the trigger is detached from the assigned vehicle. If the activation source is "VEHICLE". Type of returned value: Nothing Description: If [] is given. "GROUP".arma2.86 required. If [vehicle] is given. otherwise it's attached to the vehicle and the source is changed to "VEHICLE". "LEADER" or "MEMBER". the trigger is attached to the vehicle or its group.html 7/11/2010 .BIS Game Engine Scripting Commands Page 379 of 415 Operand types: trigger: Object Compatibility: Version 5101 required.com/comref/full. it's attached to the group. The activation source is changed to "STATIC". it's changed to "NONE". Type of returned value: Object Description: Returns vehicle attached to the trigger (for example using triggerAttachVehicle) Category: OFP trigger triggerAttachObject objectId Operand types: trigger: Object objectId: Number Compatibility: Version 1.

com/comref/full. activ. max. Type of returned value: String Description: http://www. Type of returned value: Array Description: Returns trigger timeout in the form [min. desactiv] Category: OFP triggerText trigger Operand types: trigger: Object Compatibility: Version 5501 required.BIS Game Engine Scripting Commands Page 380 of 415 triggerStatements trigger Operand types: trigger: Object Compatibility: Version 5501 required.html 7/11/2010 .arma2. Type of returned value: Array Description: Returns trigger statements in the form [cond. mid. interruptable] Category: OFP triggerType trigger Operand types: trigger: Object Compatibility: Version 5501 required. Type of returned value: String Description: Returns trigger text. Category: OFP triggerTimeout trigger Operand types: trigger: Object Compatibility: Version 5501 required.

Category: OFP true Type of returned value: Boolean Description: Always true.BIS Game Engine Scripting Commands Page 381 of 415 Returns trigger type.com/comref/full.html 7/11/2010 . Exception is described in _exception variable }. Category: OFP type task Operand types: task: Task Compatibility: http://www.arma2. Category: Default try code Operand types: code: Code Type of returned value: Exception Type Description: Defines try-catch structure. that process an exception. The structured exception block has following formtry //begin of try-catch block { //block. that can throw exception } catch{ //block. Type of returned value: Object Description: Returns the unit in the vehicle turret. This is structured exception block. Category: Default vehicle turretUnit turret path Operand types: vehicle: Object turret path: Array Compatibility: Version 5501 required. Any thrown exception in try block is caught in catch block.

00 required. result is "string" Category: Default typeOf object Operand types: object: Object Compatibility: Version 1. Type of returned value: String Description: Return type of given location.90 required. Type is returned as string Example: typeName "hello" .BIS Game Engine Scripting Commands Page 382 of 415 Version 2. Type of returned value: String Description: Returns the name of the type of the given object.com/comref/full. http://www. Category: Location typeName any Operand types: any: Any Compatibility: Version 2.html 7/11/2010 .91 required.arma2.91 required. Type of returned value: String Description: Returns type-name of expression. Category: Identity type location Operand types: location: Location Compatibility: Version 2. Type of returned value: String Description: Return the type of the task.

Category: OFP unassignTeam vehicle Operand types: vehicle: Object Compatibility: Version 2.BIS Game Engine Scripting Commands Page 383 of 415 Example: typeOf player . the group leader will issue an order to disembark. Example: unassignVehicle player Category: OFP http://www.com/comref/full. If he is currently inside.html 7/11/2010 . Example: unassignTeam soldier2 Category: OFP unassignVehicle unit Operand types: unit: Object Type of returned value: Nothing Description: The person is unassigned from the vehicle.05 required. Type of returned value: Nothing Description: Unassigns the vehicle (its commander unit) from his team. Type of returned value: Namespace Description: Return the global namespace attached to user interface. This is equal to vehicle assignTeam "MAIN". result is "SoldierWB" Category: OFP uiNamespace Compatibility: Version 5501 required.arma2.

Category: OFP unitReady unit Operand types: unit: Object or Array Type of returned value: Boolean Description: Checks whether the unit is ready. A unit is busy when it's given an order like "move".arma2.com/comref/full.html 7/11/2010 . Example: unitReady player Category: OFP units unit Operand types: unit: Object Type of returned value: Array Description: Returns an array with all the units in the group of the given object. until the command is finished. Example: player in units player Category: OFP units grp Operand types: grp: Group Type of returned value: http://www. For a destroyed object an empty array is returned.92 required.BIS Game Engine Scripting Commands Page 384 of 415 unitPos person Operand types: person: Object Compatibility: Version 2. Type of returned value: String Description: Return the unit position rules.

width. Type of returned value: Boolean Description: Unregister a task type. Type of returned value: Nothing Description: Updates the icon to be shown in 2D editor for the specified editor object. shadow] Operand types: map: Control [object. Category: OFP teamMember unregisterTask name Operand types: teamMember: name: String Compatibility: Version 2. maintain size?. string identifier. maintain size?. string identifier. shadow]: Array Compatibility: Version 2.92 required. If maintain size is false. Category: Identity map updateDrawIcon [object.BIS Game Engine Scripting Commands Page 385 of 415 Array Description: Returns an array with all the units in the group. angle.90 required. height. Type of returned value: Boolean Description: Unlock the given achievement. http://www. Example: player in units group player Category: OFP unlockAchievement name Operand types: name: String Compatibility: Version 5501 required. angle. color.arma2.html 7/11/2010 . height. offset. width. offset. color.com/comref/full.

92 required. Type of returned value: Nothing Description: Sets the text and command for the menu item.command] Operand types: map: Control [menu item index.com/comref/full. If maintain size is a number. index is index as returned from addMenuItem command.92 required. Type of returned value: Nothing Description: Update the editor object tree. Used for audio/animation synchronization.text. Category: Editor updateObjectTree map Operand types: map: Control Compatibility: Version 2.BIS Game Engine Scripting Commands Page 386 of 415 icon will not scale depending on the scale of the map. command is optional. Example: player useAudioTimeForMoves true Category: OFP http://www.html 7/11/2010 .command]: Array Compatibility: Version 2. Category: Editor soldier useAudioTimeForMoves toggle Operand types: soldier: Object toggle: Boolean Type of returned value: Nothing Description: Switch between elapsed gamet time and audio time being used as animation timer.text.arma2. the icon will maintain size if map scale is below that number. Category: Editor map updateMenuItem [menu item index.

If there is none.com/comref/full. Category: OFP vectorUp obj Operand types: obj: Object Compatibility: Version 2. Example: vehicle player != player Category: OFP unit vehicleChat chatText Operand types: unit: Object chatText: String Type of returned value: http://www.html 7/11/2010 . Type of returned value: Array Description: Return object's up vector in world coordinates as [x. y].61 required. the unit is returned. y]. Type of returned value: Array Description: Return object's direction vector in world coordinates as [x.61 required. Category: OFP vehicle unit Operand types: unit: Object Type of returned value: Object Description: Returns the vehicle in which the given unit is mounted. z. z.BIS Game Engine Scripting Commands Page 387 of 415 vectorDir obj Operand types: obj: Object Compatibility: Version 2.arma2.

Example: soldierOne vehicleRadio "messageOne" Category: OFP vehicles Compatibility: Version 2. Example: soldierOne vehicleChat "Show this text" Category: OFP unit vehicleRadio radioName Operand types: unit: Object radioName: String Type of returned value: Nothing Description: Sends the message to the vehicle radio channel.arma2.com/comref/full.BIS Game Engine Scripting Commands Page 388 of 415 Nothing Description: Types text to the vehicle radio channel.html 7/11/2010 . Type of returned value: Array Description: Return a list of vehicles in the current mission. you have to execute it on all of them.ext file or radio protocol. Example: _vehicles = vehicles Category: OFP vehicles Compatibility: Version 2. The message is defined in the description. Note: this function only types text to the list. it does not broadcast the message. If you want the message to show on all computers.92 required.92 required. Type of returned value: Array Description: http://www.

com/comref/full.91 required.91 required. z. Category: OFP verifySignature filename Operand types: filename: String Compatibility: Version 2. Type of returned value: Array Description: Returns the velocity (speed vector) of the vehicle as an array with format [x.BIS Game Engine Scripting Commands Page 389 of 415 Return a list of vehicles in the current mission. Category: OFP http://www.80 required. y]. Category: OFP velocity vehicle Operand types: vehicle: Object Compatibility: Version 1. Example: _vehicles = vehicles Category: OFP vehicleVarName object Operand types: object: Object Compatibility: Version 2. Type of returned value: Boolean Description: Check if file is signed by an accepted key.html 7/11/2010 . Type of returned value: String Description: Returns the name of the variable which contains a reference to this object.arma2.

60 required. Type of returned value: Number Description: Returns the rendering distance.arma2. Example: _i = 0. Type of returned value: Boolean Description: Return true if the main map is shown (active). Category: OFP visibleMap Compatibility: Version 5501 required. http://www.com/comref/full.html 7/11/2010 . Category: OFP waitUntil condition Operand types: condition: Code Compatibility: Version 2.BIS Game Engine Scripting Commands Page 390 of 415 viewDistance Compatibility: Version 5501 required. waitUntil {_i = _i + 1. _i >= 100} Category: Default waypointAttachedObject waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. Type of returned value: Object Description: Gets the object attached to the waypoint. Type of returned value: Nothing Description: Suspend execution of script until condition is satisfied.

BIS Game Engine Scripting Commands Page 391 of 415 Example: waypointAttachedObject [groupOne. 1] Category: OFP waypointAttachedVehicle waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. Example: [grp. Example: waypointAttachedVehicle [groupOne.arma2. Type of returned value: Nothing http://www.html 7/11/2010 . Type of returned value: Nothing Description: Attaches a static object to the given waypoint. 2] waypointAttachObject 1234 Category: OFP waypoint waypointAttachVehicle vehicle Operand types: waypoint: Array vehicle: Object Compatibility: Version 1. Type of returned value: Object Description: Gets the vehicle attached to the waypoint.com/comref/full.86 required.86 required. 1] Category: OFP waypoint waypointAttachObject idStatic or object Operand types: waypoint: Array idStatic or object: Compatibility: Version 1.

BIS Game Engine Scripting Commands Page 392 of 415 Description: Attaches a vehicle to the given waypoint. 2] waypointAttachVehicle vehicle player Category: OFP waypointBehaviour waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. Type of returned value: String Description: Gets the waypoint behavior.arma2. Type of returned value: Number http://www.html 7/11/2010 .com/comref/full. Example: [grp. Example: waypointCombatMode [groupOne. 1] Category: OFP waypointCompletionRadius waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. Type of returned value: String Description: Gets the waypoint combat mode. Example: waypointBehaviour [groupOne. 1] Category: OFP waypointCombatMode waypoint Operand types: waypoint: Array Compatibility: Version 5500 required.

arma2. Type of returned value: Number http://www. 1] Category: OFP waypointHousePosition waypoint Operand types: waypoint: Array Compatibility: Version 5500 required.com/comref/full. Type of returned value: String Description: Gets the waypoint description.BIS Game Engine Scripting Commands Page 393 of 415 Description: Gets the radius around the waypoint where is the waypoint completed. Type of returned value: String Description: Gets the waypoint formation. 1] Category: OFP waypointFormation waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. 1] Category: OFP waypointDescription waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. Example: waypointDescription [groupOne. Example: _radius = waypointCompletionRadius [groupOne. Example: waypointFormation [groupOne.html 7/11/2010 .

Note: this function is identical to getWaypointPosition.html 7/11/2010 . Type of returned value: Array Description: Return the list of waypoints for given group. 1] Category: OFP waypoints group Operand types: group: Object or Group Compatibility: Version 5129 required.50 required.arma2. Example: waypointHousePosition [groupOne. Example: waypointPosition [groupOne. Type of returned value: String Description: Gets the waypoint script. http://www. Type of returned value: Array Description: Gets the waypoint position.BIS Game Engine Scripting Commands Page 394 of 415 Description: Gets the house position assigned to the waypoint.com/comref/full. Category: OFP waypointScript waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. 1] Category: OFP waypointPosition waypoint Operand types: waypoint: Array Compatibility: Version 1. Waypoint uses format Waypoint.

Example: waypointShow [groupOne. Example: waypointSpeed [groupOne. 1] Category: OFP waypointShow waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. 1] Category: OFP waypointSpeed waypoint Operand types: waypoint: Array Compatibility: Version 5500 required.BIS Game Engine Scripting Commands Page 395 of 415 Example: waypointScript [groupOne.com/comref/full. 1] Category: OFP waypointStatements waypoint Operand types: waypoint: Array Compatibility: Version 5500 required.arma2. Type of returned value: Array Description: Gets the waypoint statements.html 7/11/2010 . Type of returned value: String Description: Gets the waypoint speed. http://www. Type of returned value: String Description: Gets the waypoint show/hide status.

Type of returned value: String Description: Gets the waypoint type. 1] Category: OFP waypointType waypoint Operand types: waypoint: Array Compatibility: Version 5500 required. 1] Category: OFP vehicle weaponDirection weaponName Operand types: vehicle: Object weaponName: String Compatibility: Version 2. Example: waypointType [groupOne.BIS Game Engine Scripting Commands Page 396 of 415 Example: waypointStatements [groupOne.61 required. Type of returned value: Array Description: Gets the waypoint timeout values.arma2. Type of returned value: Array Description: http://www. Example: waypointTimeout [groupOne. 1] Category: OFP waypointTimeout waypoint Operand types: waypoint: Array Compatibility: Version 5500 required.com/comref/full.html 7/11/2010 .

Example: _dir = _vehicle weaponDirection "M16" Category: OFP weapons vehicle Operand types: vehicle: Object Compatibility: Version 1. Type of returned value: While Type Description: The first part of the while contruct.html 7/11/2010 . Example: weapons player Category: Resistance west Type of returned value: Side Description: The West side. Type of returned value: Array Description: Returns an array of names of all the vehicle's weapons.arma2.com/comref/full. Category: OFP while condition Operand types: condition: Code Compatibility: Version 1.75 required. Example: while "x<10" do {x=x+1} Category: Default http://www.BIS Game Engine Scripting Commands Page 397 of 415 Returns direction where is given weapon aiming.85 required.

Type of returned value: With Type Description: The first part of the with contruct.com/comref/full.arma2.92 required. Example: with missionNamespace do {global=global+1} Category: Default worldName Compatibility: Version 2.92 required. Type of returned value: Array Description: Return the current wind vector. Category: OFP with namespace Operand types: namespace: Namespace Compatibility: Version 5501 required.92 required. Type of returned value: Array Description: http://www. Category: OFP object worldToModel worldPos Operand types: object: Object worldPos: Array Compatibility: Version 2. Type of returned value: String Description: Return the name of the currently loaded world.BIS Game Engine Scripting Commands Page 398 of 415 wind Compatibility: Version 2.html 7/11/2010 .

Type of returned value: Array Description: Converts position in world space into screen (UI) space. http://www. Boolean Description: Boolean (true or false). Any Value Description: Any value. Category: OFP Any Description: Anyhing . including nothing. Category: OFP worldToScreen position Operand types: position: Array Compatibility: Version 5501 required.arma2.com/comref/full.BIS Game Engine Scripting Commands Page 399 of 415 Converts position from world space to object model space. Anything Description: Anything. Array Description: An array of items. each may be of any type.html 7/11/2010 .any value.

Config Description: Config file entry.":updatePhase:"] do {. Group http://www. Diary record Description: Diary record.code.BIS Game Engine Scripting Commands Page 400 of 415 Code Description: Part of code (compiled). for type Description: This type handles for cycles. Display Description: Display UI object.html 7/11/2010 ..}. Exception Type Description: A helper type used in try-catch constructs. Usage of this type: for "_var" from :expr: to :expr: [step <expr>] do {.code. Control Description: Control UI object....com/comref/full.}..":condition:".arma2.Second usage: for [":initPhase:"..

BIS Game Engine Scripting Commands Page 401 of 415 Description: A group. Location Description: Location. Nothing Description: Nothing .. vehicle or building). Object Description: A game object (like a soldier. Number Description: A real number. Number or Nothing Description: Number or Nothing.set of variables. If Type Description: A helper type used in if. Namespace Description: Namespace .no value.then constructs. http://www.com/comref/full.html 7/11/2010 .arma2.

Object or Group Description: Object or group.arma2. String Description: An ASCII string.html 7/11/2010 . east.BIS Game Engine Scripting Commands Page 402 of 415 Object or Array Description: Object or Array. civilian and resistance). http://www. If you pass a group. its leader is considered. Orientation Description: Script Description: Side Description: The name of the side (see west.com/comref/full. Object or String Description: Object or String. String or Array Description: String or Array.

arma2. Transformation Description: Vector http://www.com/comref/full. Structured text Description: Switch Type Description: A helper type used in switch constructs. Target Description: Task Description: Task.html 7/11/2010 .BIS Game Engine Scripting Commands Page 403 of 415 String or Code Description: String or Code. Text or String Description: Text or String.

All of them are fon interval [0. AnimationName. Category: OFP ParticleArray Format: [ShapeName.html 7/11/2010 .Period of changing the velocity vector (s). Volume. RotationVelocity.2] as a size then at the beginning the size of the particle will be 1 and at the end of the life time of the particle it's size will be 2.Size of the particle in time to render (m). Volume . Object. r is intensity of red. AnimationPhase . 1].Life time of the particle (in sec). 0 . Type . With Type Description: A helper type used in while.Weight of the particle (in kg). Position. Size.in this case the Object property must be set.BIS Game Engine Scripting Commands Page 404 of 415 Description: While Type Description: A helper type used in while. LifeTime. OnTimer.. g intensity of green. TimerPeriod. Color Format: [r. LifeTime .Color of the particle in time to render (RGBA). Rubbing . RandomDirectionIntensity - http://www. F.I. Render parameters: Note that all these values are set as arrays to show their development in time. g. RandomDirectionPeriod.com/comref/full. Color . {angle}] Description: Global parameters: ShapeName .Either 3D coordinate (xzy) or name of the selection . AnimationName Name of the animation of the shape.Volume of the particle (in m^3).do constructs. if you set the array [1. RotationVelocity .Phase of the animation in time.The period of calling the "OnTimer" event (in sec).. b intensity of blue and a alpha (1 . The rest od the values during the life time will be lineary interpolated.transparancy).Type of the particle (either "Billboard" or "SpaceObject"). Random parameters: RandomDirectionPeriod . MoveVelocity .3D vector (xyz) which describes the velocity vector of the particle (direction and speed in m/s).no impact (vacuum). Type. a] Description: Color. b.do constructs.arma2. MoveVelocity. TimerPeriod . AnimationPhase. Physical parameters: Position . Rubbing.Float number which determines number of rotations in one second. BeforeDestroy. Weight. Size . Color.Float number without dimension which determines the impact of the density od the enviroment on this particle. RandomDirectionIntensity. Weight .Name of the shape associated with the particle.

Object .z. z coordinates are from South to North. Category: OFP Position Format: [x.arma2. Position of the particle is stored in "this" variable.y] Description: Position. Position of the particle is stored in "this" variable. Category: OFP Waypoint Format: [group. z coordinates are from South to North.y] Description: Position. y is the height above ground and the default y is 0. RandomDirectionIntensity>. Category: OFP Position2D Format: [x. Category: OFP http://www. BeforeDestroy .z] or [x.com/comref/full.z] Description: x coordinates are from East to West.z.Object to bind this particle to.BIS Game Engine Scripting Commands Page 405 of 415 Each MoveVelocity component will be changed with random value from interval <0.Name of the script to run right before destroying the particle. y is the height above see level. z coordinates are from South to North.Name of the script to run every period determined by TimerPeriod property.index] Description: Group is of type Group.html 7/11/2010 . OnTimer . index selects the waypoint (index 0 selects the first waypoint which is always created on the group starting position). Category: OFP PositionASL Format: [x. x coordinates are from East to West. x coordinates are from East to West.

gunner] .launched when the intro is started (since 1. _this select 0 is always the source of the event. The event handler types are defined below. we recommend to use curled braces for code only. moreover future versions of the scripting language may precompile code enclosed in curled braces.sqs .html 7/11/2010 .launched when the mission is started (before the briefing screen) . b].scalar:howMuch "Engine" bool:engineState "GetIn" string:position (1). since 1.50) . While both ways are currently equivalent and a string constant is created. particle scripts (since 1. Since 1.number of game endings onFlare. g.45) .sqs . a is changed as well.no arguments exit.no arguments initIntro. Event based scripts There are some scripts in the game which are launched when a particular event occured.com/comref/full. When b is changed. init.arguments: [[r.r. "Killed" object:killer "Hit" object:causedBy. Each handler receives arguments in _this. as this makes scripts easier to read. g.argument: end # . if and while) use the concept of "code strings". Code strings Many languague constructs (including forEach. Names of others are given by the program. after executing a = b both a and b represent the same array.50) or user action scripts). One particular situation that can lead to this behaviour is aList = list sensor_name. When b is an array. Multiple handlers can be attached at one time.sqs .50) .launched when an illuminating shell is lit(since 1.object:unit http://www.85 string constants can be written in two ways: using double quotes (like "Hello") or curled braces (like {a=a+1}). Code is passed to them as a string and they interpret it as code if they wish.launched when the mission is finished (before the debriefing screen. Other argument types and meaning are defined below. You can force creating a copy of an array by using the unary operator +Array.sqs . b is the light color Event handlers Event handlers can be defined in a unit config or by function addEventHandler. Some of them have a name given by the mission designer (scripted waypoint.BIS Game Engine Scripting Commands Page 406 of 415 Array assignment Assignments used on arrays assign only a pointer to the same array to the target variable.arma2.

then."_b"}. Functions .. if (_a>_b) then {_a} else {_b} Example 2 (infantrySafe. Example 1 (max.string:ammo "IncomingMissile" string:ammo. { if (vehicle _x == _x) then { _x setBehaviour "safe" } } forEach _this http://www.arma2. All other event handlers are executed on all computers. "commander".else while.scalar:howMuch "Gear" bool:gearState "Fuel" bool:fuelState "Init" No arguments (1) position can be "driver". "gunner".object:unit "Fired" string:weapon. Main language contructs used in functions are: if. private {"_a". functions (see call.do Curled braces Multiple commands (including assigment commands) delimited with a semicolon The result of the last expression evaluated is returned as a function result.html 7/11/2010 . _a = _this select 0.com/comref/full. it is considered to be equivalent to a space.BIS Game Engine Scripting Commands Page 407 of 415 "GetOut" string:position (1).string:mode. "cargo" MP notes: "Killed" and "Hit" event handlers are executed where the given unit is local. Semicolon is therefore required even when ending a line.string:muzzle.sqf) comment "Return the maximum of the first and second argument".then.sqf) comment "Switch all infantry units to safe mode". Events added by addEventHandler may be different on each computer.. This can be nothing when a function returns no value.object:whoFired "Dammaged" string:selectionName..SQF While script syntax (see exec) is line based. _b = _this select 1. do) is based on structured expressions and end-of-line has no special meaning. Scripts can wait suspended until a certain condition it met and they can also use goto to change the execution point at any time. Note: scripts can do some things that are not possible in functions.

SQF (as opposed to .BIS Game Engine Scripting Commands Page 408 of 415 Due to the line-based nature of scripts it is not possible to create multiline string constants in them.SQS used for scripts). it is created in the innermost scope. It is used to keep the time elapsed since the script execution started. Example: @condition Waiting for a time: line starting with '&'. All local variables from outer scopes are visible as well. count. http://www. If assignment is made into a variable that does not exist in any visible scope. Local variables A local variable is any variable which name starts with an underscore. while.com/comref/full.'. Example: ?_condVar>10:_var=_var+2 Note: variable _time is reserved. Example: _unit setBehaviour "safe" Assignment: assignment of any value to variable. do. forEach. Local variables can be used during script execution to avoid variable conflicts.html 7/11/2010 . To overcome this limitation you can store multiline in separate files and load them using the loadFile or preprocessFile functions (the second uses a C-like preprocessor with // or /* */ comments and #define macros). the command is executed only when the condition is satisfied. You can use function private to introduce variables at any given scope.arma2. Script syntax Each script line may be one of the following: Comment: line starting with '. Example: _a = 10 Conditional: ? condition : command or assignmented. A local variable name starts with an underscore ('_'). Example: #LabelName Waiting for a condition: line starting with '@'. All other variables are global. &__waitUntil Command: any expression returning no value.This is comment Label: line starting with '#'. Each of the commands then. Example: ~delay is equivalent to __waitUntil = _time+(cas) . exec and call define a visibility scope for local variables. Example: &endTime is equivalent to @_time >= (endTime) Delay: line starting with '~'. Variables starting with two underscores are reserved and should never be used. The recommended file extension for functions is . Example: .

BIS Game Engine Scripting Commands Page 409 of 415 Triggers The Condition expression is used to determine when the trigger is activated. Array variable thisList is set to the list of all units in the group that the given waypoint is assigned to. Boolean variable this is set during evaluation of the condition expression to the primary sensor activation condition. When an undefined value is encountered in a field where a boolean value is expected. Vehicle Config entry: CfgVehicles Value All Logic Land Car Motorcycle Tank APC Man Civilian Civilian2 Civilian3 Description any vehicle game logic invisible unit ground vehicle + + + + http://www. When any uninitialized variable is detected in any expression. Variables Variables have to be inicialized before being used. it is converted to false. Variables may be unitialized by assigning it the nil value. Array variable thisList is set to the list of all vehicles that would satisfy the primary sensor activation condition. Condition must return a boolean value. Expressions must either be an assignment or return nothing (see type none).html 7/11/2010 . Condition must return a boolean value.arma2. the whole expression results nil (an undefined value). The expression must either be an assignment or return nothing (see type none). This effectively destroys the variable as if it never existed. Waypoints The Condition expression is used to determine when the waypoint execution is terminated. The On Activation and On Deactivation expressions define actions that are peformed when the trigger condition changes to true or false.com/comref/full. The On Activation expression defines an action that is peformed after the waypoint is terminated. Variable denoting trigger can be created by filling in the name field. Boolean variable this is set during evaluation of the condition expression to the primary waypoint termination condition.

html 7/11/2010 .arma2.com/comref/full.BIS Game Engine Scripting Commands Page 410 of 415 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - Soldier SoldierLAW Air Helicopter Plane Ship SmallShip BigShip Jeep JeepMG Rapid RapidY Skoda SkodaBlue SkodaRed SkodaGreen Tractor Truck Truck5t Truck5tOpen Truck5tRepair Truck5tReammo Truck5tRefuel SoldierWB SoldierWG SoldierWMedic SoldierWCrew SoldierWPilot SoldierWMG SoldierWLAW SoldierWAT SoldierWAA SoldierWMortar SoldierWSniper SoldierWSaboteurPipe SoldierWSaboteurDay SoldierWMiner OfficerW SoldierWCaptive M1Abrams M60 M113 M113Ambul Cobra Ch47D air vehicle helicopter airplane 5 ton truck basic western soldier western soldier with grenade launcher western soldier with machine gun western soldier with LAW launcher western soldier with guided AT missile western soldier with AA missile western soldier with riffle grenade http://www.

html 7/11/2010 .com/comref/full.BIS Game Engine Scripting Commands Page 411 of 415 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ParachuteEast ParachuteWest ParachuteC ParachuteG UH60 UH60MG Su25 A10 Cessna BoatW M2StaticMG UAZ Ural UralRepair UralReammo UralRefuel Scud SoldierEB SoldierWFakeE SoldierEG SoldierEMedic SoldierECrew SoldierEPilot SoldierEMG SoldierELAW SoldierEAT SoldierEAA SoldierEMiner OfficerE OfficerENight GeneralE Angelina SoldierESniper SoldierESaboteurPipe SoldierEFakeW LaserTarget BMP BMPAmbul RussianTank T72 T80 ZSU M2StaticMGE Mi24 Mi17 laser designator dot http://www.arma2.

BIS Game Engine Scripting Commands Page 412 of 415 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + CarrierW BoatE TruckV3SG GJeep TruckV3SCivil TruckV3SGRefuel TruckV3SGRepair TruckV3SGReammo UAZG SGUAZG SoldierGB SoldierGMedic SoldierGCrew SoldierGPilot SoldierGG SoldierGMG SoldierGLAW SoldierGAT SoldierGAA OfficerG OfficerGNight SoldierGFakeE SoldierGFakeC SoldierGFakeC2 T55G Static static object or building ReammoBox ReammoBoxWest ReammoBoxEast ReammoBoxGuer HeavyReammoBox HeavyReammoBoxWest HeavyReammoBoxEast HeavyReammoBoxRes MachineGunBox FlagCarrier Danger Fire Target TargetE Camp Fortress1 Fortress2 CampEmpty CampEast http://www.com/comref/full.arma2.html 7/11/2010 .

com/comref/full.BIS Game Engine Scripting Commands Page 413 of 415 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + CampEastC Grave GraveCross1 GraveCross2 GraveCrossHelmet ACamp MASH Fence FenceWood Wire WireFence Barrels Barrel1 Barrel2 Barrel3 Barrel4 Table Tablemap Chair Phone Camera1 Computer ChairHangar ChairX VideoTable TablePub Radio ChairSmall Crawling ExcerciseTrack ExcerciseTrack2 ExcerciseTrack3 Paleta1 Paleta2 JeepWreck1 JeepWreck2 JeepWreck3 M113Wreck UralWreck Body Shed Office Barracks Hangar Hangar_Hall http://www.html 7/11/2010 .arma2.

com/comref/full.arma2.BIS Game Engine Scripting Commands Page 414 of 415 + + + + + + + Hangar_Office ShedSmall HeliH HeliHEmpty TargetTraining TargetGrenade FuelStation fuel station building Weapons and magazines Config entry: CfgWeapons Value Description Shell73 Heat73 Gun73 Shell105 Heat105 Gun105 Shell120 Heat120 Gun120 Shell125 Heat125 Gun125 MGun Riffle StrokeFist M16 M4 AK47 AK47CZ AK74 AK74SU HK SniperRiffle M21 SVDDragunov Binocular NVGoggles MachineGun7_6 MachineGun7_6Manual M60 PK MachineGun12_7 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + http://www.html 7/11/2010 .

html 7/11/2010 .com/comref/full.arma2.BIS Game Engine Scripting Commands Page 415 of 415 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Browning MachineGun30 MachineGun30A10 ZsuCannon GrenadeLauncher RiffleGrenadeLauncher M16GrenadeLauncher AK47GrenadeLauncher AK74GrenadeLauncher Mortar Flare FlareGreen FlareRed HandGrenade SmokeShell SmokeShellRed SmokeShellGreen Put Mine MineE PipeBomb LAWLauncher RPGLauncher CarlGustavLauncher AT4Launcher AALauncher 9K32Launcher AT3Launcher HellfireLauncher ZuniLauncher38 Rocket57x64 Rocket57x192 HellfireLauncherCobra HellfireLauncherHind MaverickLauncher CarHorn TruckHorn SportCarHorn http://www.

Sign up to vote on this title
UsefulNot useful