> For the complete documentation index, see [llms.txt](https://guide.elitefantasy.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.elitefantasy.net/components-guide/introduction/components.md).
# Components
## Why can't I use the command?
If the command is too long I recommend you to use command blocks, for better guidance use [this](https://mcstacker.net/?cmd=give)
## attribute\_modifiers
These allow you to modify different properties of the items, and also some are exclusive for entities.
| Atrribute | Default Value | Minimum \~ Maximum | Description |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `armor` | 0 | 0\~30 | Armor defense points. |
| `armor_toughness` | 0 | 0\~20 | [Armor toughness](https://minecraft.wiki/w/Armor_toughness). |
| `attack_damage` | 2 | 0\~2048 | Damage dealt by attacks, in half-hearts. |
| `attack_knockback` | 0 | 0\~5 | Knockback applied to attacks. Applies only to mobs with physical attacks. |
| generic.attack\_reach
\[upcoming JE Edition Combat Tests]
| 2.5 | 0\~6 | Determines the reach at which players can attack entities. Does not affect interaction range. |
| `attack_speed` | 4 | 0\~1024 | Determines recharging rate of attack strength. Value is the number of full-strength attacks per second. |
| `flying_speed` | 0.4 | 0\~1024 | Flight speed modifier in some unknown metric. |
| `knockback_resistance` | 0 | 0\~1 | The scale of horizontal knockback resisted from attacks and projectiles. Vertical knockback is not affected. Does not affect explosions. The resistance functions as a percentage from 0.0 (0% resistance) to 1.0 (100% resistance) (e.g. 0.4 is 40% resistance, meaning the attributed mob takes 60% of usual knockback). Iron golems and wardens suffer zero knockback from attacks or projectiles. |
| `block_interaction_range` | 4.5 | 0\~64 | The block interaction range for players in blocks. |
| `block_break_speed` | 1 | 0\~1024 | The speed the player can break blocks as a multiplier. |
| `mining_efficiency` | 0 | 0\~1024 | A factor to speed up the mining of blocks when using the right tool. |
| `sneaking_speed` | 0.3 | 0\~1 | The movement speed factor when sneaking or crawling. A factor of 1 means sneaking or crawling is as fast as walking, a factor of 0 means unable to move while sneaking or crawling. |
| `submerged_mining_speed` | 0.2 | 0\~20 | The mining speed factor when underwater. A factor of 1 means mining as fast as on land, a factor of 0 means unable to mine while submerged. This represents only the submersion factor itself; other factors (such as not touching the ground) also apply |
| `sweeping_damage_ratio` | 0 | 0\~1 | Determines how much of the base attack damage gets transferred to secondary targets in a sweep attack. This is in addition to the base attack of the sweep damage itself. A value of 1 means that all of the base attack damage is transferred (sweep damage is attack\_damage + 1) |
| `oxygen_bonus` | 0 | 0\~1024 | Determines the chance that an entity's `Air` data tag decreases in any given game tick, while the entity is underwater. The chance is given by `1 / (oxygen_bonus +1)`. |
| `movement_efficiency` | 0 | 0\~1024 | A factor to improve walking on terrain that slows down movement. A value of 1 removes the slowing down. |
| `explosion_knockback_resistance` | 0 | 0\~1 | Defines what percentage of knockback an entity resists. A value of 1 eliminates the knockback. |
| `burning_time` | 1 | 0\~1024 | Amount of time how long an entity remains on fire after being ignited as a multiplier. A value of 0 eliminates the burn time. Has no impact on the burning time increase when staying in fire. |
### `Component Values`
| Parameters | Description | Extras values |
|---|
| type | The name of the attribute this modifier is to act upon | attribute_modifiers |
| slot | Slot or slot type the item must be in for the modifier to take effect | Can be any, hand, armor, mainhand, offhand, head, chest, legs, feet or body. Defaults to any |
| id | The unique resource location to identify this modifier. | |
| amount | Amount of change from the modifier. | |
| operation | Operations Value | |
### `Operations Value`
| Operation | Description |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `add_value` (+- `amount`) | Adds all of the modifiers' amounts to the base attribute.
Total = Base + Amount1 + Amount2 + … + Amountn
For example, applying two add\_value modifiers with amounts of 2 and 4, to attribute base of 3:
Total = 3 + 2 + 4 = 9
|
| `add_multiplied_base` (+- `amount`, `additive`) | Multiplies the base attribute by (1 + sum of modifiers' amounts).
Total = Base × ( 1 + Amount1 + Amount2 + … + Amountn)
For example, applying two add\_multiplied\_base modifiers with amounts of 2 and 4, to attribute base of 3:
Total = 3 × ( 1 + 2 + 4 ) = 3 × 7 = 21
|
| `add_multiplied_total` ( + - `amount`, `multiplicative`) | Multiplies the base attribute by ( 1 + modifiers' amounts) for every modifier.
Total = Base × ( 1 + Amount1 ) × ( 1 + Amount2 ) × … × ( 1 + Amountn )
For example, applying two add\_multiplied\_total modifiers with amounts of 2 and 4, to attribute base of 3:
Total = 3 × ( 1 + 2 ) × ( 1 + 4 ) = 3 × 3 × 5 = 45
|
### Give Command Example
`/give @p paper[attribute_modifiers=[{id:"armor",type:"armor",amount:1,operation:"add_value",slot:"chest"},{id:"armor_toughness",type:"armor_toughness",amount:1,operation:"add_value",slot:"chest"}]] 1`
## can\_break
When present, the player holding the item will be able to break the specified blocks in adventure mode.
### `Component Values`
| Predicates Parameters | Description |
|---|
| blocks | Can be a block ID or a block tag with a #, or a list of block IDs. |
| nbt | Block entity NBT to match. See Block entity format. |
| state | The block state properties to match
A key-value pair, where the key is a block state key and the value is a block state value to match, for example facing: "east". |
| show_in_tooltip | Show or hide the "Can break" line on this item's tooltip. Defaults to true |
### Give Command Example
`/give @p paper[can_break={predicates:[{blocks:'black_concrete','coal_ore'},{blocks:'gravel'}],show_in_tooltip:true}]`
## can\_place\_on
| Predicates Parameters | Description |
|---|
| blocks | Can be a block ID or a block tag with a #, or a list of block IDs. |
| nbt | Block entity NBT to match. See Block entity format. |
| state | The block state properties to match
A key-value pair, where the key is a block state key and the value is a block state value to match, for example facing: "east". |
| show_in_tooltip | Show or hide the "Can break" line on this item's tooltip. Defaults to true |
### Give Command Example
`/give @p paper[can_place_on={predicates:[{blocks:'black_concrete','coal_ore'},{blocks:'bell'}],show_in_tooltip:true}] 1`
## consumable
If present, the item can be consumed. Its options can also be modified.
| Parameters | Description |
|---|
| consume_seconds | The amount of seconds it takes for a player to consume the item. Defaults to 1.6. |
| animation | The animation used during consumption of the item. Must be one of none, eat, drink, block, bow, spear, crossbow, spyglass, toot_horn or brush. Defaults to eat |
| sound | One sound event (an [String] ID, or a new [NBT Compound / JSON Object] sound event definition) used during and on completion of the item's consumption. Defaults to entity.generic.eat |
| has_consume_particles | Whether consumption particles are emitted while consuming this item. Defaults to true. |
| on_consume_effects | A list of effects which take place as a result of consuming this item. Optional. |
| teleport_randomly | Value in Floats to teleport the player like a Chorus Fruit |
### on\_consume\_effects
| Type Parameters | Description |
| ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type` | The kind of consume effect. Must be one of apply\_effects, remove\_effects, clear\_all\_effects, teleport\_randomly or play\_sound
If type is apply\_effectsApplies effects on the consumer.
|
| `probability` | The chance for the above effects to be applied once consumed. Must be a positive float between 0.0 and 1.0. Defaults to 1.0. |
| (If type is teleport\_randomly)
diameter
| The diameter that the consumer is teleported within. Defaults to 16.0. |
| | |
| Effects Parameters | Description |
|---|
| id | The ID of the effect. |
| amplifier | The amplifier of the effect, with level I having value 0. Optional, defaults to 0 |
| duration | The duration of the effect in ticks. Value -1 is treated as infinity. Values 0 or less than -2 are treated as 1. Optional, defaults to 1 tick. |
| ambient | Whether or not this is an effect provided by a beacon and therefore should be less intrusive on the screen. Optional, defaults to false. |
| show_particles | Whether or not this effect produces particles. Optional, defaults to true |
| show_icon | Whether or not an icon should be shown for this effect. Optional, defaults to true |
### Give Command Example
`/give @p paper[consumable={consume_seconds:1.6,animation:"brush",sound:"entity.egg.throw",has_consume_particles:true}] 1`
### Give Command Example with Effects
`/give @p paper[consumable={consume_seconds:1.6,animation:"brush",sound:"entity.egg.throw",has_consume_particles:true,on_consume_effects:[{type:"minecraft:remove_effects",effects:["minecraft:instant_damage"]},{type:"minecraft:apply_effects",effects:[{id:"minecraft:luck",amplifier:1,duration:20,show_particles:1b,show_icon:1b,ambient:1b}],probability:0.5},{type:"minecraft:teleport_randomly",diameter:0},{type:"minecraft:play_sound",sound:"block.azalea.break"}]}] 1`
## custom\_data
Contains key-value pairs of any custom data not used by the game, either as an object or a SNBT string.
| Parameters | Descriptio |
| ---------- | ------------------------------------------------------------------------------------ |
| *\* | A key-value pair, where the value can have any data type, including another compound |
### Give Command Example
`/give @p paper[custom_data={elitefantasy:idontknow}] 1`
## custom\_model\_data
Specifies the custom model data, which can be read by a resource pack's model by [items model definition.](/resourcepack-guide/beginning/models/understanding-the-item-model-system.md)
| Parameters | Description |
|---|
| floats | A list of floats for the range_dispatch model type. Missing values return the fallback model. |
| flags | A list of booleans for the condition model type. Missing value returns the is_false model. |
| strings | A list of strings for the select model type. Missing value returns the fallback model. |
| colors | A list of RGB values or number providers for the model model type's tints. Missing value returns the default value provided by the item model definition. Can either be a list of lists, or an int array. When provided as a list, it will automatically convert to an int array. |
{% hint style="success" %}
To convert RGB values to int use [this](https://argb-int-calculator.netlify.app/)
{% endhint %}
### Give Command Example
`/give @p paper[custom_model_data={floats:[100],flags:[condition123],strings:["hi1234"],colors:[I;8270847]}] 1`
## custom\_name
Text component to use as this item's name. See [Text component format](https://minecraft.wiki/w/Text_component_format).
Used to specify the item's custom name, like you can in an anvil. This component:
{% hint style="warning" %}
has a higher priority over the `item_name` component
can be renamed or removed using an anvil
if unspecified otherwise, the item's name will default to being italic.
{% endhint %}
### Give Command Example
`/give @p paper[custom_name='{"bold":true,"color":"dark_gray","font":"minecraft:default","italic":false,"obfuscated":false,"strikethrough":false,"text":"HIIIIIIIIIIIIII","underlined":false}'] 1`
## damage
Specifies the amount of durability lost (not remaining) from the item
The number of uses *consumed* (not remaining) of the item's durability. Must be a non-negative integer, defaults to 0.
### Give Command Example
`/give @p diamond_axe[damage=500]`
## damage\_resistant
Items with this component, when thrown on the ground, will be resistant to the damage types included in the component's damage tag.
This component also affects whether the equipped item will be damaged when the wearer is hurt by the given damage type.
{% hint style="info" %}
If specified, this item is invulnerable to the specified damage types when in [entity form](https://minecraft.wiki/w/Item_\(entity\)) or equipped.\
\
`types` A [damage type tag](https://minecraft.wiki/w/Tag#Damage_type_tags) prefixed with `#`.
{% endhint %}
### Give Command Example
`/give @p paper[damage_resistant={types:"#minecraft:is_explosion"}] 1`
## death\_protection
If present, this item acts like a totem of undying, by reviving the holder of this item.
{% hint style="info" %}
`death_effects`: A list of consume effects that are applied when the item protects the holder. Optional.
{% endhint %}
### Give Command Example
`/give @p paper[death_protection={death_effects:[{type:"minecraft:clear_all_effects"},{type:"minecraft:teleport_randomly",diameter:0},{type:"minecraft:play_sound",sound:"block.azalea.break"}]}] 1`
## equippable
If present, this item can be equipped in the specified slot
| Parameters | Description |
|---|
slot (1.21.5) | The slot to put the item on. Can be one of head, chest, legs, feet, body, mainhand, offhand or saddle |
| equip_sound | One sound event or a new [NBT Compound / JSON Object] sound event definition) to play when the item is equipped. Defaults to item.armor.equip_generic |
| asset_id | The resource location of the equipment model to use when equipped. The directory this refers to is assets/<namespace>/equipment/<id>.json. If not specified, falls back to rendering as the item itself when in the head slot (if not applicable, the item does not render). |
| allowed_entities | Entity ID, Entity Tag, or list of Entity IDs to limit which entities can equip this item. Defaults to all entities |
| dispensable | Whether the item can be dispensed by using a dispenser. Defaults to true |
| swappable | Whether the item can be equipped into the relevant slot by right-clicking. Defaults to true |
| damage_on_hurt | Whether this item is damaged when the wearing entity is damaged. Defaults to true |
equip_on_interact (1.21.5) | Whether this item can be equipped onto a target mob by pressing use on it (as long as this item can be equipped on the target at all). Defaults to true |
| camera_overlay | The resource location of the overlay texture to use when equipped. The directory this refers to is assets/<namespace>/textures/<id> |
### Give Command Example
`/give @p paper[equippable={slot:"chest",equip_sound:"block.anvil.break",asset_id:"minecraft:elitefantasy_cactus",allowed_entities:"minecraft:zombie",dispensable:true,swappable:true,damage_on_hurt:true}] 1`
## item\_model
Defines the item model of this item.
The resource location of the item, which references the item model definition `/assets//items/` without the .json suffix.
### Give Command Example
`/give @p paper[item_model="minecraft:paper"] 1`
## blocks\_attacks (+1.21.5)
Makes the item like a shield, blocking attacks when used
| Parameters | Description |
|---|
| block_delay_seconds | The amount of time (in seconds) that use must be held before successfully blocking attacks. Defaults to 0. |
| disable_cooldown_scale | The multiplier applied to the number of seconds that the item will be on cooldown for when attacked by a disabling attack (The multiplier for [Float] disable_blocking_for_seconds on the minecraft:weapon component). If set to 0, this item can never be disabled by attacks. Defaults to 1. |
| block_sound | One sound event, or a new [NBT Compound / JSON Object] sound event definition) to play when an attack is successfully blocked. Defaults to none. |
| disabled_sound | One sound event, or a new [NBT Compound / JSON Object] sound event definition) to play when the item goes on its disabled cooldown due to an attack. Defaults to none. |
| bypassed_by | a damage type tag with # of damage types that bypass the blocking. Defaults to none. |
### damage\_reductions options
Controls how much damage should be blocked in a given attack.
| Parameters | Description |
|---|
| type | Any number of damage type(s) (an [String] ID, or a [String] tag with #, or an [NBT List / JSON Array] array containing [String] IDs) to block. Defaults to all damage types. |
| base | The constant amount of damage to be blocked. |
| factor | The fraction of the dealt damage to be blocked. |
| horizontal_blocking_angle | strictly positive float — The maximum angle between the users facing direction and the direction of the incoming attack to be blocked. Defaults to 90 |
### item\_damage options
| Parameters | Description |
|---|
| threshold | The minimum amount of damage dealt by the attack before item damage is applied to the item. |
| base | The constant amount of damage applied to the item, if threshold is passed. |
| factor | The fraction of the dealt damage that should be applied to the item, if threshold is passed. |
| horizontal_blocking_angle | strictly positive float — The maximum angle between the users facing direction and the direction of the incoming attack to be blocked. Defaults to 90 |
### Give Command Example
`/give @p paper[blocks_attacks={block_delay_seconds:1,disable_cooldown_scale:1,bypassed_by:"#is_explosion",damage_reductions:[{base:5,factor:5,horizontal_blocking_angle:180}],item_damage:{threshold:1,base:1,factor:1},block_sound:"block.calcite.hit",disable_sound:"block.amethyst_cluster.break"}] 1`