BIS fnc addVirtualItemCargo: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\|seealso= ([^ ]+)(\]\]|\}\}), *(\[\[|\{\{)" to "|seealso= $1$2 $3") |
Lou Montana (talk | contribs) m (Some wiki formatting) |
||
(7 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
|game1= arma3 | |game1= arma3 | ||
|version1= 1.24 | |version1= 1.24 | ||
|gr1= Inventory | |gr1= Inventory | ||
|descr= Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the [[Arsenal]]. If parameters 4 and 5 are used this function can replace [[BIS_fnc_addVirtualWeaponCargo]], [[BIS_fnc_addVirtualMagazineCargo]] and [[BIS_fnc_addVirtualBackpackCargo]]. | |descr= Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the [[Arsenal]]. | ||
If parameters 4 and 5 are used this function can replace [[BIS_fnc_addVirtualWeaponCargo]], [[BIS_fnc_addVirtualMagazineCargo]] and [[BIS_fnc_addVirtualBackpackCargo]]. | |||
|s1= [object, itemClasses, addItemsGlobal, arsenal, mode, itemType] call [[BIS_fnc_addVirtualItemCargo]] | |s1= [object, itemClasses, addItemsGlobal, arsenal, mode, itemType] call [[BIS_fnc_addVirtualItemCargo]] | ||
|p1= object: [[Object]] - | |p1= object: [[Object]] - object to which items will be added | ||
|p2= itemClasses: [[Boolean]], [[String]] or [[Array]] of [[String | |p2= itemClasses: [[Boolean]], [[String]] or [[Array]] of [[String]]s - item classes | ||
|p3= addItemsGlobal: [[Boolean]] - (Optional, default [[false]]) [[true]] to add items globally | |p3= addItemsGlobal: [[Boolean]] - (Optional, default [[false]]) [[true]] to add items globally | ||
Line 19: | Line 19: | ||
|p4= arsenal: [[Boolean]] - (Optional, default [[true]]) [[true]] to add [[Arsenal]] action | |p4= arsenal: [[Boolean]] - (Optional, default [[true]]) [[true]] to add [[Arsenal]] action | ||
|p5= mode: [[Number]] - (Optional, default 1) | |p5= mode: [[Number]] - (Optional, default 1) defines what the function will do, can be: | ||
* -1 - remove given items | * -1 - remove given items | ||
* 0 - return current content | * 0 - return current content | ||
* 1 - add given items | * 1 - add given items | ||
|p6= itemType: [[Number]] - (Optional, default 0) | |p6= itemType: [[Number]] - (Optional, default 0) define the item type, can be: | ||
* 0 - items | * 0 - items | ||
* 1 - weapons | * 1 - weapons | ||
Line 30: | Line 30: | ||
* 3 - backpacks | * 3 - backpacks | ||
|r1= [[Array]] of [[String | |r1= [[Array]] of [[String]]s - all virtual items | ||
|x1= < | |x1= <sqf>[BIS_ammoBox, ["class_1", "class_2"], false, true] call BIS_fnc_addVirtualItemCargo;</sqf> | ||
|seealso= [[Arsenal]] [[BIS_fnc_addVirtualBackpackCargo]] [[BIS_fnc_addVirtualMagazineCargo]] [[BIS_fnc_addVirtualWeaponCargo]] [[BIS_fnc_arsenal]] [[BIS_fnc_getVirtualBackpackCargo]] | |seealso= [[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]] | ||
}} | }} | ||
{{Note | |||
|user= Kamaradski | |||
|timestamp= 20141016235500 | |||
|text= 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. | |||
<br><br> | |||
'''Example:''' | |||
<sqf> | |||
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. | ["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; | ||
< | </sqf> | ||
[_myBox,[true],true] call BIS_fnc_removeVirtualItemCargo; | }} | ||
[_myBox,["U_B_CombatUniform_mcam","U_B_CombatUniform_mcam_tshirt"],true] call BIS_fnc_addVirtualItemCargo; | |||
</ | |||
Latest revision as of 23:41, 10 July 2022
Description
- Description:
- Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the Arsenal. If parameters 4 and 5 are used this function can replace BIS_fnc_addVirtualWeaponCargo, BIS_fnc_addVirtualMagazineCargo and BIS_fnc_addVirtualBackpackCargo.
- Execution:
- call
- Groups:
- Inventory
Syntax
- Syntax:
- [object, itemClasses, addItemsGlobal, arsenal, mode, itemType] call BIS_fnc_addVirtualItemCargo
- Parameters:
- object: Object - object to which items will be added
- itemClasses: Boolean, 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
- mode: Number - (Optional, default 1) defines what the function will do, can be:
- -1 - remove given items
- 0 - return current content
- 1 - add given items
- itemType: Number - (Optional, default 0) define the item type, can be:
- 0 - items
- 1 - weapons
- 2 - magazines
- 3 - backpacks
- Return Value:
- Array of Strings - all virtual items
Examples
- Example 1:
Additional Information
- 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
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 Oct 16, 2014 - 23:55 (UTC)
-
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;