IForgeItemStack (forge 1.13.2-25.0.220 API)

All Superinterfaces:

ICapabilityProvider, ICapabilitySerializable<NBTTagCompound>, INBTSerializable<NBTTagCompound>

All Known Implementing Classes:

ItemStack
```
public interface IForgeItemStack
extends ICapabilitySerializable<NBTTagCompound>
```

Method Summary

All Methods Instance Methods Default Methods
Modifier and Type	Method and Description
`default boolean`	`areShareTagsEqual(ItemStack other)` Modeled after ItemStack.areItemStackTagsEqual Uses Item.getNBTShareTag for comparison instead of NBT and capabilities.
`default boolean`	`canApplyAtEnchantingTable(Enchantment enchantment)` Checks whether an item can be enchanted with a certain enchantment.
`default boolean`	`canDisableShield(ItemStack shield, EntityLivingBase entity, EntityLivingBase attacker)` Can this Item disable a shield
`default boolean`	`canEquip(EntityEquipmentSlot armorType, Entity entity)` Determines if the specific ItemStack can be placed in the specified armor slot, for the entity.
`default boolean`	`doesSneakBypassUse(IWorldReader world, BlockPos pos, EntityPlayer player)` Should this item, when held, allow sneak-clicks to pass through to the underlying block?
`default boolean`	`equals(ItemStack other, boolean limitTags)` Determines if the ItemStack is equal to the other item stack, including Item, Count, and NBT.
`default int`	`getBurnTime()`
`default ItemStack`	`getContainerItem()` ItemStack sensitive version of getContainerItem.
`default int`	`getEntityLifespan(World world)` Retrieves the normal 'lifespan' of this item when it is dropped on the ground as a EntityItem.
`default EntityEquipmentSlot`	`getEquipmentSlot()` Override this to set a non-default armor slot for an ItemStack, but do not use this to get the armor slot of said stack; for that, use `EntityLiving.getSlotForItemStack(ItemStack)`.
`default int`	`getHarvestLevel(ToolType tool, EntityPlayer player, IBlockState state)` Queries the harvest level of this item stack for the specified tool class, Returns -1 if this tool is not of the specified type
`default HorseArmorType`	`getHorseArmorType()` Returns an enum constant of type `HorseArmorType`.
`default int`	`getItemEnchantability()` ItemStack sensitive version of getItemEnchantability
`default NBTTagCompound`	`getShareTag()` Get the NBT data to be sent to the client.
`default ItemStack`	`getStack()`
`default java.util.Set<ToolType>`	`getToolTypes()`
`default boolean`	`hasContainerItem()` ItemStack sensitive version of hasContainerItem
`default boolean`	`isBeaconPayment()` Whether this Item can be used as a payment to activate the vanilla beacon.
`default boolean`	`isBookEnchantable(ItemStack book)` Allow or forbid the specific book/item combination as an anvil enchant
`default boolean`	`isShield(EntityLivingBase entity)` Is this Item a shield
`default void`	`onArmorTick(World world, EntityPlayer player)` Called to tick armor in the armor slot.
`default boolean`	`onBlockStartBreak(BlockPos pos, EntityPlayer player)` Called before a block is broken.
`default boolean`	`onDroppedByPlayer(EntityPlayer player)` Called when a player drops the item into the world, returning false from this will prevent the item from being removed from the players inventory and spawning in the world
`default boolean`	`onEntityItemUpdate(EntityItem entity)` Called by the default implemetation of EntityItem's onUpdate method, allowing for cleaner control over the update of the item without having to write a subclass.
`default boolean`	`onEntitySwing(EntityLivingBase entity)` Called when a entity tries to play the 'swing' animation.
`default void`	`onHorseArmorTick(World world, EntityLiving horse)` Called every tick from `EntityHorse#onUpdate()` on the item in the armor slot.
`default EnumActionResult`	`onItemUseFirst(ItemUseContext context)`
`default void`	`onUsingTick(EntityLivingBase player, int count)` Called each tick while using an item.
`default void`	`readShareTag(NBTTagCompound nbt)` Override this method to decide what to do with the NBT data received from getNBTShareTag().
`default NBTTagCompound`	`serializeNBT()`
`default boolean`	`shouldCauseBlockBreakReset(ItemStack newStack)` Called when the player is mining a block and the item in his hand changes.

Methods inherited from interface net.minecraftforge.common.capabilities.ICapabilityProvider
getCapability, getCapability

Methods inherited from interface net.minecraftforge.common.util.INBTSerializable
deserializeNBT

- Method Detail
  - getStack
```
default ItemStack getStack()
```
  - getContainerItem
```
default ItemStack getContainerItem()
```
    ItemStack sensitive version of getContainerItem. Returns a full ItemStack instance of the result.
    
    Parameters:
    
    itemStack - The current ItemStack
    
    Returns:
    
    The resulting ItemStack
  - hasContainerItem
