setVariable

1.001.001.501.000.50

GAGlobalLELocal

Hover & click on the images for description

Description

Description:

Set variable to given value in the variable space of given element. Can be used to broadcast variables over the network. To remove a variable, set it to nil (see Example 5).

⚠

missionNamespace, uiNamespace, parsingNamespace and profileNamespace variables cannot be named as commands - e.g missionNamespace setVariable ["west", 123]; will result in a Reserved variable in expression error, west being a scripting command (other namespaces do not have such limitation). See also all available script commands.

Multiplayer:

The variable space of the object is local to each client and by default changes are not broadcast - see the public parameter below.

Groups:

VariablesNamespacesMultiplayer

Syntax

Syntax:

varspace setVariable [name, value, public]

Parameters:

varspace: variable space in which variable can be set. Can be one of:

• Namespace
• Object
• Group
• Location (scripted ones only)
• 1.00 Team Member
• 1.00 Task - value will actually be set on the Task's FSM if it exists.
• 0.50 Control
• 0.50 Display

name: String - variable name (Identifier)

value: Anything - variable value

since 1.00

public - (Optional, default: false) can be one of:

• Boolean - if set to true, the variable is broadcast globally and is persistent (JIP compatible) GEGlobal
• Number - the variable is only set on the client with the given Machine network ID. If the number is negative, the variable is set on every client except for the one with the given ID.
• Array of Numbers - array of Machine network IDs

This parameter is only available if the varspace parameter is a Namespace, Object or Group. Furthermore, only the following Data Types can be broadcast:

Type	Number	Boolean	Object	Group	String	Text	Array	Code	Nothing (nil)	HashMap
Since	1.34	1.34	1.34	1.34	1.00	1.00	1.09	1.09	1.26	2.02

Return Value:

Nothing

Examples

Example 1:

_myTruck setVariable ["TAG_myPublicVariable", 123, true];

Example 2:

_myTruck setVariable ["TAG_myLocalVariable", ["321", _var], owner driver _myTruck];

Example 3:

missionNamespace setVariable ["TAG_myName", "Brian"]; hint TAG_myName; // hints "Brian"

Example 4:

Get the current value of a variable or, if it is undefined, define it and then get the value:

private _var = missionNamespace getVariable "VarName"; if (isNil "_var") then { _var = 123; missionNamespace setVariable ["VarName", _var]; }; // _var now contains the current value of the missionNamespace's variable varName

Example 5:

Remove TAG_myPublicVariable from _myTruck (globally):

_myTruck setVariable ["TAG_myPublicVariable", nil, true];

Additional Information

See also:

getVariable allVariables setFSMVariable

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Posted on Aug 18, 2007 - 09:51 (UTC)

Killswitch

According to Suma, beginning with ArmA version 1.08:

«

« setVariable now should work on any entity which can be targeted by AI, including soldier and game logic units. This includes most buildings, but not other static objects. Using it with buildings one should be aware the building may be discarded because of streaming. In such case the variable space is lost. When used for buildings, the storage should therefore be considered non-reliable. » – Suma

Posted on Dec 09, 2015 - 20:18 (UTC)

Commy2

This command does not work with CfgAmmo or CfgNonAIVehicles objects, like bullets, mines or butterflies.

Posted on Mar 23, 2022 - 08:59 (UTC)

Leopard20

Since 2.10 setVariable works on CfgAmmo objects (such as bullets, missiles, grenades, mines, etc) as well.