Enchantment definition

Enchantments are stored as JSON files within a data pack in the path data/<namespace>/enchantment.

JSON format

Effect components

Components with value effects

These components use a value effect to change a value and an optional condition to check beforehand. The general format for them is:

Component ID	Value changed	Loot context for predicate
minecraft:armor_effectiveness	Effectiveness of the armor on the target of the attack. 0 completely ineffective; 1 completely effective	enchanted_damage: this entity: The attacked entity attacker entity: the attacking entity direct_attacker entity: the projectile entity Enchantment level Origin: The position of the attacked entity Damage source
minecraft:damage	Amount of damage dealt by an attack
minecraft:damage_protection	Amount of protection from incoming damage (specifically, from the portion of the damage that remains after accounting for armor). Each point of damage_protection reduces this damage by 4%, up to a maximum of 80% per damaged entity.
minecraft:smash_damage_per_fallen_block	Amount of damage added to the smash attack of a mace, per block fallen
minecraft:knockback	Knockback caused by the attack
minecraft:equipment_drops	Chance of equipment dropping from the killed entity. Value between 0 and 1
minecraft:ammo_use	Amount of ammunition used when firing a bow or crossbow	enchanted_item: Tool: The enchanted item Enchantment level
minecraft:projectile_piercing	Count of pierced entities by fired projectiles
minecraft:block_experience	Amount of experience awarded for breaking a block
minecraft:repair_with_xp	Damage to repair per XP collected
minecraft:item_damage	Amount of durability to lose when damaged
minecraft:projectile_count	Amount of projectiles spawned when firing	enchanted_entity: this entity: The projectile Enchantment level Origin The position of the projectile
minecraft:trident_return_acceleration	Used for tridents returning to their owner ​
minecraft:projectile_spread	Maximum spread of projectiles in degrees from firing direction	enchanted_entity: this entity: The player / attacking entity Enchantment level Origin The position of the attacking entity
minecraft:fishing_time_reduction	Time saved during fishing in seconds. A higher number means shorter total fishing time.
minecraft:fishing_luck_bonus	Added luck used in the fishing loot table
minecraft:mob_experience	Amount of experience awarded for killing a mob	enchanted_entity: this entity: The killed mob Enchantment level Origin The position of the killed mob

Some components don't check a predicate and always modify a value when applied. Their format is:

Component ID	Value changed
minecraft:crossbow_charge_time	Time of crossbow charging in seconds
minecraft:trident_spin_attack_strength	Strength of the spin attack of a trident.​ Any value larger than 0 causes the trident to not be thrown.

Components with entity effects

These components use an entity effect to change a value and an optional condition to check beforehand. The general format for them is:

Component ID	Effect applied	Loot context for predicate
minecraft:hit_block	After an entity hits a block using the enchanted item	hit_block: Enchantment level this entity: the entity hitting the block (the projectile if applicable) Origin: the center of the hit block Block state: The block state of the hit block
minecraft:tick	Every tick	enchanted_entity: Enchantment level this entity: the owner of the enchanted item Origin: the position of the owner
minecraft:projectile_spawned	After a projectile entity has been spawned from a bow, crossbow, snowball, trident, splash potion, lingering potion, ender pearl, firework rocket, wind charge, or egg.	enchanted_entity: Enchantment level this entity: the projectile that spawned Origin: The position of the projectile
minecraft:post_attack	After an attack damages an entity	enchanted_damage: this entity: The attacked entity attacker entity: the attacking entity direct_attacker entity: the projectile entity Enchantment level Origin: the position of the attacked entity Damage source

location_changed

Enables or disables a location-based effect when the owners block position changed, i.e. when the integer portion of the coordinate changes. Also triggers when the equipment is equipped, and when an entity with the enchantment is loaded.

The loot context for the predicate is enchanted_location:

• this entity: The entity that moved
• Enchantment level
• Origin: The position of the entity that moved
• Enchantment active status: Flag whether the enchantment was active before, i.e. the predicate succeeded at the old position.

damage_immunity

Applies damage immunity if the requirements are fulfilled.

The loot context for the predicate is enchanted_damage:

• this entity: The attacked entity (i.e the owner of the enchanted item)
• attacker entity: the attacking entity
• direct_attacker entity: the projectile entity
• Enchantment level
• Origin ​
• Damage source

prevent_equipment_drop

Prevents the item from being dropped on death of the owner when the component is present.

prevent_armor_change

Prevents the item from being unequipped from an armor slot.

attributes

Always applies all listed attribute effects.

crossbow_charging_sounds

Changes the sounds used when charging a crossbow.

trident_sound

Changes the sounds of a trident.

Value effects

Value effects are used to modify a value, see § Components with value effects.

set

Sets the value to the specified value.

add

Adds the specified value to the old value.

multiply

Multiplies the old value with the specified factor.

remove_binomial

Runs a single^{[Note 1]}​ test with the chance of removing 1 from the value.

all_of

Runs multiple value effects in series.

Attribute effects

