Options
All
  • Public
  • Public/Protected
  • All
Menu

Interface DestinyItemInstanceComponent

If an item is "instanced", this will contain information about the item's instance that doesn't fit easily into other components. One might say this is the "essential" instance data for the item.

Items are instanced if they require information or state that can vary. For instance, weapons are Instanced: they are given a unique identifier, uniquely generated stats, and can have their properties altered. Non-instanced items have none of these things: for instance, Glimmer has no unique properties aside from how much of it you own.

You can tell from an item's definition whether it will be instanced or not by looking at the DestinyInventoryItemDefinition's definition.inventory. isInstanceItem property.

Hierarchy

  • DestinyItemInstanceComponent

Index

Properties

canEquip

canEquip: boolean

If this is an equippable item, you can check it here. There are permanent as well as transitory reasons why an item might not be able to be equipped: check cannotEquipReason for details.

cannotEquipReason

cannotEquipReason: EquipFailureReason

If you cannot equip the item, this is a flags enum that enumerates all of the reasons why you couldn't equip the item. You may need to refine your UI further by using unlockHashesRequiredToEquip and equipRequiredLevel.

This enum represents a set of flags - use bitwise operators to check which of these match your value.

damageType

damageType: DamageType

If the item has a damage type, this is the item's current damage type.

Optional damageTypeHash

damageTypeHash: number

The current damage type's hash, so you can look up localized info and icons for it.

Mapped to DestinyDamageTypeDefinition in the manifest.

equipRequiredLevel

equipRequiredLevel: number

If the item cannot be equipped until you reach a certain level, that level will be reflected here.

isEquipped

isEquipped: boolean

Is the item currently equipped on the given character?

itemLevel

itemLevel: number

The Item's "Level" has the most significant bearing on its stats, such as Light and Power.

primaryStat

primaryStat: DestinyStat

The item stat that we consider to be "primary" for the item. For instance, this would be "Attack" for Weapons or "Defense" for armor.

quality

quality: number

The "Quality" of the item has a lesser - but still impactful - bearing on stats like Light and Power.

unlockHashesRequiredToEquip

unlockHashesRequiredToEquip: number[]

Sometimes, there are limitations to equipping that are represented by character- level flags called "unlocks".

This is a list of flags that they need in order to equip the item that the character has not met. Use these to look up the descriptions to show in your UI by looking up the relevant DestinyUnlockDefinitions for the hashes.

Mapped to DestinyUnlockDefinition in the manifest.