```
default boolean hasContainerItem()
```
    ItemStack sensitive version of hasContainerItem
    
    Parameters:
    
    stack - The current item stack
    
    Returns:
    
    True if this item has a 'container'
  - getBurnTime
```
default int getBurnTime()
```
    Returns:
    
    the fuel burn time for this itemStack in a furnace. Return 0 to make it not act as a fuel. Return -1 to let the default vanilla logic decide.
  - getHarvestLevel
```
default int getHarvestLevel(ToolType tool,
                            @Nullable
                            EntityPlayer player,
                            @Nullable
                            IBlockState state)
```
    Queries the harvest level of this item stack for the specified tool class, Returns -1 if this tool is not of the specified type
    
    Parameters:
    
    stack - This item stack instance
    
    toolClass - Tool Class
    
    player - The player trying to harvest the given blockstate
    
    state - The block to harvest
    
    Returns:
    
    Harvest level, or -1 if not the specified tool type.
  - getToolTypes
```
default java.util.Set<ToolType> getToolTypes()
```
  - onItemUseFirst
```
default EnumActionResult onItemUseFirst(ItemUseContext context)
```
  - serializeNBT
```
default NBTTagCompound serializeNBT()
```
    Specified by:
    
    serializeNBT in interface INBTSerializable<NBTTagCompound>
  - onBlockStartBreak
```
default boolean onBlockStartBreak(BlockPos pos,
                                  EntityPlayer player)
```
    Called before a block is broken. Return true to prevent default block harvesting. Note: In SMP, this is called on both client and server sides!
    
    Parameters:
    
    pos - Block's position in world
    
    player - The Player that is wielding the item
    
    Returns:
    
    True to prevent harvesting, false to continue as normal
  - shouldCauseBlockBreakReset
```
default boolean shouldCauseBlockBreakReset(ItemStack newStack)
```
    Called when the player is mining a block and the item in his hand changes. Allows to not reset blockbreaking if only NBT or similar changes.
    
    Parameters:
    
    newStack - The new stack
    
    Returns:
    
    True to reset block break progress
  - canApplyAtEnchantingTable
```
default boolean canApplyAtEnchantingTable(Enchantment enchantment)
```
    Checks whether an item can be enchanted with a certain enchantment. This applies specifically to enchanting an item in the enchanting table and is called when retrieving the list of possible enchantments for an item. Enchantments may additionally (or exclusively) be doing their own checks in Enchantment.canApplyAtEnchantingTable(ItemStack); check the individual implementation for reference. By default this will check if the enchantment type is valid for this item type.
    
    Parameters:
    
    stack - the item stack to be enchanted
    
    enchantment - the enchantment to be applied
    
    Returns:
    
    true if the enchantment can be applied to this item
  - getItemEnchantability
```
default int getItemEnchantability()
```
    ItemStack sensitive version of getItemEnchantability
    
    Returns:
    
    the item echantability value
  - getEquipmentSlot
```
@Nullable
default EntityEquipmentSlot getEquipmentSlot()
```
    Override this to set a non-default armor slot for an ItemStack, but do not use this to get the armor slot of said stack; for that, use EntityLiving.getSlotForItemStack(ItemStack).
    
    Returns:
    
    the armor slot of the ItemStack, or null to let the default vanilla logic as per EntityLiving.getSlotForItemStack(stack) decide
  - canDisableShield
```
default boolean canDisableShield(ItemStack shield,
                                 EntityLivingBase entity,
                                 EntityLivingBase attacker)
```
    Can this Item disable a shield
    
    Parameters:
    
    shield - The shield in question
    
    entity - The EntityLivingBase holding the shield
    
    attacker - The EntityLivingBase holding the ItemStack
  - isShield
```
default boolean isShield(@Nullable
                         EntityLivingBase entity)
```
    Is this Item a shield
    
    Parameters:
    
    entity - The Entity holding the ItemStack
    
    Returns:
    
    True if the ItemStack is considered a shield
  - onEntitySwing
```
default boolean onEntitySwing(EntityLivingBase entity)
```
    Called when a entity tries to play the 'swing' animation.
    
    Parameters:
    
    entity - The entity swinging the item.
    
    Returns:
    
    True to cancel any further processing by EntityLiving
  - onUsingTick
```
default void onUsingTick(EntityLivingBase player,
                         int count)
```
    Called each tick while using an item.
    
    Parameters:
    
    player - The Player using the item
    
    count - The amount of time in tick the item has been used for continuously
  - getEntityLifespan
```
default int getEntityLifespan(World world)
```
    Retrieves the normal 'lifespan' of this item when it is dropped on the ground as a EntityItem. This is in ticks, standard result is 6000, or 5 mins.
    
    Parameters:
    
    world - The world the entity is in
    
    Returns:
    
    The normal lifespan in ticks.
  - onEntityItemUpdate
