addAction: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<dl class="command_description"> <dt></dt>" to "<dl class="command_description"> <dt></dt>")
m (Text replacement - "↵↵</sqf>" to " </sqf>")
 
(60 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:TabView
{{TabView


|selected= 3
|selected= 2


|title1= {{Icon|ofp|24|link=}} {{ofp}} '''to''' {{Icon|arma2oa|24|link=}} {{arma2oa}}
|title1= {{TabView/GameTitle|ofp|tkoh}}
|content1=
|content1=
{{RV|type=command
{{RV|type=command
Line 18: Line 18:
|game4= arma2oa
|game4= arma2oa
|version4= 1.50
|version4= 1.50
|game5= tkoh
|version5= 1.00


|gr1= Interaction
|gr1= Interaction
Line 29: Line 32:
|mp= The command will be ignored on dedicated servers, probably because no UI exists.
|mp= The command will be ignored on dedicated servers, probably because no UI exists.


|pr= Due to a bug in {{ofp}}, actions added via [[addAction]] do not get properly updated after mounting vehicles. When you have several actions available while mounting a vehicle and drive away from the actions' position, they will still be shown in the menu until you dismount and remount the vehicle.
|pr= {{Feature|ofp|Due to a bug in {{ofp}}, actions added ''via'' [[addAction]] do not get properly updated after mounting vehicles. When several actions are available while mounting a vehicle and it drives away from the actions' position, they will still be shown in the menu until dismounting/boarding the vehicle again.}}


|s1= object '''addAction''' [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition]
|s1= object [[addAction]] [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition, positionInModel, radius, radiusView, showIn3D, available, textDefault, textToolTip]


|p1= '''object''': [[Object]] - Unit, vehicle or static object. '''No [[createAgent|agents]]!'''</br></br>
|p1= '''object''': [[Object]] - unit, vehicle or static object. '''No [[createAgent|agents]]!'''


|p2= '''title''': [[String]] - The action name which is displayed in the action menu, may contain [[Structured Text]]. Because of that '''<''' and '''>''' symbols will be interpreted as opening and closing XML tags. To avoid this use <tt>&amp;lt;</tt> for '''&lt;''' and <tt>&amp;gt;</tt> for '''&gt;'''. The title text appearance can be changed with [[setUserActionText]]</br></br>
|p2= '''title''': [[String]] - the action name which is displayed in the action menu, may contain [[Structured Text]]. Because of that '''<''' and '''>''' symbols will be interpreted as opening and closing XML tags. To avoid this use {{hl|&amp;lt;}} for '''&lt;''' and {{hl|&amp;gt;}} for '''&gt;'''. The title text appearance can be changed with [[setUserActionText]]


|p3= '''script''': [[String]] or [[Code]] - Either path to the script file, relative to the mission folder or string with code or the actual script code. If the string is a path to script file, the script file '''must''' have extension .[[SQS Syntax|SQS]] or .[[SQF Syntax|SQF]]. The script, whether it is a file or a code, will run in [[Scheduler#Scheduled Environment|scheduled environment]], i.e. it is ok to use [[sleep]]. Parameters array passed to the script upon activation in ''[[Magic Variables#this|_this]]'' variable is:
|p3= '''script''': [[String]] or {{GVI|tkoh|1.00|size= 0.75}} [[Code]] - path to the script file relative to the mission folder, or code to execute. It will run in [[Scheduler#Scheduled Environment|scheduled environment]], i.e. it is ok to use [[sleep]]. Parameters array passed to the script upon activation in ''[[Magic Variables#this|_this]]'' variable is:
<syntaxhighlight lang="cpp">params ["_target", "_caller", "_actionId", "_arguments"];</syntaxhighlight>
<sqf>params ["_target", "_caller", "_actionId", "_arguments"];</sqf>
* '''target''': [[Object]] - the object which the action is assigned to
* '''target''': [[Object]] - the object which the action is assigned to
* '''caller''': [[Object]] - the unit that activated the action
* '''caller''': [[Object]] - the unit that activated the action
* '''actionID''': [[Number]] - activated action's ID (same as [[addAction]]'s return value)
* '''actionID''': [[Number]] - activated action's ID (same as [[addAction]]'s return value)
* '''arguments''': [[Anything]] - arguments given to the script if you are using the extended syntax</br></br>
* '''arguments''': [[Anything]] - arguments given to the script if you are using the extended syntax


|p4= '''arguments''': [[Anything]] - (Optional, default [[nil]]) arguments to pass to the script. Accessible with {{ic|_this [[select]] 3}} inside the script. If [[Array]] is used as an argument for example, its first element reference would be {{ic|_this [[select]] 3 [[select]] 0}}</br></br>
|p4= '''arguments''': [[Anything]] - (Optional, default [[nil]]) arguments to pass to the script. Accessible with <sqf inline>_this select 3</sqf> inside the script. If [[Array]] is used as an argument for example, its first element reference would be <sqf inline>_this select 3 select 0</sqf>
|p4since= arma1 1.00


|p5= '''priority''': [[Number]] - (Optional, default 1.5) Priority value of the action. Actions will be arranged in descending order according to this value. Every game action has a preset priority value. Value can be negative or decimal fraction. Actions with same values will be arranged in order which they were made, newest at the bottom. The bigger the number the higher the action will be positioned on the menu. Typical range is 0 to 6</br></br>
|p5= '''priority''': [[Number]] - (Optional, default 1.5) priority value of the action. Actions will be arranged in descending order according to this value. Every game action has a preset priority value. Value can be negative or decimal fraction. Actions with same values will be arranged in order which they were made, newest at the bottom. The bigger the number the higher the action will be positioned on the menu. Typical range is 0 to 6
|p5since= arma1 1.00


|p6= '''showWindow''': [[Boolean]] - (Optional, default [[true]]) If set to [[true]], players see "Titletext" at mid-lower screen, as they approach the object. Only the title text for the action with highest priority and ''showWindow'' set to [[true]] will be shown.</br></br>
|p6= '''showWindow''': [[Boolean]] - (Optional, default [[true]]) if set to [[true]], players see "Titletext" at mid-lower screen, as they approach the object. Only the title text for the action with highest priority and ''showWindow'' set to [[true]] will be shown
|p6since= arma1 1.00


|p7= '''hideOnUse''': [[Boolean]] - (Optional, default [[true]]) If set to [[true]], it will hide the action menu after selecting it. If set to [[false]], it will leave the action menu open and visible after selecting the action, leaving the same action highlighted, for the purpose of allowing you to re-select that same action quickly, or to select another action</br></br>
|p7= '''hideOnUse''': [[Boolean]] - (Optional, default [[true]]) if set to [[true]], it will hide the action menu after selecting it. If set to [[false]], it will leave the action menu open and visible after selecting the action, leaving the same action highlighted, for the purpose of allowing you to re-select that same action quickly, or to select another action
|p7since= arma1 1.00


|p8= '''shortcut''': [[String]] - (Optional, default "") One of the [[:Category:Key Actions|key names]] defined in bin.pbo (e.g. "moveForward"). Adding available shortcut will bind corresponding keyboard key to this action. Shortcut availability can be tested with [[inputAction]] command</br></br>
|p8= '''shortcut''': [[String]] - (Optional, default "") one of the [[:Category:Key Actions|key names]] defined in bin.pbo (e.g. "moveForward"). Adding available shortcut will bind corresponding keyboard key to this action. Shortcut availability can be tested with [[inputAction]] command
|p8since= arma1 1.00


|p9= '''condition''': [[String]] - (Optional, default "true") Expression that must return [[true]] for the action to be shown. '''Special variables''' passed to the script code are:
|p9= '''condition''': [[String]] - (Optional, default "true") expression that must return [[true]] for the action to be shown. '''Special variables''' passed to the script code are:
* ''_target'': [[Object]] - The object to which action is attached or, if the object is a unit inside of vehicle, the vehicle
* ''_target'': [[Object]] - The object to which action is attached or, if the object is a unit inside of vehicle, the vehicle
* ''_this'': [[Object]] - Caller person to whom the action is shown (or not shown if ''condition'' returns [[false]])
* ''_this'': [[Object]] - Caller person to whom the action is shown (or not shown if ''condition'' returns [[false]])
* ''_originalTarget'': [[Object]] - The original object to which the action is attached, regardless if the object/unit is in a vehicle or not
* ''_originalTarget'': [[Object]] - The original object to which the action is attached, regardless if the object/unit is in a vehicle or not
{{Feature|important|
{{Feature|important|
* ''condition'' is evaluated on each frame in [[Scheduler#Unscheduled Environment|non-scheduled environment]].
* ''condition'' is evaluated on each frame in [[Scheduler#Unscheduled Environment|unscheduled environment]].
* ''condition'' is '''not''' evaluated if a dialog is open.
* ''condition'' is '''not''' evaluated if a dialog is open.
* If action is added to an object and not to [[player]], the ''condition'' will only get evaluated if player is closer than ~50m to the object surface and is looking at the object.
* If action is added to an object and not to the [[player]], ''condition'' will only get evaluated if the player is closer than ~50m to the object surface and is looking at the object.
* If action is added to [[player]], ''condition'' is evaluated all the time.}}</br></br>
* If action is added to [[player]], ''condition'' is evaluated all the time.}}
 
|p9since= arma2 1.00
|r1= [[Number]] - The added action's ID. Action can be removed with [[removeAction]] (see also [[removeAllActions]]). IDs are incrementing, the first given action to each unit has the ID 0, the second the ID 1, etc. IDs are also passed to the called script (see [[#Syntax|''script'' parameter]])
 
|x1= <code>{{cc|short and sweet}}
[[player]] [[addAction]] ["a useless action that does nothing", {}];
[[player]] [[addAction]] ["<t color='#FF0000'>This Useless Action Is RED</t>", {[[hint]] "RED"}];
[[player]] [[addAction]] ["Hint Hello!", { [[hint]] [[format]] ["Hello %1!", [[name]] [[player]]] }];
[[player]] [[addAction]] ["String Exec", "[[hint]] 'this is also compiled'"];</code>
 
|x2= <code>_actionID = [[player]] [[addAction]] ["Exec the file", "scriptFile.sqf"]</code>
'''scriptFile.sqf:'''
<code>[[hint]] [[str]] [[Magic Variables#this|_this]];</code>
 
|seealso= [[actionIDs]], [[actionParams]], [[setUserActionText]], [[inGameUISetEventHandler]], [[showHUD]], [[inputAction]]
[[removeAction]], [[removeAllActions]], [[action]]
}}
 
|title2= {{Icon|tkoh|24|link=}} {{tkoh}}
|content2=
{{RV|type=command
 
|game1= tkoh
|version1= 1.00
 
|arg= global
 
|eff= local
 
|gr1= Interaction
 
|descr= Adds an entry to the action menu of an object. The action can only be activated when in proximity to the object '''and''' looking at it. Adding an action to the player makes that action available to the player at all times. For event handling of user interaction see [[inGameUISetEventHandler]].
 
|mp= The command will be ignored on dedicated servers, probably because no UI exists.
 
|s1= object '''addAction''' [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition, positionInModel, radius, radiusView, showIn3D, available, textDefault, textToolTip]
 
|p1= '''object''': [[Object]] -  Unit, vehicle or static object. '''No [[createAgent|agents]]!'''</br></br>
 
|p2= '''title''': [[String]] - The action name which is displayed in the action menu, may contain [[Structured Text]]. Because of that '''<''' and '''>''' symbols will be interpreted as opening and closing XML tags. To avoid this use <tt>&amp;lt;</tt> for '''&lt;''' and <tt>&amp;gt;</tt> for '''&gt;'''. The title text appearance can be changed with [[setUserActionText]]</br></br>
 
|p3= '''script''': [[String]] or [[Code]] - Either path to the script file, relative to the mission folder or string with code or the actual script code. If the string is a path to script file, the script file '''must''' have extension .[[SQS Syntax|SQS]] or .[[SQF Syntax|SQF]]. The script, whether it is a file or a code, will run in [[Scheduler#Scheduled Environment|scheduled environment]], i.e. it is ok to use [[sleep]]. Parameters array passed to the script upon activation in ''[[Magic Variables#this|_this]]'' variable is:
<syntaxhighlight lang="cpp">params ["_target", "_caller", "_actionId", "_arguments"];</syntaxhighlight>
* '''target''': [[Object]] - the object which the action is assigned to
* '''caller''': [[Object]] - the unit that activated the action
* '''actionID''': [[Number]] - activated action's ID (same as [[addAction]]'s return value)
* '''arguments''': [[Anything]] - arguments given to the script if you are using the extended syntax</br></br>
 
|p4= '''arguments''': [[Anything]] - (Optional, default [[nil]]) arguments to pass to the script. Accessible with {{ic|_this [[select]] 3}} inside the script. If [[Array]] is used as an argument for example, its first element reference would be {{ic|_this [[select]] 3 [[select]] 0}}</br></br>


|p5= '''priority''': [[Number]] - (Optional, default 1.5) Priority value of the action. Actions will be arranged in descending order according to this value. Every game action has a preset priority value. Value can be negative or decimal fraction. Actions with same values will be arranged in order which they were made, newest at the bottom. The bigger the number the higher the action will be positioned on the menu. Typical range is 0 to 6</br></br>
|p10= '''positionInModel''': [[String]] - (Optional, default "") name of the named selection in the model for positioning the action in 3D space; typically a memory point
|p10since= tkoh 1.00


|p6= '''showWindow''': [[Boolean]] - (Optional, default [[true]]) If set to [[true]], players see "Titletext" at mid-lower screen, as they approach the object. Only the title text for the action with highest priority and ''showWindow'' set to [[true]] will be shown.</br></br>
|p11= '''radius''': [[Number]] - (Optional, default 50) maximum 3D [[distance]] in meters between the activating unit's [[eyePos]] and the ''object<nowiki>'</nowiki>s'' ''memoryPoint'', ''selection'' or [[position]]. -1 disables the radius
|p11since= tkoh 1.00


|p7= '''hideOnUse''': [[Boolean]] - (Optional, default [[true]]) If set to [[true]], it will hide the action menu after selecting it. If set to [[false]], it will leave the action menu open and visible after selecting the action, leaving the same action highlighted, for the purpose of allowing you to re-select that same action quickly, or to select another action</br></br>
|p12= '''radiusView''': [[Number]] - (Optional, default '''unknown''') maximum distance in meters the cursor can be away from the 3D action to activate it. -1 disables this radius
|p12since= tkoh 1.00


|p8= '''shortcut''': [[String]] - (Optional, default "") One of the [[:Category:Key Actions|key names]] defined in bin.pbo (e.g. "moveForward"). Adding available shortcut will bind corresponding keyboard key to this action. Shortcut availability can be tested with [[inputAction]] command</br></br>
|p13= '''showIn3D''': [[Number]] - (Optional, default '''unknown''') condition for showing the action in 3D space. Can be combined e.g. <sqf inline>2 + 32</sqf>
 
|p9= '''condition''': [[String]] - (Optional, default "true") Expression that must return [[true]] for the action to be shown. '''Special variables''' passed to the script code are:
* ''_target'': [[Object]] - The object to which action is attached or, if the object is a unit inside of vehicle, the vehicle
* ''_this'': [[Object]] - Caller person to whom the action is shown (or not shown if ''condition'' returns [[false]])
* ''_originalTarget'': [[Object]] - The original object to which the action is attached, regardless if the object/unit is in a vehicle or not
{{Feature|important|
* ''condition'' is evaluated on each frame in [[Scheduler#Unscheduled Environment|non-scheduled environment]].
* ''condition'' is '''not''' evaluated if a dialog is open.
* If action is added to an object and not to [[player]], the ''condition'' will only get evaluated if player is closer than ~50m to the object surface and is looking at the object.
* If action is added to [[player]], ''condition'' is evaluated all the time.}}</br></br>
 
|p10= '''radius''': [[Number]] - (Optional, default 50) Maximum 3D [[distance]] in meters between the activating unit's [[eyePos]] and the ''object<nowiki>'</nowiki>s'' ''memoryPoint'', ''selection'' or [[position]]. -1 disables the radius</br></br>
 
|p11= '''radiusView''': [[Number]] - (Optional, default '''unknown''') Maximum distance in meters the cursor can be away from the 3D action to activate it. -1 disables this radius</br></br>
 
|p12= '''showIn3D''': [[Number]] - (Optional, default '''unknown''') Condition for showing the action in 3D space. Can be combined e.g. {{ic|2 + 32}}
* 1 - show
* 1 - show
* 2 - draw if unit is pilot
* 2 - draw if unit is pilot
Line 141: Line 89:
* 16 - draw if not in external camera
* 16 - draw if not in external camera
* 32 - draw if not in internal camera
* 32 - draw if not in internal camera
* 64 - draw if not in gunner camera (turret optics)</br></br>
* 64 - draw if not in gunner camera (turret optics)
|p13since= tkoh 1.00


|p13= '''available''': [[Number]] - (Optional, default '''unknown''') Condition for being able to activate the action. Can be combined e.g. {{ic|1 + 4}}
|p14= '''available''': [[Number]] - (Optional, default '''unknown''') condition for being able to activate the action. Can be combined e.g. <sqf inline>1 + 4</sqf>
* 0 - disabled
* 0 - disabled
* 1 - unit is pilot or copilot
* 1 - unit is pilot or copilot
* 2 - unit is inside target
* 2 - unit is inside target
* 4 - unit is not inside target</br></br>
* 4 - unit is not inside target
|p14since= tkoh 1.00
 
|p15= '''textDefault''': [[String]] - (Optional, default "") structured Text which is shown as the 3D action (so it can be an icon), or in the center of the screen when the action is highlighted in the action menu for a 2D action
|p15since= tkoh 1.00
 
|p16= '''textToolTip''': [[String]] - (Optional, default "") structured Text which is faded in under the textDefault when hovering over the action in 3D space
|p16since= tkoh 1.00


|p14= '''textDefault''': [[String]] - (optional, default "") Structured Text which is shown as the 3D action (so it can be an icon), or in the center of the screen when the action is highlighted in the action menu for a 2D action</br></br>
|r1= [[Number]] - the added action's ID. Action can be removed with [[removeAction]] (see also [[removeAllActions]]). IDs are incrementing, the first given action to each unit has the ID 0, the second the ID 1, etc. IDs are also passed to the called script (see the [[#Syntax|''script'' parameter]])


|p15= '''textToolTip''': [[String]] - (optional, default "") Structured Text which is faded in under the textDefault when hovering over the action in 3D space
|x1= <sqf>
// short and sweet
player addAction ["a useless action that does nothing", {}];
player addAction ["<t color='#FF0000'>This Useless Action Is RED</t>", { hint "RED" }];
player addAction ["Hint Hello!", { hint format ["Hello %1!", name player] }];
player addAction ["String Exec", "hint 'this is also compiled'"];
</sqf>


|r1= [[Number]] - The added action's ID. Action can be removed with [[removeAction]] (see also [[removeAllActions]]). IDs are incrementing, the first given action to each unit has the ID 0, the second the ID 1, etc. IDs are also passed to the called script (see [[#Syntax|''script'' parameter]])
|x2= <sqf>_actionID = player addAction ["Exec the file", "scriptFile.sqf"];</sqf>
'''scriptFile.sqf:'''
<sqf>hint str _this;</sqf>


|x1= <code>_heli '''addAction'''
|x3= {{tkoh}}:
<sqf>
_heli addAction
[
[
"Test",
"Test",
Line 171: Line 137:
0,
0,
"<img image='\HSim\UI_H\data\ui_action_autohover_ca.paa' size='1.8' shadow=0 />",
"<img image='\HSim\UI_H\data\ui_action_autohover_ca.paa' size='1.8' shadow=0 />",
"<nowiki><br /></nowiki>My test tooltip"
"<br />My test tooltip"
];</code>
];
</sqf>


|seealso= [[actionIDs]], [[actionParams]], [[setUserActionText]], [[inGameUISetEventHandler]], [[showHUD]], [[inputAction]]
|seealso= [[actionIDs]] [[actionParams]] [[setUserActionText]] [[inGameUISetEventHandler]] [[showHUD]] [[inputAction]] [[removeAction]] [[removeAllActions]] [[action]]
[[removeAction]], [[removeAllActions]], [[action]]
}}
}}


|title3= {{Icon|arma3|24|link=}} {{arma3}}
|title2= {{TabView/GameTitle|arma3}}
|content3=
|content2=
{{RV|type=command
{{RV|type=command


Line 197: Line 163:
|s1= object [[addAction]] [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition, radius, unconscious, selection, memoryPoint]
|s1= object [[addAction]] [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition, radius, unconscious, selection, memoryPoint]


|p1= '''object''': [[Object]] - Unit, vehicle or static object. '''No [[createAgent|agents]] and [[Arma 3 Simple Objects|simple objects]]!'''</br></br>
|p1= '''object''': [[Object]] - unit, vehicle or static object. '''No [[createAgent|agents]] and [[Arma 3: Simple Objects|simple objects]]!'''


|p2= '''title''': [[String]] - The action name which is displayed in the action menu, may contain [[Structured Text]]. Because of that '''<''' and '''>''' symbols will be interpreted as opening and closing XML tags. To avoid this use <tt>&amp;lt;</tt> for '''&lt;''' and <tt>&amp;gt;</tt> for '''&gt;'''. The title text appearance can be changed with [[setUserActionText]]</br></br>
|p2= '''title''': [[String]] - the action name displayed in the action menu, may contain [[Structured Text]]. Because of that '''<''' and '''>''' symbols will be interpreted as opening and closing XML tags. To avoid this use {{hl|&amp;lt;}} for '''&lt;''' and {{hl|&amp;gt;}} for '''&gt;'''. The title text appearance can be changed with [[setUserActionText]]


|p3= '''script''': [[String]] or [[Code]] - Either path to the script file, relative to the mission folder or string with code or the actual script code. If the string is a path to script file, the script file '''must''' have extension .[[SQS Syntax|SQS]] or .[[SQF Syntax|SQF]]. The script, whether it is a file or a code, will run in [[Scheduler#Scheduled Environment|scheduled environment]], i.e. it is ok to use [[sleep]]. Parameters array passed to the script upon activation in ''[[Magic Variables#this|_this]]'' variable is:
|p3= '''script''': [[String]] or [[Code]] - either path to the script file, relative to the mission folder or string with code or the actual script code. If the string is a path to script file, the script file '''must''' have extension .[[SQS Syntax|SQS]] or .[[SQF Syntax|SQF]]. The script, whether it is a file or a code, will run in [[Scheduler#Scheduled Environment|scheduled environment]], i.e. it is ok to use [[sleep]]. Parameters array passed to the script upon activation in ''[[Magic Variables#this|_this]]'' variable is:
<syntaxhighlight lang="cpp">params ["_target", "_caller", "_actionId", "_arguments"];</syntaxhighlight>
<sqf>params ["_target", "_caller", "_actionId", "_arguments"];</sqf>
* '''target''': [[Object]] - the object which the action is assigned to
* '''target''': [[Object]] - the object which the action is assigned to
* '''caller''': [[Object]] - the unit that activated the action
* '''caller''': [[Object]] - the unit that activated the action
* '''actionID''': [[Number]] - activated action's ID (same as [[addAction]]'s return value)
* '''actionID''': [[Number]] - activated action's ID (same as [[addAction]]'s return value)
* '''arguments''': [[Anything]] - arguments given to the script if you are using the extended syntax</br></br>
* '''arguments''': [[Anything]] - arguments given to the script if you are using the extended syntax


|p4= '''arguments''': [[Anything]] - (Optional, default [[nil]]) arguments to pass to the script. Accessible with {{ic|_this [[select]] 3}} inside the script. If [[Array]] is used as an argument for example, its first element reference would be {{ic|_this [[select]] 3 [[select]] 0}}</br></br>
|p4= '''arguments''': [[Anything]] - (Optional, default [[nil]]) arguments to pass to the script. Accessible with <sqf inline>_this select 3</sqf> inside the script. If [[Array]] is used as an argument for example, its first element reference would be <sqf inline>_this select 3 select 0</sqf>


|p5= '''priority''': [[Number]] - (Optional, default 1.5) Priority value of the action. Actions will be arranged in descending order according to this value. Every game action has a preset priority value. Value can be negative or decimal fraction. Actions with same values will be arranged in order which they were made, newest at the bottom. The bigger the number the higher the action will be positioned on the menu. Typical range is 0 to 6</br></br>
|p5= '''priority''': [[Number]] - (Optional, default 1.5) priority value of the action. Actions will be arranged in descending order according to this value. Every game action has a preset priority value. Value can be negative or decimal fraction. Actions with same values will be arranged in order which they were made, newest at the bottom. The bigger the number the higher the action will be positioned on the menu. Typical range is 0 to 6


|p6= '''showWindow''': [[Boolean]] - (Optional, default [[true]]) If set to [[true]], players see "Titletext" at mid-lower screen, as they approach the object. Only the title text for the action with highest priority and ''showWindow'' set to [[true]] will be shown.</br></br>
|p6= '''showWindow''': [[Boolean]] - (Optional, default [[true]]) if set to [[true]], players see "Titletext" at mid-lower screen, as they approach the object. Only the title text for the action with highest priority and ''showWindow'' set to [[true]] will be shown


|p7= '''hideOnUse''': [[Boolean]] - (Optional, default [[true]]) If set to [[true]], it will hide the action menu after selecting it. If set to [[false]], it will leave the action menu open and visible after selecting the action, leaving the same action highlighted, for the purpose of allowing you to re-select that same action quickly, or to select another action</br></br>
|p7= '''hideOnUse''': [[Boolean]] - (Optional, default [[true]]) if set to [[true]], it will hide the action menu after selecting it. If set to [[false]], it will leave the action menu open and visible after selecting the action, leaving the same action highlighted, for the purpose of allowing you to re-select that same action quickly, or to select another action


|p8= '''shortcut''': [[String]] - (Optional, default "") One of the [[:Category:Key Actions|key names]] defined in bin.pbo (e.g. "moveForward"). Adding available shortcut will bind corresponding keyboard key to this action. Shortcut availability can be tested with [[inputAction]] command</br></br>
|p8= '''shortcut''': [[String]] - (Optional, default "") one of the [[:Category:Key Actions|key names]] defined in bin.pbo (e.g. "moveForward"). Adding available shortcut will bind corresponding keyboard key to this action. Shortcut availability can be tested with [[inputAction]] command


|p9= '''condition''': [[String]] - (Optional, default "true") Expression that must return [[true]] for the action to be shown. '''Special variables''' passed to the script code are:
|p9= '''condition''': [[String]] - (Optional, default "true") expression that must return [[true]] for the action to be shown. '''Special variables''' passed to the script code are:
* ''_target'': [[Object]] - The object to which action is attached or, if the object is a unit inside of vehicle, the vehicle
* ''_target'': [[Object]] - The object to which action is attached or, if the object is a unit inside of vehicle, the vehicle
* ''_this'': [[Object]] - Caller person to whom the action is shown (or not shown if ''condition'' returns [[false]])
* ''_this'': [[Object]] - Caller person to whom the action is shown (or not shown if ''condition'' returns [[false]])
* ''_originalTarget'': [[Object]] - The original object to which the action is attached, regardless if the object/unit is in a vehicle or not
* ''_originalTarget'': [[Object]] - The original object to which the action is attached, regardless if the object/unit is in a vehicle or not
* ''_actionId'': [[Number]] - checked action's ID (same as [[addAction]]'s return value)
{{Feature|warning|If the player is the group leader, has an action added to them, and selects a subordinate, {{hl|''_this''}} alternatively switches between the player and this selected unit - RPT logging {{hl|Unknown attribute itemsCmd}} in the process.}}
{{Feature|important|
{{Feature|important|
* ''condition'' is evaluated on each frame in [[Scheduler#Unscheduled Environment|non-scheduled environment]].
* ''condition'' is evaluated on each frame in [[Scheduler#Unscheduled Environment|unscheduled environment]].
* ''condition'' is '''not''' evaluated if a dialog is open.
* ''condition'' is '''not''' evaluated if a dialog is open.
* If action is added to an object and not to [[player]], the ''condition'' will only get evaluated if player is closer than ~50m to the object surface and is looking at the object.
* If action is added to an object and not to the [[player]], ''condition'' will only get evaluated if the player is closer than ~50m to the object surface and is looking at the object.
* If action is added to [[player]], ''condition'' is evaluated all the time.}}</br></br>
* If action is added to [[player]], ''condition'' is evaluated all the time.
}}


|p10= '''radius''': [[Number]] - (Optional, default 50) Maximum 3D [[distance]] in meters between the activating unit's [[eyePos]] and the ''object<nowiki>'</nowiki>s'' ''memoryPoint'', ''selection'' or [[position]]. -1 disables the radius {{Since|arma3|1.64|y}}</br></br>
|p10= '''radius''': [[Number]] - (Optional, default 50) maximum 3D [[distance]] in meters between the activating unit's [[eyePos]] and ''object''<nowiki/>'s ''memoryPoint'', ''selection'' or [[position]]. -1 disables the radius; hardcoded limit is '''50'''
|p10since= arma3 1.64


|p11= '''unconscious''': [[Boolean]] - (Optional, default [[false]]) If [[true]] will be shown to incapacitated player. See also [[setUnconscious]] and [[lifeState]]{{Since|arma3|1.64|y}}</br></br>
|p11= '''unconscious''': [[Boolean]] - (Optional, default [[false]]) if [[true]] will be shown to incapacitated player. See also [[setUnconscious]] and [[lifeState]]
|p11since= arma3 1.64


|p12= '''selection''': [[String]] - (Optional, default "") ''object<nowiki>'</nowiki>s'' geometry LOD's named selection {{Since|arma3|1.70|y}}</br></br>
|p12= '''selection''': [[String]] - (Optional, default "") ''object''<nowiki/>'s geometry LOD's named selection
|p12since= arma3 1.70


|p13= '''memoryPoint''': [[String]] - (Optional, default "") ''object<nowiki>'</nowiki>s'' memory point. If ''selection'' is supplied, ''memoryPoint'' is not used {{Since|arma3|1.82|y}}</br></br>
|p13= '''memoryPoint''': [[String]] - (Optional, default "") ''object''<nowiki/>'s memory point. If ''selection'' is supplied, ''memoryPoint'' is not used
|p13since= arma3 1.82


|r1= [[Number]] - The added action's ID. Action can be removed with [[removeAction]] (see also [[removeAllActions]]). IDs are incrementing, the first given action to each unit has the ID 0, the second the ID 1, etc. IDs are also passed to the called script (see [[#Syntax|''script'' parameter]])
|r1= [[Number]] - the added action's ID. Action can be removed with [[removeAction]] (see also [[removeAllActions]]). IDs are incrementing, the first given action to each unit has the ID 0, the second the ID 1, etc. IDs are also passed to the called script (see the [[#Syntax 2|''script'' parameter]])


|x1= <code>{{cc|short and sweet}}
|x1= <sqf>
[[player]] [[addAction]] ["a useless action that does nothing", {}];
// short and sweet
[[player]] [[addAction]] ["<t color='#FF0000'>This Useless Action Is RED</t>", {[[hint]] "RED"}];
player addAction ["a useless action that does nothing", {}];
[[player]] [[addAction]] ["Hint Hello!", { [[hint]] [[format]] ["Hello %1!", [[name]] [[player]]] }];
player addAction ["<t color='#FF0000'>This Useless Action Is RED</t>", { hint "RED" }];
[[player]] [[addAction]] ["String Exec", "[[hint]] 'this is also compiled'"];</code>
player addAction ["Hint Hello!", { hint format ["Hello %1!", name player] }];
player addAction ["String Exec", "hint 'this is also compiled'"];
</sqf>


|x2= <code>_actionID = [[player]] [[addAction]] ["Exec the file", "scriptFile.sqf"]</code>
|x2= <sqf>_actionID = player addAction ["Exec the file", "scriptFile.sqf"];</sqf>
'''scriptFile.sqf:'''
'''scriptFile.sqf:'''
<code>[[hint]] [[str]] [[Magic Variables#this|_this]];</code>
<sqf>hint str _this;</sqf>


|x3= <code>{{cc|create object on the server and add action to the object on every client}}
|x3= <sqf>
[[if]] ([[isServer]]) [[then]]
// create object on the server and add action to the object on every client
if (isServer) then
{
{
[[private]] _object = "some_obj_class" [[createVehicle]] [1234, 1234, 0];
private _object = "some_obj_class" createVehicle [1234, 1234, 0];
[_object, ["Greetings!", { [[hint]] "Hello!"; }]] [[remoteExec]] ["addAction"]; {{cc|Note: does '''not''' return action id}}
[_object, ["Greetings!", { hint "Hello!"; }]] remoteExec ["addAction"]; // Note: does not return action id
};</code>
};
</sqf>


|x4= Default parameters:<code>[[Magic Variables#this_2|this]] [[addAction]]
|x4= Default parameters:
<sqf>
this addAction
[
[
"title",
"title",
{
{
[[params]] ["_target", "_caller", "_actionId", "_arguments"];
params ["_target", "_caller", "_actionId", "_arguments"];
},
},
[[nil]],
nil,
1.5,
1.5,
[[true]],
true,
[[true]],
true,
"",
"",
"[[true]]", {{cc|_target, [[Magic Variables#this|_this]], _originalTarget}}
"true",
50,
50,
[[false]],
false,
"",
"",
""
""
];</code>
];
</sqf>


|x5= Default parameters with comments:<code>[[Magic Variables#this_2|this]] [[addAction]]
|x5= Default parameters with comments:
<sqf>
this addAction
[
[
"title", {{cc|title}}
"title", // title
{
{
[[params]] ["_target", "_caller", "_actionId", "_arguments"]; {{cc|script}}
params ["_target", "_caller", "_actionId", "_arguments"]; // script
},
},
[[nil]], {{cc|arguments}}
nil, // arguments
1.5, {{cc|priority}}
1.5, // priority
[[true]], {{cc|showWindow}}
true, // showWindow
[[true]], {{cc|hideOnUse}}
true, // hideOnUse
"", {{cc|shortcut}}
"", // shortcut
"[[true]]", {{cc|condition}}
"true", // condition
50, {{cc|radius}}
50, // radius
[[false]], {{cc|unconscious}}
false, // unconscious
"", {{cc|selection}}
"", // selection
"" {{cc|memoryPoint}}
"" // memoryPoint
];</code>
];
</sqf>


|seealso= [[actionIDs]], [[actionParams]], [[setUserActionText]], [[inGameUISetEventHandler]], [[showHUD]], [[inputAction]]
|seealso= [[actionIDs]] [[actionParams]] [[setUserActionText]] [[inGameUISetEventHandler]] [[showHUD]] [[inputAction]]
[[removeAction]], [[removeAllActions]], [[action]], [[BIS_fnc_holdActionAdd]]
[[removeAction]], [[removeAllActions]], [[action]], [[BIS_fnc_holdActionAdd]]
}}
}}
}}
}}


<dl class="command_description">
{{Note
|user= Dedmen
|timestamp= 20180502134400
|text= If you want to replicate vanilla Actions like "Treat yourself" where the scroll menu only shows text and it displays the icon mid-screen you can use
<sqf>
private _actionId = player addAction ["Heal", {}];
player setUserActionText [_actionId, "Heal", "<img size='2' image='\a3\ui_f\data\IGUI\Cfg\Actions\heal_ca'/>"];
</sqf>
}}
 
{{Note
|user= PierreMGI
|timestamp= 20200512104200
|text= [[addAction]] on unit or player stays on corpse after kill. So this action is lost for the new body after respawn. If you want a persistent addAction, you need to add it in the respawn script ([[Event Scripts#onPlayerRespawn.sqf|onPlayerRespawn.sqf]] or [[addMissionEventHandler]] "entityRespawned" or addMPEventHandler "MPrespawn"...
You can use [[removeAllActions]] on corpse.
}}
 
{{Note
|user= Leopard20
|timestamp= 20220828215200
|text= If the server blocks [[execVM]] in [[Arma 3: CfgRemoteExec|CfgRemoteExec]], you can't use path to script:
<sqf>
_obj addAction ["Test", "path\script.sqf"]; // "path\script.sqf" won't execute
</sqf>


<dt></dt>
You can, however, do this:
<dd class="notedate">Posted on May 02, 2018 - 13:44 (UTC)</dd>
<dt class="note">[[User:Dedmen|Dedmen]]</dt>
<dd class="note">
If you want to replicate vanilla Actions like "Treat yourself" where the scroll menu only shows text and it displays the icon mid-screen you can use
<code>[[private]] _action = [[player]] [[addAction]] ["Heal", {}];
[[player]] [[setUserActionText]] [_action , "Heal", "<img size='2' image='\a3\ui_f\data\IGUI\Cfg\Actions\heal_ca'/>"];
</code>
<dt><dt>
<dd class="notedate">Posted on May 12, 2020 - 10:42 (UTC)</dd>
<dt class="note">[[User:PierreMGI|PierreMGI]]</dt>
<dd class="note">
addAction on unit or player stays on corpse after kill. So this action is lost for the new body after respawn. If you want a persistent addAction, you need to add it in the respawn script (onPlayerRespawn.sqf or addMissionEventHandler "entityRespawned" or addMPEventHandler "MPrespawn"...
You can use [[removeAllActions]] on corpse.


</dl>
<sqf>
_obj addAction ["Test", { _this spawn compile preprocessFileLineNumbers "path\script.sqf" }];
</sqf>
 
But it's recommended to use functions if the script is called frequently.
}}

Latest revision as of 19:48, 3 September 2024

Logo A0.png Operation Flashpoint to tkoh logo small.png Take On Helicopters
Arma 3 logo black.png Arma 3
Hover & click on the images for description

Description

Description:
Adds an entry to the action menu of an object. The action can only be activated when in proximity to the object and looking at it. Adding an action to the player makes that action available to the player at all times. For event handling of user interaction see inGameUISetEventHandler.
Multiplayer:
The command will be ignored on dedicated servers, probably because no UI exists.
Problems:
Operation Flashpoint
Due to a bug in Operation Flashpoint, actions added via addAction do not get properly updated after mounting vehicles. When several actions are available while mounting a vehicle and it drives away from the actions' position, they will still be shown in the menu until dismounting/boarding the vehicle again.
Groups:
Interaction

Syntax

Syntax:
object addAction [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition, positionInModel, radius, radiusView, showIn3D, available, textDefault, textToolTip]
Parameters:
object: Object - unit, vehicle or static object. No agents!
title: String - the action name which is displayed in the action menu, may contain Structured Text. Because of that < and > symbols will be interpreted as opening and closing XML tags. To avoid this use &lt; for < and &gt; for >. The title text appearance can be changed with setUserActionText
script: String or tkoh logo small.png1.00 Code - path to the script file relative to the mission folder, or code to execute. It will run in scheduled environment, i.e. it is ok to use sleep. Parameters array passed to the script upon activation in _this variable is:
params ["_target", "_caller", "_actionId", "_arguments"];
  • target: Object - the object which the action is assigned to
  • caller: Object - the unit that activated the action
  • actionID: Number - activated action's ID (same as addAction's return value)
  • arguments: Anything - arguments given to the script if you are using the extended syntax
since Logo A1 black.png1.00
arguments: Anything - (Optional, default nil) arguments to pass to the script. Accessible with _this select 3 inside the script. If Array is used as an argument for example, its first element reference would be _this select 3 select 0
since Logo A1 black.png1.00
priority: Number - (Optional, default 1.5) priority value of the action. Actions will be arranged in descending order according to this value. Every game action has a preset priority value. Value can be negative or decimal fraction. Actions with same values will be arranged in order which they were made, newest at the bottom. The bigger the number the higher the action will be positioned on the menu. Typical range is 0 to 6
since Logo A1 black.png1.00
showWindow: Boolean - (Optional, default true) if set to true, players see "Titletext" at mid-lower screen, as they approach the object. Only the title text for the action with highest priority and showWindow set to true will be shown
since Logo A1 black.png1.00
hideOnUse: Boolean - (Optional, default true) if set to true, it will hide the action menu after selecting it. If set to false, it will leave the action menu open and visible after selecting the action, leaving the same action highlighted, for the purpose of allowing you to re-select that same action quickly, or to select another action
since Logo A1 black.png1.00
shortcut: String - (Optional, default "") one of the key names defined in bin.pbo (e.g. "moveForward"). Adding available shortcut will bind corresponding keyboard key to this action. Shortcut availability can be tested with inputAction command
since Logo A2.png1.00
condition: String - (Optional, default "true") expression that must return true for the action to be shown. Special variables passed to the script code are:
  • _target: Object - The object to which action is attached or, if the object is a unit inside of vehicle, the vehicle
  • _this: Object - Caller person to whom the action is shown (or not shown if condition returns false)
  • _originalTarget: Object - The original object to which the action is attached, regardless if the object/unit is in a vehicle or not
  • condition is evaluated on each frame in unscheduled environment.
  • condition is not evaluated if a dialog is open.
  • If action is added to an object and not to the player, condition will only get evaluated if the player is closer than ~50m to the object surface and is looking at the object.
  • If action is added to player, condition is evaluated all the time.
since tkoh logo small.png1.00
positionInModel: String - (Optional, default "") name of the named selection in the model for positioning the action in 3D space; typically a memory point
since tkoh logo small.png1.00
radius: Number - (Optional, default 50) maximum 3D distance in meters between the activating unit's eyePos and the object's memoryPoint, selection or position. -1 disables the radius
since tkoh logo small.png1.00
radiusView: Number - (Optional, default unknown) maximum distance in meters the cursor can be away from the 3D action to activate it. -1 disables this radius
since tkoh logo small.png1.00
showIn3D: Number - (Optional, default unknown) condition for showing the action in 3D space. Can be combined e.g. 2 + 32
  • 1 - show
  • 2 - draw if unit is pilot
  • 4 - draw if unit is inside vehicle
  • 8 - draw if unit is outside vehicle
  • 16 - draw if not in external camera
  • 32 - draw if not in internal camera
  • 64 - draw if not in gunner camera (turret optics)
since tkoh logo small.png1.00
available: Number - (Optional, default unknown) condition for being able to activate the action. Can be combined e.g. 1 + 4
  • 0 - disabled
  • 1 - unit is pilot or copilot
  • 2 - unit is inside target
  • 4 - unit is not inside target
since tkoh logo small.png1.00
textDefault: String - (Optional, default "") structured Text which is shown as the 3D action (so it can be an icon), or in the center of the screen when the action is highlighted in the action menu for a 2D action
since tkoh logo small.png1.00
textToolTip: String - (Optional, default "") structured Text which is faded in under the textDefault when hovering over the action in 3D space
Return Value:
Number - the added action's ID. Action can be removed with removeAction (see also removeAllActions). IDs are incrementing, the first given action to each unit has the ID 0, the second the ID 1, etc. IDs are also passed to the called script (see the script parameter)

Examples

Example 1:
// short and sweet player addAction ["a useless action that does nothing", {}]; player addAction ["<t color='#FF0000'>This Useless Action Is RED</t>", { hint "RED" }]; player addAction ["Hint Hello!", { hint format ["Hello %1!", name player] }]; player addAction ["String Exec", "hint 'this is also compiled'"];
Example 2:
_actionID = player addAction ["Exec the file", "scriptFile.sqf"];
scriptFile.sqf:
Example 3:
Take On Helicopters:
_heli addAction [ "Test", "myTest.sqf", "", 1, true, true, "", "true", "display1", 2, 0.25, 9, 0, "<img image='\HSim\UI_H\data\ui_action_autohover_ca.paa' size='1.8' shadow=0 />", "<br />My test tooltip" ];

Additional Information

See also:
actionIDs actionParams setUserActionText inGameUISetEventHandler showHUD inputAction removeAction removeAllActions action

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
Hover & click on the images for description

Description

Description:
Adds an entry to the action menu of an object. The action can only be activated when in proximity to the object and looking at it. Adding an action to the player makes that action available to the player at all times. For event handling of user interaction see inGameUISetEventHandler.
Multiplayer:
The command will be ignored on dedicated servers, probably because no UI exists.
Groups:
Interaction

Syntax

Syntax:
object addAction [title, script, arguments, priority, showWindow, hideOnUse, shortcut, condition, radius, unconscious, selection, memoryPoint]
Parameters:
object: Object - unit, vehicle or static object. No agents and simple objects!
title: String - the action name displayed in the action menu, may contain Structured Text. Because of that < and > symbols will be interpreted as opening and closing XML tags. To avoid this use &lt; for < and &gt; for >. The title text appearance can be changed with setUserActionText
script: String or Code - either path to the script file, relative to the mission folder or string with code or the actual script code. If the string is a path to script file, the script file must have extension .SQS or .SQF. The script, whether it is a file or a code, will run in scheduled environment, i.e. it is ok to use sleep. Parameters array passed to the script upon activation in _this variable is:
params ["_target", "_caller", "_actionId", "_arguments"];
  • target: Object - the object which the action is assigned to
  • caller: Object - the unit that activated the action
  • actionID: Number - activated action's ID (same as addAction's return value)
  • arguments: Anything - arguments given to the script if you are using the extended syntax
arguments: Anything - (Optional, default nil) arguments to pass to the script. Accessible with _this select 3 inside the script. If Array is used as an argument for example, its first element reference would be _this select 3 select 0
priority: Number - (Optional, default 1.5) priority value of the action. Actions will be arranged in descending order according to this value. Every game action has a preset priority value. Value can be negative or decimal fraction. Actions with same values will be arranged in order which they were made, newest at the bottom. The bigger the number the higher the action will be positioned on the menu. Typical range is 0 to 6
showWindow: Boolean - (Optional, default true) if set to true, players see "Titletext" at mid-lower screen, as they approach the object. Only the title text for the action with highest priority and showWindow set to true will be shown
hideOnUse: Boolean - (Optional, default true) if set to true, it will hide the action menu after selecting it. If set to false, it will leave the action menu open and visible after selecting the action, leaving the same action highlighted, for the purpose of allowing you to re-select that same action quickly, or to select another action
shortcut: String - (Optional, default "") one of the key names defined in bin.pbo (e.g. "moveForward"). Adding available shortcut will bind corresponding keyboard key to this action. Shortcut availability can be tested with inputAction command
condition: String - (Optional, default "true") expression that must return true for the action to be shown. Special variables passed to the script code are:
  • _target: Object - The object to which action is attached or, if the object is a unit inside of vehicle, the vehicle
  • _this: Object - Caller person to whom the action is shown (or not shown if condition returns false)
  • _originalTarget: Object - The original object to which the action is attached, regardless if the object/unit is in a vehicle or not
  • _actionId: Number - checked action's ID (same as addAction's return value)
If the player is the group leader, has an action added to them, and selects a subordinate, _this alternatively switches between the player and this selected unit - RPT logging Unknown attribute itemsCmd in the process.
  • condition is evaluated on each frame in unscheduled environment.
  • condition is not evaluated if a dialog is open.
  • If action is added to an object and not to the player, condition will only get evaluated if the player is closer than ~50m to the object surface and is looking at the object.
  • If action is added to player, condition is evaluated all the time.
since Arma 3 logo black.png1.64
radius: Number - (Optional, default 50) maximum 3D distance in meters between the activating unit's eyePos and object's memoryPoint, selection or position. -1 disables the radius; hardcoded limit is 50
since Arma 3 logo black.png1.64
unconscious: Boolean - (Optional, default false) if true will be shown to incapacitated player. See also setUnconscious and lifeState
since Arma 3 logo black.png1.70
selection: String - (Optional, default "") object's geometry LOD's named selection
since Arma 3 logo black.png1.82
memoryPoint: String - (Optional, default "") object's memory point. If selection is supplied, memoryPoint is not used
Return Value:
Number - the added action's ID. Action can be removed with removeAction (see also removeAllActions). IDs are incrementing, the first given action to each unit has the ID 0, the second the ID 1, etc. IDs are also passed to the called script (see the script parameter)

Examples

Example 1:
// short and sweet player addAction ["a useless action that does nothing", {}]; player addAction ["<t color='#FF0000'>This Useless Action Is RED</t>", { hint "RED" }]; player addAction ["Hint Hello!", { hint format ["Hello %1!", name player] }]; player addAction ["String Exec", "hint 'this is also compiled'"];
Example 2:
_actionID = player addAction ["Exec the file", "scriptFile.sqf"];
scriptFile.sqf:
Example 3:
// create object on the server and add action to the object on every client if (isServer) then { private _object = "some_obj_class" createVehicle [1234, 1234, 0]; [_object, ["Greetings!", { hint "Hello!"; }]] remoteExec ["addAction"]; // Note: does not return action id };
Example 4:
Default parameters:
this addAction [ "title", { params ["_target", "_caller", "_actionId", "_arguments"]; }, nil, 1.5, true, true, "", "true", 50, false, "", "" ];
Example 5:
Default parameters with comments:
this addAction [ "title", // title { params ["_target", "_caller", "_actionId", "_arguments"]; // script }, nil, // arguments 1.5, // priority true, // showWindow true, // hideOnUse "", // shortcut "true", // condition 50, // radius false, // unconscious "", // selection "" // memoryPoint ];

Additional Information

See also:
actionIDs actionParams setUserActionText inGameUISetEventHandler showHUD inputAction removeActionremoveAllActionsactionBIS_fnc_holdActionAdd

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
Dedmen - c
Posted on May 02, 2018 - 13:44 (UTC)
If you want to replicate vanilla Actions like "Treat yourself" where the scroll menu only shows text and it displays the icon mid-screen you can use
private _actionId = player addAction ["Heal", {}]; player setUserActionText [_actionId, "Heal", "<img size='2' image='\a3\ui_f\data\IGUI\Cfg\Actions\heal_ca'/>"];
PierreMGI - c
Posted on May 12, 2020 - 10:42 (UTC)
addAction on unit or player stays on corpse after kill. So this action is lost for the new body after respawn. If you want a persistent addAction, you need to add it in the respawn script (onPlayerRespawn.sqf or addMissionEventHandler "entityRespawned" or addMPEventHandler "MPrespawn"... You can use removeAllActions on corpse.
Leopard20 - c
Posted on Aug 28, 2022 - 21:52 (UTC)
If the server blocks execVM in CfgRemoteExec, you can't use path to script:
_obj addAction ["Test", "path\script.sqf"]; // "path\script.sqf" won't execute
You can, however, do this:
_obj addAction ["Test", { _this spawn compile preprocessFileLineNumbers "path\script.sqf" }];
But it's recommended to use functions if the script is called frequently.