uniqueUnitItems: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Fix return value)
m (Fix description)
Line 12: Line 12:
|descr= Returns hashmap of all items in units inventory as [classname, count] pairs.
|descr= Returns hashmap of all items in units inventory as [classname, count] pairs.
{{Feature|informative|
{{Feature|informative|
* ''weaponItems'', ''uniform'', ''vest'', ''backpack'' arguments use the following [[Number]] values:
* ''weaponItems'', ''uniformItems'', ''vestItems'', ''backpackItems'' arguments use the following [[Number]] values:
** 0: do not return value
** 0: do not return value
** 1: returns container only (weapon or container)
** 1: returns container only (weapon or container)

Revision as of 19:17, 21 July 2021

Hover & click on the images for description
Only available in Development branch(es) until its release with Arma 3 patch v2.06.

Description

Description:
Returns hashmap of all items in units inventory as [classname, count] pairs.
  • weaponItems, uniformItems, vestItems, backpackItems arguments use the following Number values:
    • 0: do not return value
    • 1: returns container only (weapon or container)
    • 2: returns container and its content
  • weapons/containers that are stored inside containers (e.g weapon in backpack) always return all contents if contents for the parent container are enabled.
Groups:
Unit Inventory

Syntax

Syntax:
uniqueUnitItems [unit, weaponsItems, uniformItems, vestItems, backpackItems, assignedItems]
Parameters:
unit: Object
weaponsItems: Number - (Optional, default 2) weapons (including binoculars) and their accessories (flashlight etc), loaded magazines
uniformItems: Number - (Optional, default 2)
vestItems: Number - (Optional, default 2)
backpackItems: Number - (Optional, default 2)
assignedItems: Boolean - (Optional, default true) returns assignedItems as well as headgear and goggles
Return Value:
HashMap in format itemClassname (String) → amount (Number)

Examples

Example 1:
private _unitUniqueItems = uniqueUnitItems [player, 0, 2, 2, 2, true]; if (_unitUniqueItems getOrDefault ["FirstAidKit", 0] > 5) then { hint "I'm rich of FAK to give!"; };
Example 2:
private _unitUniqueItems = uniqueUnitItems [cursorObject];

Additional Information

See also:
getUnitLoadout

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