```
default boolean onEntityItemUpdate(EntityItem entity)
```
    Called by the default implemetation of EntityItem's onUpdate method, allowing for cleaner control over the update of the item without having to write a subclass.
    
    Parameters:
    
    entity - The entity Item
    
    Returns:
    
    Return true to skip any further update code.
  - getHorseArmorType
```
default HorseArmorType getHorseArmorType()
```
    Returns an enum constant of type HorseArmorType. The returned enum constant will be used to determine the armor value and texture of this item when equipped.
    
    Returns:
    
    an enum constant of type HorseArmorType. Return HorseArmorType.NONE if this is not horse armor
  - onArmorTick
```
default void onArmorTick(World world,
                         EntityPlayer player)
```
    Called to tick armor in the armor slot. Override to do something
  - onHorseArmorTick
```
default void onHorseArmorTick(World world,
                              EntityLiving horse)
```
    Called every tick from EntityHorse#onUpdate() on the item in the armor slot.
    
    Parameters:
    
    world - the world the horse is in
    
    horse - the horse wearing this armor
  - isBeaconPayment
```
default boolean isBeaconPayment()
```
    Whether this Item can be used as a payment to activate the vanilla beacon.
    
    Returns:
    
    true if this Item can be used
  - canEquip
```
default boolean canEquip(EntityEquipmentSlot armorType,
                         Entity entity)
```
    Determines if the specific ItemStack can be placed in the specified armor slot, for the entity.
    
    Parameters:
    
    armorType - Armor slot to be verified.
    
    entity - The entity trying to equip the armor
    
    Returns:
    
    True if the given ItemStack can be inserted in the slot
  - isBookEnchantable
```
default boolean isBookEnchantable(ItemStack book)
```
    Allow or forbid the specific book/item combination as an anvil enchant
    
    Parameters:
    
    stack - The item
    
    book - The book
    
    Returns:
    
    if the enchantment is allowed
  - onDroppedByPlayer
```
default boolean onDroppedByPlayer(EntityPlayer player)
```
    Called when a player drops the item into the world, returning false from this will prevent the item from being removed from the players inventory and spawning in the world
    
    Parameters:
    
    player - The player that dropped the item
    
    item - The item stack, before the item is removed.
  - getShareTag
```
@Nullable
default NBTTagCompound getShareTag()
```
    Get the NBT data to be sent to the client. The Item can control what data is kept in the tag. Note that this will sometimes be applied multiple times, the following MUST be supported: Item item = stack.getItem(); NBTTagCompound nbtShare1 = item.getNBTShareTag(stack); stack.setTagCompound(nbtShare1); NBTTagCompound nbtShare2 = item.getNBTShareTag(stack); assert nbtShare1.equals(nbtShare2);
    
    Returns:
    
    The NBT tag
  - readShareTag
```
default void readShareTag(@Nullable
                          NBTTagCompound nbt)
```
    Override this method to decide what to do with the NBT data received from getNBTShareTag().
    
    Parameters:
    
    stack - The stack that received NBT
    
    nbt - Received NBT, can be null
  - doesSneakBypassUse
```
default boolean doesSneakBypassUse(IWorldReader world,
                                   BlockPos pos,
                                   EntityPlayer player)
```
    Should this item, when held, allow sneak-clicks to pass through to the underlying block?
    
    Parameters:
    
    world - The world
    
    pos - Block position in world
    
    player - The Player that is wielding the item
    
    Returns:
  - areShareTagsEqual
```
default boolean areShareTagsEqual(ItemStack other)
```
    Modeled after ItemStack.areItemStackTagsEqual Uses Item.getNBTShareTag for comparison instead of NBT and capabilities. Only used for comparing itemStacks that were transferred from server to client using Item.getNBTShareTag.
  - equals
```
default boolean equals(ItemStack other,
                       boolean limitTags)
```
    Determines if the ItemStack is equal to the other item stack, including Item, Count, and NBT.
    
    Parameters:
    
    other - The other stack
    
    limitTags - True to use shareTag False to use full NBT tag
    
    Returns:
    
    true if equals

Interface IForgeItemStack

Method Summary

Methods inherited from interface net.minecraftforge.common.capabilities.ICapabilityProvider

Methods inherited from interface net.minecraftforge.common.util.INBTSerializable

Method Detail

getStack

getContainerItem

hasContainerItem

getBurnTime

getHarvestLevel

getToolTypes

onItemUseFirst

serializeNBT

onBlockStartBreak

shouldCauseBlockBreakReset

canApplyAtEnchantingTable

getItemEnchantability

getEquipmentSlot

canDisableShield

isShield

onEntitySwing

onUsingTick

getEntityLifespan

onEntityItemUpdate

getHorseArmorType

onArmorTick

onHorseArmorTick

isBeaconPayment

canEquip

isBookEnchantable

onDroppedByPlayer

getShareTag

readShareTag

doesSneakBypassUse

areShareTagsEqual

equals