canAdd

Description

Checks if given object can be stored in inventory of given object or any inventory container (uniform, vest, backpack) of given unit.

Before Arma 3 v2.10 this comment verified only the biggest container when multiple items were queried; now it checks all containers.

Important

Avoid passing an empty string "" to this command as it will create a warning dialog:

This message will show once per mission restart.

Syntax

Syntax 1

object canAdd item

Parameters:

• object: Object - unit or container
• item: String - config class

Returns: Boolean

Syntax 2

since arma3 1.56

object canAdd [item, count, ignoreSoldierMaxLoad]

Parameters:

• object: Object - unit or container
• item: String - config class
• count: Number - desired quantity
• ignoreSoldierMaxLoad: Boolean - (Optional, default false) true to ignore 'soldierMaxLoad' param, container's maxLoad is still counted (since arma3 2.18)

Returns: Boolean

Syntax 3

since arma3 2.10

weapon canAdd item

Parameters:

• weapon: String - weapon class name
• item: String - config class of magazine or attachment

Returns: Boolean

Syntax 4

since arma3 2.10

weapon canAdd [attachment, slot]

Parameters:

• weapon: String - weapon class name
• attachment: String - attachment class name
• slot: String - slot class name (defined under WeaponSlotsInfo class in weapon config), for example:
  • "CowsSlot" for optics
  • "MuzzleSlot" for silencers
  • "PointerSlot" for laser pointers and flashlights
  • "UnderBarrelSlot" for bipods

Returns: Boolean

Syntax 5

since arma3 2.10

weapon canAdd [magazine, muzzle]

Parameters:

• weapon: String - weapon class name
• magazine: String - magazine class name
• muzzle: String - muzzle class name

Returns: Boolean

Examples

Example 1

<sqf

if (player canAdd "FirstAidKit") then { player addItem "FirstAidKit"; } else { hint "Not enough space"; }; </sqf>

Example 2

if (_box canAdd "FirstAidKit") then
{
    _box addWeaponCargo ["FirstAidKit", 1];
}
else
{
    hint "Not enough space";
};

Example 3

car canAdd [currentWeapon player, 50];

Example 4

// check if attachment can be loaded
"arifle_Katiba_GL_F" canAdd "acc_pointer_IR";
"arifle_Katiba_GL_F" canAdd ["acc_pointer_IR", "PointerSlot"];

Example 5

// check if magazine can be loaded
"arifle_Katiba_GL_F" canAdd "30Rnd_65x39_caseless_green";
"arifle_Katiba_GL_F" canAdd ["30Rnd_65x39_caseless_green", "this"];
"arifle_Katiba_GL_F" canAdd ["1Rnd_SmokeRed_Grenade_shell", "EGLM"];

See also

canAddItemToBackpack · canAddItemToUniform · canAddItemToVest · compatibleMagazines · compatibleItems · compatibleWeapons

// empty
_box canAdd "FirstAidKit"; // returns true

// full
_box canAdd "FirstAidKit"; // returns false

private _container = selectRandom [uniformContainer player, vestContainer player, backpackContainer player];
if (_container canAdd "Rangefinder") then
{
    _container addItemCargoGlobal ["Rangefinder", 1];
};