Package net.minecraft.world.item
Class Item
java.lang.Object
net.minecraft.world.item.Item
- All Implemented Interfaces:
FeatureElement
,ItemLike
,IItemExtension
- Direct Known Subclasses:
AirItem
,ArmorItem
,ArmorStandItem
,ArrowItem
,BannerPatternItem
,BlockItem
,BoatItem
,BoneMealItem
,BookItem
,BottleItem
,BrushItem
,BucketItem
,BundleItem
,ChorusFruitItem
,CompassItem
,ComplexItem
,DebugStickItem
,DiscFragmentItem
,DyeItem
,EggItem
,ElytraItem
,EnchantedBookItem
,EndCrystalItem
,EnderEyeItem
,EnderpearlItem
,ExperienceBottleItem
,FireChargeItem
,FireworkRocketItem
,FireworkStarItem
,FishingRodItem
,FlintAndSteelItem
,FoodOnAStickItem
,GlowInkSacItem
,HangingEntityItem
,HoneyBottleItem
,HoneycombItem
,InkSacItem
,InstrumentItem
,KnowledgeBookItem
,LeadItem
,MaceItem
,MilkBucketItem
,MinecartItem
,NameTagItem
,OminousBottleItem
,PotionItem
,ProjectileWeaponItem
,SaddleItem
,ShearsItem
,ShieldItem
,SmithingTemplateItem
,SnowballItem
,SpawnEggItem
,SpyglassItem
,SuspiciousStewItem
,TieredItem
,TridentItem
,WindChargeItem
,WritableBookItem
,WrittenBookItem
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic class
static interface
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final int
static final ResourceLocation
static final ResourceLocation
private final Holder.Reference
<Item> protected final boolean
private DataComponentMap
private final Item
static final int
private String
private static final org.slf4j.Logger
static final int
private final FeatureFlagSet
Fields inherited from interface net.minecraft.world.flag.FeatureElement
FILTERED_REGISTRIES
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoid
appendHoverText
(ItemStack stack, Item.TooltipContext context, List<Component> tooltipComponents, TooltipFlag tooltipFlag) asItem()
Deprecated.static Item
Deprecated.static Item
byId
(int id) boolean
canAttackBlock
(BlockState state, Level level, BlockPos pos, Player player) boolean
finishUsingItem
(ItemStack stack, Level level, LivingEntity livingEntity) Called when the player finishes using this Item (E.g.float
getAttackDamageBonus
(Entity target, float damage, DamageSource damageSource) int
getBarColor
(ItemStack stack) int
getBarWidth
(ItemStack stack) final Item
Deprecated.Deprecated.int
getDescriptionId
(ItemStack stack) Returns the unlocalized name of this item.float
getDestroySpeed
(ItemStack stack, BlockState state) int
Deprecated.Neo: Use ItemStack sensitive version.static int
protected String
static BlockHitResult
getPlayerPOVHitResult
(Level level, Player player, ClipContext.Fluid fluidMode) getTooltipImage
(ItemStack stack) getUseAnimation
(ItemStack stack) Returns the action that specifies what animation to play when the item is being used.int
getUseDuration
(ItemStack stack, LivingEntity entity) boolean
Deprecated.boolean
hurtEnemy
(ItemStack stack, LivingEntity target, LivingEntity attacker) Current implementations of this method in child classes do not use the entry argument beside ev.void
initializeClient
(Consumer<IClientItemExtensions> consumer) Deprecated, for removal: This API element is subject to removal in a future version.UseRegisterClientExtensionsEvent
insteadinteractLivingEntity
(ItemStack stack, Player player, LivingEntity interactionTarget, InteractionHand usedHand) Try interacting with given entity.void
inventoryTick
(ItemStack stack, Level level, Entity entity, int slotId, boolean isSelected) Called each tick as long the item is in a player's inventory.boolean
isBarVisible
(ItemStack stack) boolean
boolean
isCorrectToolForDrops
(ItemStack stack, BlockState state) boolean
isEnchantable
(ItemStack stack) Checks isDamagable and if it cannot be stackedboolean
Returnstrue
if this item has an enchantment glint.boolean
isRepairable
(ItemStack stack) Called by CraftingManager to determine if an item is reparable.boolean
isValidRepairItem
(ItemStack stack, ItemStack repairCandidate) Return whether this item is repairable in an anvil.boolean
mineBlock
(ItemStack stack, Level level, BlockState state, BlockPos pos, LivingEntity miningEntity) Called when aBlock
is destroyed using this Item.void
Deprecated.Neo: do not use, usethe event
insteadvoid
onCraftedBy
(ItemStack stack, Level level, Player player) Called when item is crafted/smelted.void
onCraftedPostProcess
(ItemStack stack, Level level) void
onDestroyed
(ItemEntity itemEntity) Deprecated.void
onUseTick
(Level level, LivingEntity livingEntity, ItemStack stack, int remainingUseDuration) Called as the item is being used by an entity.boolean
overrideOtherStackedOnMe
(ItemStack stack, ItemStack other, Slot slot, ClickAction action, Player player, SlotAccess access) boolean
overrideStackedOnOther
(ItemStack stack, Slot slot, ClickAction action, Player player) void
postHurtEnemy
(ItemStack stack, LivingEntity target, LivingEntity attacker) void
releaseUsing
(ItemStack stack, Level level, LivingEntity livingEntity, int timeCharged) Called when the player stops using an Item (stops holding the right mouse button).toString()
use
(Level level, Player player, InteractionHand usedHand) Called to trigger the item's "innate" right click behavior.useOn
(UseOnContext context) Called when this item is used when targeting a Blockboolean
useOnRelease
(ItemStack stack) If this stack's item is a crossbowvoid
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface net.minecraft.world.flag.FeatureElement
isEnabled
Methods inherited from interface net.neoforged.neoforge.common.extensions.IItemExtension
applyEnchantments, canBeHurtBy, canContinueUsing, canDisableShield, canElytraFly, canEquip, canGrindstoneRepair, canPerformAction, canWalkOnPowderedSnow, createEntity, damageItem, doesSneakBypassUse, elytraFlightTick, getAllEnchantments, getArmorTexture, getBurnTime, getCraftingRemainingItem, getCreatorModId, getDamage, getDefaultAttributeModifiers, getEnchantmentLevel, getEnchantmentValue, getEntityLifespan, getEquipmentSlot, getFoodProperties, getHighlightTip, getMaxDamage, getMaxStackSize, getSweepHitBox, getXpRepairRatio, hasCraftingRemainingItem, hasCustomEntity, isBookEnchantable, isDamageable, isDamaged, isEnderMask, isNotReplaceableByPickAction, isPiglinCurrency, isPrimaryItemFor, makesPiglinsNeutral, onAnimalArmorTick, onDestroyed, onDroppedByPlayer, onEntityItemUpdate, onEntitySwing, onEntitySwing, onItemUseFirst, onLeftClickEntity, onStopUsing, setDamage, shouldCauseBlockBreakReset, shouldCauseReequipAnimation, supportsEnchantment
-
Field Details
-
LOGGER
private static final org.slf4j.Logger LOGGER -
BY_BLOCK
-
BASE_ATTACK_DAMAGE_ID
-
BASE_ATTACK_SPEED_ID
-
DEFAULT_MAX_STACK_SIZE
public static final int DEFAULT_MAX_STACK_SIZE- See Also:
-
ABSOLUTE_MAX_STACK_SIZE
public static final int ABSOLUTE_MAX_STACK_SIZE- See Also:
-
MAX_BAR_WIDTH
public static final int MAX_BAR_WIDTH- See Also:
-
builtInRegistryHolder
-
components
-
craftingRemainingItem
-
descriptionId
-
requiredFeatures
-
canRepair
protected final boolean canRepair
-
-
Constructor Details
-
Item
-
-
Method Details
-
getId
-
byId
-
byBlock
Deprecated. -
builtInRegistryHolder
Deprecated. -
components
-
modifyDefaultComponentsFrom
Deprecated.Neo: do not use, usethe event
instead -
getDefaultMaxStackSize
public int getDefaultMaxStackSize() -
onUseTick
public void onUseTick(Level level, LivingEntity livingEntity, ItemStack stack, int remainingUseDuration) Called as the item is being used by an entity. -
onDestroyed
Deprecated. -
verifyComponentsAfterLoad
-
canAttackBlock
-
asItem
-
useOn
Called when this item is used when targeting a Block -
getDestroySpeed
-
use
Called to trigger the item's "innate" right click behavior. To handle when this item is used on a Block, seeuseOn(net.minecraft.world.item.context.UseOnContext)
. -
finishUsingItem
Called when the player finishes using this Item (E.g. finishes eating.). Not called when the player stops using the Item before the action is complete. -
isBarVisible
-
getBarWidth
-
getBarColor
-
overrideStackedOnOther
public boolean overrideStackedOnOther(ItemStack stack, Slot slot, ClickAction action, Player player) -
overrideOtherStackedOnMe
public boolean overrideOtherStackedOnMe(ItemStack stack, ItemStack other, Slot slot, ClickAction action, Player player, SlotAccess access) -
getAttackDamageBonus
-
hurtEnemy
Current implementations of this method in child classes do not use the entry argument beside ev. They just raise the damage on the stack. -
postHurtEnemy
-
mineBlock
public boolean mineBlock(ItemStack stack, Level level, BlockState state, BlockPos pos, LivingEntity miningEntity) Called when aBlock
is destroyed using this Item. Returntrue
to trigger the "Use Item" statistic. -
isCorrectToolForDrops
-
interactLivingEntity
public InteractionResult interactLivingEntity(ItemStack stack, Player player, LivingEntity interactionTarget, InteractionHand usedHand) Try interacting with given entity. ReturnInteractionResult.PASS
if nothing should happen. -
getDescription
-
toString
-
getOrCreateDescriptionId
-
getDescriptionId
-
getDescriptionId
Returns the unlocalized name of this item. This version accepts an ItemStack so different stacks can have different names based on their damage or NBT. -
getCraftingRemainingItem
Deprecated. -
hasCraftingRemainingItem
Deprecated. -
inventoryTick
public void inventoryTick(ItemStack stack, Level level, Entity entity, int slotId, boolean isSelected) Called each tick as long the item is in a player's inventory. Used by maps to check if it's in a player's hand and update its contents. -
onCraftedBy
Called when item is crafted/smelted. Used only by maps so far. -
onCraftedPostProcess
-
isComplex
public boolean isComplex() -
getUseAnimation
Returns the action that specifies what animation to play when the item is being used. -
getUseDuration
-
releaseUsing
Called when the player stops using an Item (stops holding the right mouse button). -
appendHoverText
public void appendHoverText(ItemStack stack, Item.TooltipContext context, List<Component> tooltipComponents, TooltipFlag tooltipFlag) -
getTooltipImage
-
getName
-
isFoil
Returnstrue
if this item has an enchantment glint. By default, this returnsstack.isEnchanted()
, but other items can override it (for instance, written books always return true). Note that if you override this method, you generally want to also call the super version (onItem
) to get the glint for enchanted items. Of course, that is unnecessary if the overwritten version always returns true. -
isEnchantable
Checks isDamagable and if it cannot be stacked -
getPlayerPOVHitResult
public static BlockHitResult getPlayerPOVHitResult(Level level, Player player, ClipContext.Fluid fluidMode) -
getEnchantmentValue
Deprecated.Neo: Use ItemStack sensitive version. -
isValidRepairItem
Return whether this item is repairable in an anvil. -
getDefaultAttributeModifiers
Deprecated. -
isRepairable
Description copied from interface:IItemExtension
Called by CraftingManager to determine if an item is reparable.- Specified by:
isRepairable
in interfaceIItemExtension
- Returns:
- True if reparable
-
useOnRelease
If this stack's item is a crossbow -
getDefaultInstance
-
getDrinkingSound
-
getEatingSound
-
getBreakingSound
-
canFitInsideContainerItems
public boolean canFitInsideContainerItems() -
requiredFeatures
- Specified by:
requiredFeatures
in interfaceFeatureElement
-
initializeClient
@Deprecated(forRemoval=true, since="1.21") public void initializeClient(Consumer<IClientItemExtensions> consumer) Deprecated, for removal: This API element is subject to removal in a future version.UseRegisterClientExtensionsEvent
insteadNeo: Allowing mods to define client behavior for their Items
-
IItemExtension.getDefaultAttributeModifiers(ItemStack)