Attribute effects are used to apply an attribute modifier to the entity that has an enchanted item equipped.

Entity effects

These effects are used to affect an entity by an enchantment component, see § Components with entity effects. The affected entity is determined by the component

all_of

Runs multiple entity effects in sequence.

apply_mob_effect

Applies a status effect to the affected mob.

damage_entity

Deals (extra) damage to the affected entity.

change_item_damage

Reduces the durability of the enchanted item

explode

Causes an explosion

ignite

Ignites the affected entity

play_sound

Plays a sound

replace_block

Places a block

replace_disk

Places a half-sphere.

run_function

Run a function.

set_block_properties

Sets the block properties of a block.

spawn_particles

Spawns particles.

summon_entity

Spawns an entity.

Location-based effects

All entity effects are also location-based effects. In this case the minecraft:all_of effect also accepts location-based effects as sub-effects. Additionally the following location-based effect exists:

attribute

Applies attribute modifiers to the affected entity.

Level-based value

A level-based value is used in enchantment effects to use different numbers depending on the level of the enchantment.

Constant

A constant float can be used instead of a compound to set a value that doesn't depend on the level of the enchantment

linear

The value is linearly increased (or decreased) per level. The final value is base + per_level_above_first * (level - 1).

levels_squared

The value is based on the square of the level. The final value is level ^ 2 + added

clamped

Uses another level-based value and clamps the resulting value to the range [min, max].

fraction

Calculates a fraction of 2 level-based values: numerator/denominator

lookup

Directly defines the value for each level, with a fallback for levels that aren't directly defined

History

Java Edition
1.21			24w18a				Enchantments can now be changed using data packs.
			24w19a				Added trigger_game_event field to replace_block, replace_disc, and set_block_properties entity effects.
							Removed predicates from crossbow_charge_time and trident_spin_attack_strength effect components.
			24w20a				Maximum value of weight is now 1024 (was unbound)
							Maximum value of max_level is now 255 (was unbound)
			24w21a				Changed attribute effects and the minecraft:attribute location based effect: removed name and uuid field, added id field
							The minecraft:damage_item entity effect doesn't affect items of players in creative mode anymore
							Changed loot context used by minecraft:hit_block effect component to hit_block (was enchanted_entity)
			pre1				Added minecraft:lookup level-based value
			pre3				Renamed replace_disc entity effect to replace_disk
1.21.2			24w33a				Added support for enchantment trigger projectile_spawned in several items.
			24w40a				Entity effect damage_item has been renamed to change_item_damage and now allows a negative value.

Notes

References

Navigation

v t e Java Edition technical
General Concepts Block entity Coordinates Crashes [String] Loot context Mob AI Point of Interest Resource location Screenshot Statistics Telemetry Tick UUID JSON General format Data values Classic Indev Pre-flattening Data component format Predicate Entity format Map item format [NBT Compound / JSON Object] NBT format Particle format Text component format § Formatting codes Key codes Random sequence Structure file format Schematic file format World Heightmap Seed Spawn chunk Data version Level format Anvil file format Chunk format Player format Point of Interest format raids.dat format Command storage format Scoreboard format Legacy Classic level format Classic server protocol Indev level format Alpha level format Infdev 20100624 level format Region file format server_level.dat villages.dat format Generated structures format .minecraft client.jar version.json client.json command_history.txt launcher_profiles.json options.txt version_manifest.json hotbar.nbt format Server list format Tools F3 Debug screen hotkey Developer Tools GameTest Obfuscation map Sound Block sound type sounds.json Subtitles Commands Brigadier Functions All commands Launching Mojang API Microsoft authentication Quick Play Legacy Legacy Minecraft authentication Yggdrasil Protocol Protocol version Packets Data types Encryption Server server.jar server.properties Server requirements Whitelist Operator list Query RCON Legacy al_version Item format
Data pack Components pack.mcmeta Pack format Advancements Functions Item modifier Loot tables Predicate Recipe Damage type Chat type Enchantment provider Painting variant Banner pattern Goat horn instrument Jukebox song Trial spawner configuration Mob variants Dialog Tag Block Item Function Fluid Entity type Game event Biome Flat level generator preset World preset Structure Point of interest type Painting variant Banner pattern Instrument Damage type Enchantment Dialog GameTest Test environment Test instance World generation Dimension Dimension type World preset Biomes Carver Configured feature Tree Placed feature Noise settings Noise router Density function Noises Surface rule Structures Structure set Template pool Processor list Structure templates Data packs Caves & Cliffs Prototype Data Pack Tutorials Installing Creating Optimizing Command blocks and functions Repairing a world corrupted by a data pack Content Custom enchantments Custom paintings Custom trims World generation New dimension Custom structures
Resource pack Components pack.mcmeta Pack format Language Models Blockstates Items Sounds (sounds.json) Shaders Textures Atlases Aa Fonts Colormaps Texts Waypoint styles regional_compliancies.json Equipment Debug Missing font character Missing model Missing texture Tutorials Creating Loading Models Sound directory