unassignItem: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[[Cc]ategory:[ _]?Arma[ _]3:[ _]([^|]*)[ _]?\|.*\]\]" to "{{GameCategory|arma3|$1}}")
m (Some wiki formatting)
 
(37 intermediate revisions by 3 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= Unassigns existing item and tries to put it into inventory. If there is no space in inventory the item simply disappears. See also [[unlinkItem]].
____________________________________________________________________________________________


| Unassigns existing item and tries to put it into inventory. If there is no space in inventory the item simply disappears. |DESCRIPTION=
|s1= unit [[unassignItem]] item
____________________________________________________________________________________________


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


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


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


| [[Nothing]] |RETURNVALUE=  
|x1= <sqf>
_bluforUnit unassignItem "NVGoggles";
_bluforUnit removeItem "NVGoggles";
_opforUnit unassignItem "NVGoggles_OPFOR";
_opforUnit removeItem "NVGoggles_OPFOR";
_independentUnit unassignItem "NVGoggles_INDEP";
_independentUnit removeItem "NVGoggles_INDEP";
</sqf>


|x2= <sqf>
{
_x unassignItem hmd _x; // unassign (not remove) NVGs from all units
} forEach allUnits;
</sqf>


|x1= <code>bluforUnit [[unassignItem]] "NVGoggles";
|seealso= [[assignItem]] [[addItem]] [[removeItem]] [[linkItem]] [[unlinkItem]] [[assignedItems]] [[removeAllAssignedItems]]
bluforUnit [[removeItem]] "NVGoggles";
opforUnit [[unassignItem]] "NVGoggles_OPFOR";
opforUnit [[removeItem]] "NVGoggles_OPFOR";
independentUnit [[unassignItem]] "NVGoggles_INDEP";
independentUnit [[removeItem]] "NVGoggles_INDEP";</code>|EXAMPLE1=
 
____________________________________________________________________________________________
 
| [[assignItem]], [[addItem]], [[removeItem]], [[linkItem]], [[unlinkItem]], [[assignedItems]], [[removeAllAssignedItems]] |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}}
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 13:31, 12 March 2024

Arma 3 logo black.png0.50
GAGlobalGEGlobal
Hover & click on the images for description

Description

Description:
Unassigns existing item and tries to put it into inventory. If there is no space in inventory the item simply disappears. See also unlinkItem.
Groups:
Unit Inventory

Syntax

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

Examples

Example 1:
_bluforUnit unassignItem "NVGoggles"; _bluforUnit removeItem "NVGoggles"; _opforUnit unassignItem "NVGoggles_OPFOR"; _opforUnit removeItem "NVGoggles_OPFOR"; _independentUnit unassignItem "NVGoggles_INDEP"; _independentUnit removeItem "NVGoggles_INDEP";
Example 2:
{ _x unassignItem hmd _x; // unassign (not remove) NVGs from all units } forEach allUnits;

Additional Information

See also:
assignItem addItem removeItem linkItem unlinkItem assignedItems removeAllAssignedItems

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=unassignItem&oldid=353052"