addBackpackGlobal: 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 - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
(69 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|arg= global|arguments=
|version1= 1.32
|eff= global|effect=
|1.32|Game version=


|gr1= Unit Inventory |GROUP1=
|arg= global
____________________________________________________________________________________________


| Adds a backpack to a unit (even non-local).<br><br>
|eff= global
{{Warning | Beware, the backpack added with this command will be created on the PC [[local]] to the unit you are adding it to, even if executed on the server. Because of this, if non-local unit is the target and one tries to immediately access added backpack, the backpack returned will be [[objNull | Null]]. When adding backpack dynamically to a remote unit, wait until backpack is added (See Example 2)}}  |DESCRIPTION=
____________________________________________________________________________________________


| unit '''addBackpackGlobal''' backpack|SYNTAX=
|gr1= Unit Inventory


|p1= unit: [[Object]] - soldier |PARAMETER1=
|descr= Adds a backpack to a unit (even non-local).{{Feature | Warning | Beware, the backpack added with this command will be created on the PC [[Multiplayer Scripting#Locality|local]] to the unit you are adding it to, even if executed on the server. Because of this, if non-local unit is the target and one tries to immediately access added backpack, the backpack returned will be [[objNull | Null]]. When adding backpack dynamically to a remote unit, wait until backpack is added (See Example 2)}}
|p2= backpack: [[String]] - backpack class name |PARAMETER2=


| [[Nothing]] |RETURNVALUE=
|s1= unit [[addBackpackGlobal]] backpack
____________________________________________________________________________________________
 
|x1= <code>[[player]] [[addBackpackGlobal]] "B_AssaultPack_khk";</code> |EXAMPLE1=


|x2= <code>_unit [[spawn]]
|p1= unit: [[Object]] - soldier
 
|p2= backpack: [[String]] - backpack class name
 
|r1= [[Nothing]]
 
|x1= <sqf>player addBackpackGlobal "B_AssaultPack_khk";</sqf>
 
|x2= <sqf>_unit spawn  
{
{
[[if]] (![[isNull]] [[backpackContainer]] [[_this]]) [[then]]
if (!isNull backpackContainer _this) then
{
{
[[removeBackpackGlobal]] [[_this]];
removeBackpackGlobal _this;
[[waitUntil]] { [[isNull]] [[backpackContainer]] [[_this]] };
waitUntil { isNull backpackContainer _this };
};
};
[[_this]] [[addBackpackGlobal]] "B_AssaultPack_khk";
_this addBackpackGlobal "B_AssaultPack_khk";
[[waitUntil]] { ![[isNull]] [[backpackContainer]] [[_this]] };
waitUntil { !isNull backpackContainer _this };
[[backpackContainer]] [[_this]] [[addMagazineCargoGlobal]] ["30Rnd_556x45_Stanag",5];
backpackContainer _this addMagazineCargoGlobal ["30Rnd_556x45_Stanag",5];
};</code> |EXAMPLE2=
};</sqf>
 
____________________________________________________________________________________________
 
| [[addBackpack]], [[backpackContainer]], [[firstBackpack]], [[unitBackpack]], [[backpack]], [[backpackCargo]], [[getBackpackCargo]], [[backpackItems]], [[addBackpackCargo]], [[addBackpackCargoGlobal]], [[removeBackpack]], [[clearBackpackCargo]], [[clearBackpackCargoGlobal]], [[clearAllItemsFromBackpack]], [[loadBackpack]], [[backpackSpaceFor]], [[canAddItemToBackpack]], [[addItemToBackpack]], [[removeItemFromBackpack]], [[everyBackpack]]|SEEALSO=


|seealso= [[addBackpack]] [[backpackContainer]] [[firstBackpack]] [[unitBackpack]] [[backpack]] [[backpackCargo]] [[getBackpackCargo]] [[backpackItems]] [[addBackpackCargo]] [[addBackpackCargoGlobal]] [[removeBackpack]] [[clearBackpackCargo]] [[clearBackpackCargoGlobal]] [[clearAllItemsFromBackpack]] [[loadBackpack]] [[backpackSpaceFor]] [[canAddItemToBackpack]] [[addItemToBackpack]] [[removeItemFromBackpack]] [[everyBackpack]]
}}
}}
<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|Scripting Commands}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Revision as of 11:21, 13 May 2022

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

Description

Description:
Adds a backpack to a unit (even non-local).
⚠
Beware, the backpack added with this command will be created on the PC local to the unit you are adding it to, even if executed on the server. Because of this, if non-local unit is the target and one tries to immediately access added backpack, the backpack returned will be Null. When adding backpack dynamically to a remote unit, wait until backpack is added (See Example 2)
Groups:
Unit Inventory

Syntax

Syntax:
unit addBackpackGlobal backpack
Parameters:
unit: Object - soldier
backpack: String - backpack class name
Return Value:
Nothing

Examples

Example 1:
player addBackpackGlobal "B_AssaultPack_khk";
Example 2:
_unit spawn { if (!isNull backpackContainer _this) then { removeBackpackGlobal _this; waitUntil { isNull backpackContainer _this }; }; _this addBackpackGlobal "B_AssaultPack_khk"; waitUntil { !isNull backpackContainer _this }; backpackContainer _this addMagazineCargoGlobal ["30Rnd_556x45_Stanag",5]; };

Additional Information

See also:
addBackpack backpackContainer firstBackpack unitBackpack backpack backpackCargo getBackpackCargo backpackItems addBackpackCargo addBackpackCargoGlobal removeBackpack clearBackpackCargo clearBackpackCargoGlobal clearAllItemsFromBackpack loadBackpack backpackSpaceFor canAddItemToBackpack addItemToBackpack removeItemFromBackpack everyBackpack

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=addBackpackGlobal&oldid=318718"