From Bohemia Interactive Community
Revision as of 20:54, 16 July 2021 by Lou Montana (talk | contribs) (Page cleanup)
Jump to navigation Jump to search
Hover & click on the images for 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 variable names can be any string but reserved names such as script commands. For example: missionNamespace setVariable ["west", 123]; will result in error:
Error in expression <missionNamespace setVariable ["west", 123];>
	Error position: <setVariable ["west", 123];>
	Error Reserved variable in expression
as west is a scripting command. Other varspaces do not have such limitation. See also all available script commands.
The variable space of the object is local to each client and by default changes are not broadcast.


varspace setVariable [name, value, public]
varspace: variable space in which variable can be set. Can be one of:
support public parameter local usage only (no public parameter)
name: String - variable name
value: Anything - variable value
public: Boolean, Number or Array of Numbers - (Optional, default false): Template:Since Broadcast of the following Data Types is supported:
Type Number Boolean Object Group String Text Array Code Nothing (nil) HashMap
Since Logo A0.png1.34 Logo A0.png1.34 Logo A0.png1.34 Logo A0.png1.34 Logo A1 black.png1.00 Logo A1 black.png1.00 Logo A1 black.png1.09 Logo A1 black.png1.09 Arma 3 logo black.png1.26 Arma 3 logo black.png2.02
Return Value:


Example 1:
_myTruck setVariable ["TAG_myPublicVariable", 123, true];
Example 2:
_myTruck setVariable ["TAG_myLocalVariable", ["321", _var], driver _myTruck];
Example 3:
missionNamespace setVariable ["TAG_myName", "Brian"]; hint TAG_myName; // hints "Brian"
Example 4:
Get current value of a variable and if it is undefined, define it and get the defined value: private _var = missionNamespace getVariable "varName"; if (isNil "_var") then { _var = 123; missionNamespace setVariable ["varName", _var]; }; // _var here will contain current value of the variable varName
Example 5:
Unset _myTruck's TAG_myPublicVariable variable globally: _myTruck setVariable ["TAG_myPublicVariable", nil, true];

Additional Information

See also:
getVariableallVariablessetFSMVariableMultiplayer Scripting


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 December 9, 2015 - 20:18 (UTC)
This command does not work with CfgAmmo or CfgNonAIVehicles objects, like bullets, mines or butterflies.