addItem: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]3(\|.*)]]" to "{{GameCategory|arma3|Scripting Commands}}")
m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>")
 
(33 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 0.50


|0.50|Game version=
|arg= global
|eff= global


|arg= global |MParg=
|gr1= Unit Inventory
|eff= global |MPeff=


|gr1= Unit Inventory |GROUP1=
|descr= Creates new item and tries to add it into inventory. Inventory must have enough space to accomodate new item or command will fail.The item can also be a weapon or a magazine.
____________________________________________________________________________________________


| Creates new item and tries to add it into inventory. Inventory must have enough space to accomodate new item or command will fail.The item can also be a weapon or a magazine. |DESCRIPTION=
|s1= unit [[addItem]] item
____________________________________________________________________________________________


| unit '''addItem''' item |SYNTAX=
|p1= unit: [[Object]]


|p1= unit: [[Object]] |PARAMETER1=
|p2= item: [[String]]


|p2= item: [[String]] |PARAMETER2=
|r1= [[Nothing]]


| [[Nothing]] |RETURNVALUE=  
|x1= <sqf>
// identical to bluforUnit linkItem "NVGoggles"
// addItem then assignItem makes the item go through through inventory storage and fail if storage space was missing
bluforUnit addItem "NVGoggles";
bluforUnit assignItem "NVGoggles";


opforUnit addItem "NVGoggles_OPFOR";
opforUnit assignItem "NVGoggles_OPFOR";


|x1= <code>bluforUnit [[addItem]] "NVGoggles";
independentUnit addItem "NVGoggles_INDEP";
bluforUnit [[assignItem]] "NVGoggles";
independentUnit assignItem "NVGoggles_INDEP";
opforUnit [[addItem]] "NVGoggles_OPFOR";
</sqf>
opforUnit [[assignItem]] "NVGoggles_OPFOR";
independentUnit [[addItem]] "NVGoggles_INDEP";
independentUnit [[assignItem]] "NVGoggles_INDEP";</code>|EXAMPLE1=


____________________________________________________________________________________________
|seealso= [[removeItem]] [[assignItem]] [[unassignItem]] [[assignedItems]] [[linkItem]] [[unlinkItem]] [[removeAllAssignedItems]] [[addItemToUniform]] [[addItemToVest]] [[addItemToBackpack]]
 
| [[removeItem]], [[assignItem]], [[unassignItem]], [[assignedItems]], [[linkItem]], [[unlinkItem]], [[removeAllAssignedItems]] [[addItemToUniform]], [[addItemToVest]], [[addItemToBackpack]] |SEEALSO=
 
|  |MPBEHAVIOUR=
____________________________________________________________________________________________
}}
}}
<h3 style='display:none'>Notes</h3>
<dl class='command_description'>
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
{{GameCategory|arma3|New_Scripting_Commands_List}}
{{GameCategory|arma3|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 19:42, 3 September 2024

Hover & click on the images for description

Description

Description:
Creates new item and tries to add it into inventory. Inventory must have enough space to accomodate new item or command will fail.The item can also be a weapon or a magazine.
Groups:
Unit Inventory

Syntax

Syntax:
unit addItem item
Parameters:
unit: Object
item: String
Return Value:
Nothing

Examples

Example 1:
// identical to bluforUnit linkItem "NVGoggles" // addItem then assignItem makes the item go through through inventory storage and fail if storage space was missing bluforUnit addItem "NVGoggles"; bluforUnit assignItem "NVGoggles"; opforUnit addItem "NVGoggles_OPFOR"; opforUnit assignItem "NVGoggles_OPFOR"; independentUnit addItem "NVGoggles_INDEP"; independentUnit assignItem "NVGoggles_INDEP";

Additional Information

See also:
removeItem assignItem unassignItem assignedItems linkItem unlinkItem removeAllAssignedItems addItemToUniform addItemToVest addItemToBackpack

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