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

Class EnchantmentEvents

java.lang.Object

net.fabricmc.fabric.api.item.v1.EnchantmentEvents

public final class EnchantmentEvents
extends Object

Events relating to enchantments, allowing for finer control of what enchantments can apply to different items.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	EnchantmentEvents.AllowEnchanting

Field Summary

Fields

Modifier and Type	Field	Description
static final Event<EnchantmentEvents.AllowEnchanting>	ALLOW_ENCHANTING	An event that allows overriding whether an Enchantment can be applied to an ItemStack.

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ALLOW_ENCHANTING

public static final Event<EnchantmentEvents.AllowEnchanting> ALLOW_ENCHANTING

An event that allows overriding whether an Enchantment can be applied to an ItemStack.

This should only be used to modify the behavior of external items with regards to external enchantments, where 'external' means either vanilla or from another mod. For instance, a mod might allow enchanting a pickaxe with Sharpness (and only Sharpness) under certain specific conditions.

To modify the behavior of your own modded enchantments, specify a custom tag for Enchantment.Definition.supportedItems() instead. To modify the behavior of your own modded items, add to the applicable tags instead, when that suffices. Note that this event triggers before FabricItem.canBeEnchantedWith(ItemStack, RegistryEntry, EnchantingContext), and that method will only be called if no listeners override it.

Note that allowing an enchantment using this event does not guarantee the item will receive that enchantment, only that it isn't forbidden from doing so.

See Also:

• EnchantmentEvents.AllowEnchanting.allowEnchanting(RegistryEntry, ItemStack, EnchantingContext)
• Enchantment.isAcceptableItem(ItemStack)
• FabricItem.canBeEnchantedWith(ItemStack, RegistryEntry, EnchantingContext)