BIS fnc addVirtualItemCargo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
m (pf)
Line 1: Line 1:
 
{{Function|Comments=
{{Function|= Comments
____________________________________________________________________________________________
____________________________________________________________________________________________


| arma3 |= Game name
| arma3 |Game name=


|1.00|= Game version
|1.24|Game version=
____________________________________________________________________________________________
____________________________________________________________________________________________


| <pre>/*
|Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the [[Arsenal]].|Description=
 
____________________________________________________________________________________________
Description:
Add virtual items to an object (e.g., ammo box).
Virtual items can be selected in the Arsenal.


Parameter(s):
| [object,itemClasses,addItemsGlobal,arsenal] call [[BIS_fnc_addVirtualBackpackCargo]] |Syntax=
0: OBJECT - objct to which items will be added
1: STRING or ARRAY of STRINGs - item class(es) to be added
2 (Optional): BOOL - true to add items globally (default: false)
3 (Optional): BOOL - true to add Arsenal action (default: true)


Returns:
|p1=object: [[Object]] - Object to which items will be added|Parameter 1=
ARRAY of ARRAYs - all virtual items within the object's space in format [<items>,<weapons>,<magazines>,<backpacks>]
*/


</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
|p2=itemClasses: [[String]] or [[Array]] of [[String|strings]] - Item classes|Parameter 2=
____________________________________________________________________________________________


| <!-- [] call [[BIS_fnc_addVirtualItemCargo]]; --> |= Syntax
|p3=addItemsGlobal: [[Boolean]] - (Optional, default [[false]]) [[True]] to add items globally|Parameter 3=


|p1= |= Parameter 1
|p4=arsenal: [[Boolean]] - (Optional, default [[true]]) [[True]] to add [[Arsenal]] action|Parameter 4=


| |= Return value
| [[Array]] of [[Array|arrays]] - All virtual items in objects's space in format:
*0: [[Array]] - Items
*1: [[Array]] - Weapons
*2: [[Array]] - Magazines
*3: [[Array]] - Backpacks|Return value=
____________________________________________________________________________________________
____________________________________________________________________________________________


|x1= <code> [ _myBox, [ "U_B_CombatUniform_mcam","U_B_CombatUniform_mcam_tshirt","Rangefinder","MineDetector" ], [[true]]] [[call]] [[BIS_fnc_addVirtualItemCargo]]; </code> |= EXAMPLE1
|x1= <code>[ BIS_ammoBox, ["class_1","class_2"], [[false]], [[true]] ] [[call]] [[BIS_fnc_addVirtualBackpackCargo]];</code>|Example 1=
 
____________________________________________________________________________________________
____________________________________________________________________________________________


| [[BIS_fnc_addVirtualBackpackCargo]] [[BIS_fnc_addVirtualMagazineCargo]] [[BIS_fnc_addVirtualWeaponCargo]] |= See also
| [[Arsenal]],[[BIS_fnc_addVirtualBackpackCargo]], [[BIS_fnc_addVirtualMagazineCargo]],[[BIS_fnc_addVirtualWeaponCargo]],[[BIS_fnc_arsenal]],[[BIS_fnc_getVirtualBackpackCargo]],[[BIS_fnc_getVirtualItemCargo]],[[BIS_fnc_getVirtualMagazineCargo]],[[BIS_fnc_getVirtualWeaponCargo]], [[BIS_fnc_removeVirtualBackpackCargo]],[[BIS_fnc_removeVirtualItemCargo]], [[BIS_fnc_removeVirtualMagazineCargo]],[[BIS_fnc_removeVirtualWeaponCargo]] |See also=
 
}}
}}



Revision as of 09:19, 23 June 2018

Hover & click on the images for description

Description

Description:
Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the Arsenal.
Execution:
call
Groups:
Uncategorised

Syntax

Syntax:
[object,itemClasses,addItemsGlobal,arsenal] call BIS_fnc_addVirtualBackpackCargo
Parameters:
object: Object - Object to which items will be added
itemClasses: String or Array of strings - Item classes
addItemsGlobal: Boolean - (Optional, default false) True to add items globally
arsenal: Boolean - (Optional, default true) True to add Arsenal action
Return Value:
Array of arrays - All virtual items in objects's space in format:

Examples

Example 1:
[ BIS_ammoBox, ["class_1","class_2"], false, true ] call BIS_fnc_addVirtualBackpackCargo;

Additional Information

See also:
ArsenalBIS_fnc_addVirtualBackpackCargoBIS_fnc_addVirtualMagazineCargoBIS_fnc_addVirtualWeaponCargoBIS_fnc_arsenalBIS_fnc_getVirtualBackpackCargoBIS_fnc_getVirtualItemCargoBIS_fnc_getVirtualMagazineCargoBIS_fnc_getVirtualWeaponCargoBIS_fnc_removeVirtualBackpackCargoBIS_fnc_removeVirtualItemCargoBIS_fnc_removeVirtualMagazineCargoBIS_fnc_removeVirtualWeaponCargo

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

Bottom Section

Posted on October 16, 2014 - 23:55 (UTC)
Kamaradski
In AmmoboxInit mode, for the ammobox to ONLY contain your white-listed items in the ammobox, you should first issue the BIS_fnc_removeVirtualItemCargo command. Otherwise the box will contain non whitelisted clutter.

Example: ["AmmoboxInit",[_myBox,true]] call BIS_fnc_arsenal; [_myBox,[true],true] call BIS_fnc_removeVirtualItemCargo; [_myBox,["U_B_CombatUniform_mcam","U_B_CombatUniform_mcam_tshirt"],true] call BIS_fnc_addVirtualItemCargo;