Package net.fabricmc.fabric.api.transfer.v1.item

Interface ItemVariant

All Superinterfaces:
TransferVariant<net.minecraft.world.item.Item>
@NonExtendable public interface ItemVariant extends TransferVariant<net.minecraft.world.item.Item>
An immutable count-less ItemStack, i.e. an immutable association of an item and its data components.

Do not implement, use the static of(...) functions instead.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final com.mojang.serialization.Codec<ItemVariant>
    CODEC
     
    static final net.minecraft.network.codec.StreamCodec<net.minecraft.network.RegistryFriendlyByteBuf,ItemVariant>
    PACKET_CODEC
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static ItemVariant
    blank()
    Retrieve a blank ItemVariant.
    default net.minecraft.world.item.Item
    getItem()
    Return the item of this variant.
    default net.minecraft.core.Holder<net.minecraft.world.item.Item>
    getRegistryEntry()
     
    default boolean
    matches(net.minecraft.world.item.ItemStack stack)
    Return true if the item and tag of this variant match those of the passed stack, and false otherwise.
    static ItemVariant
    of(net.minecraft.world.item.ItemStack stack)
    Retrieve an ItemVariant with the item and tag of a stack.
    static ItemVariant
    of(net.minecraft.world.level.ItemLike item)
    Retrieve an ItemVariant with an item and without a tag.
    static ItemVariant
    of(net.minecraft.world.level.ItemLike item, net.minecraft.core.component.DataComponentPatch components)
    Retrieve an ItemVariant with an item and an optional tag.
    default net.minecraft.world.item.ItemStack
    toStack()
    Create a new item stack with count 1 from this variant.
    default net.minecraft.world.item.ItemStack
    toStack(int count)
    Create a new item stack from this variant.
    ItemVariant
    withComponentChanges(net.minecraft.core.component.DataComponentPatch changes)
    Creates a copy of this ItemVariant with the provided component changes applied.

    Methods inherited from interface net.fabricmc.fabric.api.transfer.v1.storage.TransferVariant

    componentsMatch, getComponentMap, getComponents, getObject, hasComponents, isBlank, isOf

  • Field Details

    • CODEC

      static final com.mojang.serialization.Codec<ItemVariant> CODEC

    • PACKET_CODEC

      static final net.minecraft.network.codec.StreamCodec<net.minecraft.network.RegistryFriendlyByteBuf,ItemVariant> PACKET_CODEC

  • Method Details

    • blank

      static ItemVariant blank()
      Retrieve a blank ItemVariant.

    • of

      static ItemVariant of(net.minecraft.world.item.ItemStack stack)
      Retrieve an ItemVariant with the item and tag of a stack.

    • of

      static ItemVariant of(net.minecraft.world.level.ItemLike item)
      Retrieve an ItemVariant with an item and without a tag.

    • of

      static ItemVariant of(net.minecraft.world.level.ItemLike item, net.minecraft.core.component.DataComponentPatch components)
      Retrieve an ItemVariant with an item and an optional tag.

    • matches

      default boolean matches(net.minecraft.world.item.ItemStack stack)
      Return true if the item and tag of this variant match those of the passed stack, and false otherwise.

    • getItem

      default net.minecraft.world.item.Item getItem()
      Return the item of this variant.

    • getRegistryEntry

      default net.minecraft.core.Holder<net.minecraft.world.item.Item> getRegistryEntry()

    • toStack

      default net.minecraft.world.item.ItemStack toStack()
      Create a new item stack with count 1 from this variant.

    • toStack

      default net.minecraft.world.item.ItemStack toStack(int count)
      Create a new item stack from this variant.
      Parameters:
      count - The count of the returned stack. It may lead to counts higher than maximum stack size.

    • withComponentChanges

      ItemVariant withComponentChanges(net.minecraft.core.component.DataComponentPatch changes)
      Creates a copy of this ItemVariant with the provided component changes applied.
      Specified by:
      withComponentChanges in interface TransferVariant<net.minecraft.world.item.Item>
      Parameters:
      changes - the changes to apply
      Returns:
      the new variant with the changes applied
      See Also:
      • ItemStack.applyComponents(DataComponentPatch)