addAction: Difference between revisions
Jump to navigation
Jump to search
Operation Flashpoint to
Take On Helicopters
Arma 3
Lou Montana (talk | contribs) m (Text replacement - "\|x([0-9])= <sqf>([^\/: ]+)([^;])<\/sqf>" to "|x$1= <sqf>$2$3;</sqf>") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
Line 41: | Line 41: | ||
|p3= '''script''': [[String]] - path to the script file, relative to the mission folder. 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: | |p3= '''script''': [[String]] - path to the script file, relative to the mission folder. 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: | ||
< | <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 | ||
Line 47: | Line 47: | ||
* '''arguments''': [[Anything]] - arguments given to the script if you are using the extended syntax | * '''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 | |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 | |p4since= arma1 1.00 | ||
Line 79: | Line 79: | ||
|p11since= tkoh 1.00 | |p11since= tkoh 1.00 | ||
|p12= '''showIn3D''': [[Number]] - (Optional, default '''unknown''') Condition for showing the action in 3D space. Can be combined e.g. | |p12= '''showIn3D''': [[Number]] - (Optional, default '''unknown''') Condition for showing the action in 3D space. Can be combined e.g. <sqf inline>2 + 32</sqf> | ||
* 1 - show | * 1 - show | ||
* 2 - draw if unit is pilot | * 2 - draw if unit is pilot | ||
Line 89: | Line 89: | ||
|p12since= tkoh 1.00 | |p12since= tkoh 1.00 | ||
|p13= '''available''': [[Number]] - (Optional, default '''unknown''') Condition for being able to activate the action. Can be combined e.g. | |p13= '''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 | ||
Line 166: | Line 166: | ||
|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: | ||
< | <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 | ||
Line 172: | Line 172: | ||
* '''arguments''': [[Anything]] - arguments given to the script if you are using the extended syntax | * '''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 | |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 | |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 |
Revision as of 15:50, 1 July 2022
![Logo A0.png](/wikidata/images/thumb/0/04/Logo_A0.png/24px-Logo_A0.png)
![tkoh logo small.png](/wikidata/images/thumb/d/db/tkoh_logo_small.png/24px-tkoh_logo_small.png)
![Arma 3 logo black.png](/wikidata/images/thumb/8/80/Arma_3_logo_black.png/24px-Arma_3_logo_black.png)
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:
- 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 < for < and > for >. The title text appearance can be changed with setUserActionText
- script: String - path to the script file, relative to the mission folder. 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:
- since
1.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
1.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
1.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
1.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
1.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
1.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
- since
1.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
1.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
1.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
1.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
1.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
1.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 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:
- scriptFile.sqf:
- Example 3:
- Take On Helicopters:
Additional Information
- See also:
- actionIDs actionParams setUserActionText inGameUISetEventHandler showHUD inputAction removeActionremoveAllActionsaction
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
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 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 < for < and > 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:
- 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
- since
1.64
- 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
1.64
- unconscious: Boolean - (Optional, default false) If true will be shown to incapacitated player. See also setUnconscious and lifeState
- since
1.70
- selection: String - (Optional, default "") object's geometry LOD's named selection
- since
1.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 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:
- 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:
- Example 5:
- Default parameters with comments:
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
- 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 _action = player addAction ["Heal", {}]; player setUserActionText [_action , "Heal", "<img size='2' image='\a3\ui_f\data\IGUI\Cfg\Actions\heal_ca'/>"];
- 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.
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.10
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Command Group: Interaction
- Scripting Commands: Local Effect
- Introduced with Arma 3 version 0.50
- Arma 3: New Scripting Commands
- Arma 3: Scripting Commands