Item modifier

Item modifiers are technical JSON files that can be created inside data packs and are used to add loot functions into existing items using the command.

This page describes how item modifiers are defined and invoked. It also shows the JSON structure of a loot function, the primary JSON structure within an item modifier.

Definition
An item modifier is an item function or an array of item functions to apply to the item. They are defined using the JSON format.

Item modifiers belong in the following folder of a data pack's structure, highlighted below:


 * (data pack name)
 * pack.mcmeta
 * pack.png
 * data
 * (namespace)
 * advancements
 * (advancement).json
 * functions
 * (function).mcfunction
 * item_modifiers
 * (modifier).json
 * loot_tables
 * (loot table).json
 * predicates
 * (predicate).json
 * Further folders&hellip;

The root element of an item modifier can be either an, following the structure of an item function below, or an , containing multiple item functions.

Invocation
Item modifiers can only be invoked with the command. When doing so, it is required to specify a target slot to invoke the modifier upon, either an item inside a container block's contents, or inside an entity's inventory.

There are two variations of this command: invokes a modifier alone upon the target slot,  replaces the item in the target slot with another and subsequently invokes a modifier upon it.

 item modify (block | entity )   item replace (block | entity ) from (block | entity ) [ ] 

Although item modifiers are only invokable using commands, item functions (the underlying structure) can be entered into other files such as Loot tables.

Item function JSON format
This section describes the JSON format of a single item function. Multiple item functions may be entered into one item modifier by placing them into a JSON array.


 * The root tag of the item function.
 * : Resource location of the function to apply. Valid functions are described below.
 * : A list of predicates, of which all must pass, for this function to be applied.
 * A predicate. The JSON structure of this tag is defined on the Predicates page.
 * Other parameters of the function, described below.

The possible resource locations (namespace  is omitted) for  and associated extra contents:


 * apply_bonus&mdash;Applies a predefined bonus formula to the count of the item stack.
 * : ID of an enchantment on the tool provided by loot context used for level calculation.
 * : A resource location. Can be  for a binomial distribution (with ,  ),   for uniform distribution (from   to  ), or   for a special function used for ore drops in the vanilla game.
 * : Values required for the formula.
 * : For formula 'binomial_with_bonus_count', the extra value.
 * : For formula 'binomial_with_bonus_count', the probability.
 * : For formula 'uniform_bonus_count', the bonus multiplier.


 * copy_name&mdash;Copies an entity's or a block entity's name tag into the item's  tag.
 * - The target whose name will be copied. Specifies an entity or block entity from loot context. Can be, , , or (cannot be ).


 * copy_nbt&mdash;Copies NBT values from a specified block entity or entity, or from command storage to the item's  tag.
 * Shorthand form of below with  set to  . Specifies an entity or block entity from loot context. Can be, , , , or.
 * : Information of the block entity, entity or storage to copy NBT from.
 * Set to  to use a block entity or an entity as the source, or   to use a command storage as the source.
 * Included only if  is set to  . Specifies an entity or block entity from loot context to copy NBT from. Can be, , , , or.
 * Included only if  is set to  . A resource location specifying the storage ID to copy NBT from.
 * A list of copy operations.
 * An NBT operation.
 * The NBT path to copy from.
 * The NBT path to copy to, starting from the item's  tag.
 * Set to  to replace any existing contents of the target NBT path,   to append to a list or array, or   to merge into a compound tag.


 * copy_state&mdash;Copies block state properties provided by loot context to the item's  tag.
 * A block ID. Function fails if the block doesn't match the list.
 * A list of properties to copy.
 * The name of a block state to copy.


 * enchant_randomly&mdash;Enchants the item with one randomly-selected enchantment. The power of the enchantment, if applicable, is random. A book will convert to an enchanted book when enchanted.
 * Optional. List of enchantment IDs to choose from. If omitted, all discoverable enchantments (currently only Soul speed and Swift Sneak are undiscoverable) applicable to the item are possible.


 * enchant_with_levels&mdash;Enchants the item, with the specified enchantment level (roughly equivalent to using an enchantment table at that level). A book will convert to an enchanted book.
 * Determines whether treasure enchantments are allowed on this item. Defaults to false.
 * Number provider. Specifies the enchantment level to use.


 * exploration_map&mdash;If the origin is provided by loot context, converts an empty map into an explorer map leading to a nearby generated structure.
 * : A tag of structure to locate. Defaults to.
 * : The icon used to mark the destination on the map. Accepts any of the map icon text IDs (case insensitive). If  or   is used, the color of the lines on the item texture changes to match the corresponding explorer map. Defaults to.
 * : The zoom level of the resulting map. Defaults to 2.
 * : The size, in chunks, of the area to search for structures. The area checked is square, not circular. Radius 0 causes only the current chunk to be searched, radius 1 causes the current chunk and eight adjacent chunks to be searched, and so on. Defaults to 50.
 * : Don't search in chunks that have already been generated. Defaults to true.


 * explosion_decay&mdash;Removes some items from a stack, if the explosion ratius is provided by loot context. Each item in the item stack has a chance of 1/explosion radius to be lost.


 * fill_player_head&mdash;Adds required item tags of a player head.
 * : Specifies a player to be used for the player head. Specifies an entity from loot context. Can be, , , or.


 * furnace_smelt&mdash;Smelts the item as it would be in a furnace without changing its count.


 * limit_count&mdash;Limits the count of every item stack.
 * : An integer to specify the exact limit to use.
 * : Limits the count between a minimum and maximum value.
 * : Optional. A number provider. Minimum limit to use.
 * : Optional. A number provider. Maximum limit to use.


 * looting_enchant&mdash;Adjusts the stack size based on the level of the Looting enchantment on the entity provided by loot context.
 * A number provider. Specifies the number of additional items per level of looting. Note the number may be fractional, rounded after multiplying by the looting level.
 * : Specifies the maximum amount of items in the stack after the looting calculation. If the value is 0, no limit is applied. Defaults to 0.

