setVariable

-wrong parameter ("Arma") defined!-1.00

GAGlobalLELocal

Hover & click on the images for description

Description

Description:

Set variable to given value in the variable space of given element.
To remove a variable, set it to nil (e.g. player setVariable ["varname", nil];).
When variable is set on Task, it is not actually set on task itself, but on FSM attached to the task. So if there is no FSM setVariable will not work.
All available variable spaces which support setVariable:

• Namespace setVariable Array
• Object setVariable Array
• Group setVariable Array
• Team_Member setVariable Array
• Task setVariable Array
• Location setVariable Array
• Control setVariable Array (since Arma 3 v1.55.133553)
• Display setVariable Array (since Arma 3 v1.55.133553)

In Arma 3 it is possible to broadcast nil value

Multiplayer:

The variable space of the object is local to each client and by default changes are not broadcast.
Since Arma 2: If the public parameter for supported types is true, the value will be synchronized also for a JIP player.

Groups:

Uncategorised

Syntax

Syntax:

varspace setVariable [name, value]

Parameters:

varspace: Namespace, Object, Group, Team_Member, Task, Location, Control, Display - variable space in which variable can be set

[name, value]: Array

name: String - variable name

value: Anything - variable value

Return Value:

Nothing

Alternative Syntax

Syntax:

varspace setVariable [name, value, public]           This syntax could have global effect Template:EffArg

Parameters:

varspace: missionNamespace, Object or Group - variable space in which variable can be set

[name, value, public]: Array

name: String - variable name

value: Anything - variable value (if public is true, check publicVariable for what types are supported for broadcast)

public: Boolean, Number or Array of Numbers

• Boolean - when true, the variable broadcast is global and persistent Template:EffArg
• Number - the variable is set only on the client of given owner (clientOwner) id, or if id is negative, the variable is set on every client except the given one
• Array of Numbers - array of owner (clientOwner) ids

Return Value:

Nothing

Examples

Example 1:

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

Example 2:

_myTruck setVariable ["myLocalVariable", ["321", _var], false];

Example 3:

missionNamespace setVariable ["myName", "KK"]; hint myName; //KK

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 { missionNamespace setVariable ["varName", 123]; _var = 123; }; // _var here will contain current value of the variable varName

Additional Information

See also:

getVariableallVariablessetFSMVariableMP editing guide

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

Notes

Posted on 18 August, 2007 - 09:51

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." Reference: Make setVariable work on other things than just vehicles

Bottom Section

Posted on June 13, 2014 - 19:19 (UTC)

Astus Darkblossom

(A3) Disable randomization and set a color to randomized vehicles by using ‘this setVariable ["color",X]’ in the init of the vehicle where X is a number ranging from 0 to the number of skins (minus 1). If the number is out of range, the skin is still randomized.

Posted on December 9, 2015 - 20:18 (UTC)

Commy2

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