BIS fnc arsenal: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " <!-- (DIS)?CONTINUE Notes -->" to "")
m (Some wiki formatting)
Line 1: Line 1:
{{RV|type=function
{{RV|type=function


| arma3
|game1= arma3
|version1= 1.24


|1.24
|gr1= Inventory


|gr1 = Inventory
|descr= Function used for the [[Arma 3: Arsenal|Virtual Arsenal]]. The function features four different modes, each mode comes with its own parameters.
{{Feature | Informative | If Arsenal is launched within the first second from the mission start, the unit loadout will be randomised.}}


| Function used for Virtual [[Arsenal]]. The function features four different modes, each mode comes with its own parameters.<br><br>
|s1= [mode, params] call [[BIS_fnc_arsenal]]
{{Feature | Informative | If Arsenal is launched within the 1st second from the mission start the unit loadout will be randomized}}


| [mode,params] call '''BIS_fnc_arsenal'''
|p1= mode: [[String]] - mode, can be "Open", "Preload", "AmmoboxInit" and "AmmoboxExit"
|p2= params: [[Anything]] - parameters used by mode (See below for details)
* '''"Open"''' - Opens the [[Arsenal]]
** 0: [[Boolean]] - [[true|True]] to open full [[Arsenal]] with all items available (default: [[false]])
* '''"Preload"''' - Preloads item configs, without preloading the configs are parsed the first time it is opened
** No parameters
* '''"AmmoboxInit"''' - Adds a virtual ammobox. Action to access the [[Arsenal]] will be added automatically to all clients
** 0: [[Object]] - Object which should get a virtual ammobox
** 1: [[Boolean]] - (Optional, default [[false]]) [[true]] to make all items available
** 2: [[Code]] - (Optional, default [[false]]) condition for the [[Arsenal]] to be accessible
*** passed arguments are the same as in [[addAction]] condition, i.e. _target - the object, _this - the caller
* '''"AmmoboxExit"''' - remove virtual ammobox
** 0: [[Object]] - the object the [[Arma 3: Arsenal|Arsenal]] was added to


|p1= mode: [[String]] - Mode, can be "Open", "Preload", "AmmoboxInit" and "AmmoboxExit"
|r1= [[Nothing]]
|p2= params: [[Anything]] - Parameters used by mode (See below for details)
*'''"Open"''' - Opens the [[Arsenal]]
**0: [[Boolean]] - [[true|True]] to open full [[Arsenal]] with all items available (default: [[false]])
*'''"Preload"''' - Preloads item configs, without preloading the configs are parsed the first time it is opened
**No parameters
*'''"AmmoboxInit"''' - Adds a virtual ammobox. Action to access the [[Arsenal]] will be added automatically to all clients
**0: [[Object]] - Object which should get a virtual ammobox
**1: [[Boolean]] -  [[true|True]] to make all items available (optional, default: [[false]])
**2: [[Code]] - Condition for the [[Arsenal]] to be accessable (optional,default: {[[false]]})
***Passed arguments are the same as in [[addAction]] condition, i.e. _target - the object, _this - the caller
*'''"AmmoboxExit"''' - Remove virtual ammobox
**0: [[Object]] - The object the [[Arsenal]] was added to


| [[Nothing]]
|x1= <code>{{cc|Opens [[Arma 3: Arsenal|Arsenal]] with all items}}
["Open", [<nowiki/>[[true]]]] [[call]] [[BIS_fnc_arsenal]];</code>


|x1= <code>[ "Open", [<nowiki/>[[true]] ] ] [[call]] '''BIS_fnc_arsenal''';</code>{{codecomment|Opens [[Arsenal]] with all items}}
|x2= <code>{{cc|Preloads [[Arma 3: Arsenal|Arsenal]]'s config}}
|x2= <code>[ "Preload" ] [[call]] '''BIS_fnc_arsenal''';</code>{{codecomment|Preloads config for [[Arsenal]]}}
["Preload"] [[call]] [[BIS_fnc_arsenal]];</code>
|x3= <code>[ "AmmoboxInit", [ ammoBox, [[true]], {(_this [[distance]] _target) < 10} ] ] [[call]] '''BIS_fnc_arsenal''';</code>{{codecomment|Adds full [[Arsenal]] to [[player]] object and makes the [[addAction|action]] available when the player is as closer than 10 meters from ammoBox}}
|x4= <code>[ "AmmoboxExit", [[player]] ] [[call]] '''BIS_fnc_arsenal''';</code>{{codecomment|Removes [[Arsenal]] from [[player]] object}}


|seealso= [[Arsenal]], [[BIS_fnc_garage]]
|x3= <code>{{cc|Adds full [[Arsenal]] to the [[player]] object and makes the [[addAction|action]] available when the player is closer than 10 meters from ammoBox}}
}}
["AmmoboxInit", [ammoBox, [[true]], { _this [[distance]] _target  < 10 }]] [[call]] [[BIS_fnc_arsenal]];</code>


|x4= <code>{{cc|Removes [[Arsenal]] from [[player]] object}}
["AmmoboxExit", [[player]]] [[call]] [[BIS_fnc_arsenal]];</code>


 
|seealso= [[Arma 3: Arsenal]], [[BIS_fnc_garage]]
 
}}
 
<dl class="command_description">
<dt></dt>
<dd class="notedate">Posted on October 6, 2014 - 04:59 (UTC)</dd>
<dt class="note">[[User:Benargee|Benargee]]</dt>
<dd class="note">
 
To remove arsenal from an ammo box, you can use:
<code>[[removeAllActions]] ammobox</code>
 
</dd>
</dl>

Revision as of 20:40, 10 April 2021

Arma 3 logo black.png1.24
Hover & click on the images for description

Description

Description:
Function used for the Virtual Arsenal. The function features four different modes, each mode comes with its own parameters.
ⓘ
If Arsenal is launched within the first second from the mission start, the unit loadout will be randomised.
Execution:
call
Groups:
Inventory

Syntax

Syntax:
[mode, params] call BIS_fnc_arsenal
Parameters:
mode: String - mode, can be "Open", "Preload", "AmmoboxInit" and "AmmoboxExit"
params: Anything - parameters used by mode (See below for details)
  • "Open" - Opens the Arsenal
  • "Preload" - Preloads item configs, without preloading the configs are parsed the first time it is opened
    • No parameters
  • "AmmoboxInit" - Adds a virtual ammobox. Action to access the Arsenal will be added automatically to all clients
    • 0: Object - Object which should get a virtual ammobox
    • 1: Boolean - (Optional, default false) true to make all items available
    • 2: Code - (Optional, default false) condition for the Arsenal to be accessible
      • passed arguments are the same as in addAction condition, i.e. _target - the object, _this - the caller
  • "AmmoboxExit" - remove virtual ammobox
Return Value:
Nothing

Examples

Example 1:
// Opens Arsenal with all items ["Open", [true]] call BIS_fnc_arsenal;
Example 2:
// Preloads Arsenal's config ["Preload"] call BIS_fnc_arsenal;
Example 3:
// Adds full Arsenal to the player object and makes the action available when the player is closer than 10 meters from ammoBox ["AmmoboxInit", [ammoBox, true, { _this distance _target < 10 }]] call BIS_fnc_arsenal;
Example 4:
// Removes Arsenal from player object ["AmmoboxExit", player] call BIS_fnc_arsenal;

Additional Information

See also:
Arma 3: ArsenalBIS_fnc_garage

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
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_arsenal&oldid=254301"