<div id="function_set_attributes" style="margin-block-end: 1em;">
 * set_attributes&mdash;Add attribute modifiers to the item.
 * : An attribute modifier to add.
 * : Name of the modifier.
 * : The resource location of the attribute this modifier is to act upon.
 * : The operation of this attribute modifier. One of,  , or.
 * : A number provider. Specifies the amount of the modifier.
 * : Optional. UUID to assign the modifier, in hyphenated hexadecimal format. If none specified, a new random UUID is generated.
 * : Sets the slots the item must be in for the modifier to take effect. One of:,  ,  ,  ,  ,.
 * : To choose randomly from a set of possible slots. List contains strings of one of the above slot choices, to choose randomly from. The random selection can be weighted by listing the same slot multiple times.
 * : To choose randomly from a set of possible slots. List contains strings of one of the above slot choices, to choose randomly from. The random selection can be weighted by listing the same slot multiple times.

<div id="function_set_banner_pattern" style="margin-block-end: 1em;">
 * set_banner_pattern - Adds or replaces banner patterns of a banner. Function successfully adds patterns into NBT tag even if invoked on a non-banner.
 * : List of patterns to add or replace with.
 * : A pattern.
 * : The pattern type. For example,.
 * : The color for this pattern. One of,  ,  ,  ,  ,  ,  ,  ,  ,  ,  ,  ,  ,  ,  ,.
 * : Required. If true, the patterns will be applied on top of the banner's existing patterns.

<div id="function_set_contents" style="margin-block-end: 1em;">
 * set_contents - Sets the contents of a container block item to a list of entries.
 * : A list of loot table entry producer to provide item stacks.
 * : the block entity type to be written in.

<div id="function_set_count" style="margin-block-end: 1em;">
 * set_count - Sets the stack size.
 * : A number provider. Specifies the stack size to set.
 * : Optional. If, change will be relative to current count. Defaults to false.

<div id="function_set_damage" style="margin-block-end: 1em;">
 * set_damage - Sets the item's damage value (durability).
 * A number provider. Specifies the damage fraction to set (1.0 is undamaged, 0.0 is zero durability left).
 * Optional. If, change will be relative to current damage. Defaults to false.

<div id="function_set_enchantments" style="margin-block-end: 1em;">
 * set_enchantments - Modifies the item's enchantments. A book will convert to an enchanted book.
 * : Enchantments to modify.
 * : Key name is the enchantment ID. Value is a number provider specifying the enchantment power. Powers are clamped at a maximum of 255. Decreasing an enchantment power below 1 will remove the enchantment, through a relative negative add or through a direct value assignemnt.
 * : Optional. If, change will be relative to current level. A nonexistent enchantment will be presumed to start at 0. Defaults to false.

<div id="function_set_instrument" style="margin-block-end: 1em;">
 * set_instrument - Sets the item tags for instrument items to a random value from a tag.
 * : The resource location started with  of an instrument tag, one of the listings is selected randomly.

<div id="function_set_loot_table" style="margin-block-end: 1em;">
 * set_loot_table - Sets the loot table for a container block when placed and opened.
 * : Specifies the resource location of the loot table to be used.
 * : Optional. Specifies the loot table seed. If absent or set to 0, the seed won't be put into the NBT, and a random seed will be used when opening the continer.
 * : the block entity type to be written in.

<div id="function_set_lore" style="margin-block-end: 1em;">
 * set_lore - Adds or changes the item's lore.
 * : List of lines to append or replace on the item's lore.
 * A line of item lore, following the Raw JSON text format. Components requiring resolution are resolved only if  successfully targets an entity.
 * : Specifies the entity to act as  when referenced in the JSON text component. Specifies an entity from loot context. Can be, , , or.
 * : Optional. Set to  to replace the existing item lore with only the lines in . If , the lines are appended to the list of existing lines of lore. Defaults to false.

<div id="function_set_name" style="margin-block-end: 1em;">
 * set_name&mdash;Adds or changes the item's custom name.
 * : A JSON text component, overwriting the previous custom name on the item. Components requiring resolution are resolved only if  successfully targets an entity.
 * : Specifies the entity to act as  when referenced in the JSON text component. Specifies an entity from loot context. Can be, , , or.

<div id="function_set_nbt" style="margin-block-end: 1em;">
 * set_nbt&mdash;Adds or changes NBT data of the item.
 * : The NBT to merge onto the item's  tag, within a JSON string. The outer braces   of the NBT must be present within this JSON string. Additional care is required when the NBT contains quotation marks , as they must be escaped from the JSON syntax with a backslash.

<div id="function_set_potion" style="margin-block-end: 1em;">
 * set_potion&mdash;Sets the  tag of an item.
 * : The potion ID. Set to  to remove the   tag.

<div id="function_set_stew_effect">
 * set_stew_effect&mdash;Sets the status effects for suspicious stew. Fails if invoked on an item that is not suspicious stew.
 * : The effects to apply.
 * An effect.
 * : The effect ID.
 * : A number provider. The duration of the effect.

Issues
Gegenstandsmodifizierer Modificador de itens 物品修饰器