Minecraft:Attribute
More actions
 |
For the {{{Description}}} of the same name, see [[{{{Destination}}}]]. |
An attribute is a value that determines certain properties of Minecraft:mobs, Minecraft:armor stands, and Minecraft:players. Attributes also have modifiers that adjust the strength of their effects.
Applying attributes
Attributes can be applied directly to living entities using the Template:Cmd command. The below command is an example that dramatically increases the luck attribute, leading to the player being able to fish treasures nearly every time:
After it's modified, it can then be reset to the default value (which is 0.0 for Template:Attr attribute):
Additionally, attribute values can be specified when summoning a mob. For example, the following command summons a zombie that follows players when they are 100 blocks or fewer from it instead of the usual 35:
Item modifiers
Attributes can also be applied as attribute modifiers on items by using Minecraft:data components. When applied to an item, a modifier adjusts the corresponding attribute if the item is held or worn.<ref>Template:Tweet</ref><ref>Template:Tweet</ref> Attribute modifiers can be added to items by adding data tags to the item. Each attribute modifier has a unique identifier, which is a Minecraft:resource location to identify the modifier.
The following command gives the player a netherite sword that deals Template:Hp extra damage:
Attributes
Template:Expand section A single attribute controls some property of an Minecraft:entity, described by its name; it has a base value, set within hard-coded minimum and maximum limits, and if undefined, it's specified by the default value. The base value may be multiplied or added by a set of modifiers; these affect the attribute's base, but the calculated value is always capped by the minimum and maximum.
Attribute modifiers have Minecraft:namespaced identifiers. If two modifiers have the same ID and affect the same attribute, then they do not stack; instead, only the one most recently added takes effect, overriding previous modifiers.
These attributes are found on all living and undead entities, including players.
Armor
This attribute defines the armor defense points.
Armor toughness
This attribute defines Minecraft:armor toughness.
Template:Anchor
Attack damage
This attribute defines the damage dealt by attacks, in half-hearts.
Attack knockback
This attribute defines the knockback applied to attacks.Template:Info needed It applies only to mobs with physical attacks and players.
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink |
1.5 |
| Template:EntityLink Template:EntityLink |
1 |
| Template:EntityLink All other entities |
0 |
Attack reach
Template:Infobox attribute Template:In development
This attribute determines the reach at which players can attack entities. It does not affect the interaction range.
Attack speed
Template:Infobox attribute This attribute determines recharging rate of attack strength. Its value is the number of full-strength attacks per second.
Block break speed
Template:Infobox attribute This attribute determines the speed at which the player can break blocks as a multiplier.
Block interaction range
Template:Infobox attribute This attribute determines the block Minecraft:interaction range for players in blocks.
In Minecraft:Creative mode, the block interaction range is increased by 0.5 to make some actions easier. This does not affect the base value of the attribute, so the bonus acts as a modifier.
Burning time
Template:Infobox attribute This attribute is a multiplier for how long an entity should remain on fire after being ignited. A value of 0 eliminates the burn time. It has no impact on the burning time increase when staying in fire.
Camera distance
Template:Infobox attribute
This attribute determines the distance at which the camera is placed away from the player or spectated entity when in a third-person view. This distance is multiplied by the scale attribute to get a final target camera distance. If the entity being ridden has a larger camera_distance attribute, that distance will be used.
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink |
8 |
| Template:EntityLink Template:EntityLink |
16 |
| All other entitiesTemplate:Verify | 4 |
Entity interaction range
Template:Infobox attribute This attribute determines the entity Minecraft:interaction range for players in blocks.
In Minecraft:Creative mode, the entity interaction range is increased by 2 to make some actions easier. This does not affect the base value of the attribute, so the bonus acts as a modifier.
Explosion knockback resistance
Template:Infobox attribute This attribute defines what percentage of knockback from Minecraft:explosions an entity resists. A value of 1 eliminates the knockback.
Fall damage multiplier
Template:Infobox attribute This attribute determines the amount of Minecraft:fall damage an entity takes as a multiplier.
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink |
0.5 |
| All other entities | 1 |
Flying speed
Template:Infobox attribute This attribute is a flight speed modifier in some unknown metric.Template:Info needed
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink |
0.6 |
| Template:EntityLink | 0.1 |
| Template:EntityLink | 0.05 |
| All other entities | 0.4 |
Follow range
Template:Infobox attribute This attribute determines the range in blocks within which a mob with this attribute targets players or other mobs to track. Exiting this range causes the mob to cease following the player/mob.
Gravity
Template:Infobox attribute This attribute determines the gravity affecting an entity in blocks per tick squared.
Jump strength
Template:Infobox attribute This attribute determines the initial vertical velocity of an entity when they jump, in blocks per tick.
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink Template:EntityLink |
Random (0.4–1.0) |
| Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink |
0.5 |
| All other entities | 0.42 |
Knockback resistance
This attribute determines the scale of horizontal knockback resisted from attacks and projectiles. Vertical knockback is not affected. It does not affect explosions.<ref>Template:Bug</ref> 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.
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink |
1 |
| Template:EntityLink | 0.75 |
| Template:EntityLink Template:EntityLink |
0.6 |
| All other entities | 0 |
Luck
Template:Infobox attribute
This attribute affects the results of Minecraft:loot tables using the quality or bonus_rolls tag (e.g. when opening chests or chest minecarts, fishing, and killing mobs).
Max absorption
Template:Infobox attribute This attribute is the maximum Minecraft:absorption of this entity (in half-hearts); it determines the highest health they may gain by the Absorption effect.
Max health
Template:Infobox attribute
This attribute is the maximum Minecraft:health of the entity in half-hearts. It determines the highest health they may be healed to. If the player is using this to summon a mob with high health, use this and the Health tag; for example: {Health:200.0f}.Template:Verify
| Entity | Default value |
|---|---|
| Any entity | The maximum health of the entity. See Template:Slink for a full list. |
Mining efficiency
Template:Infobox attribute This attribute is a factor to speed up the mining of blocks when using the right tool.
Movement efficiency
Template:Infobox attribute This attribute is a factor to improve walking on terrain that slows down movement. A value of 1 removes the slowdown.
Movement speed
Template:Infobox attribute Movement speed is the speed at which entities can move, but this is not the actual speed value in blocks/second. The mob's actual speed in blocks/second is a bit over 20 times this value, but is affected by various conditions, such as the behavior it's following (e.g. idling, attacking or fleeing), being ridden (if a horse), sprinting, being led by a leash, and being under the effect of a Speed or Slowness potion. Baby mobs also have an additional speed multiplier on top of the base value.
Template:Notelist
Template:Anchor
Oxygen bonus
Template:Infobox attribute
This attribute 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 Template:Frac.
Safe fall distance
Template:Infobox attribute This attribute determines the number of blocks an entity can fall before fall damage starts to be accumulated. It also determines the minimum amount of blocks the entity has to fall to make fallling particles and sounds.
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink |
6 |
| Template:EntityLink | 5 |
| All other entities | 3 |
Scale
Template:Infobox attribute This attribute multiplies the size of an entity.
Spawn reinforcements
Template:Infobox attribute This attribute determines the chance for a zombie to spawn another zombie when attacked.
| Entity | Default value |
|---|---|
| Template:EntityLink Template:EntityLink Template:EntityLink Template:EntityLink |
Random (0–0.1) |
| Template:EntityLink | 0<ref>Template:Bug</ref> |
Sneaking speed
Template:Infobox attribute This attribute determines the movement speed factor when Minecraft:sneaking or Minecraft: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.
Step height
Template:Infobox attribute This attribute determines the maximum number of blocks that an entity can step up without jumping. Minecraft:Sneaking prevents drops from heights that are higher than this attribute.<ref>Template:Bug</ref> This happens if the height that the player is above a block is equal or less than the attribute.
Submerged mining speed
Template:Infobox attribute This attribute determines 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
Template:Infobox attribute This attribute 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)
Tempt range
This attribute determines the range, in blocks, in which mobs can be tempted. When tempted, mobs follow the player while the player is holding a specific item.
| Entity | Default value |
|---|---|
| Template:EntityLink | 16 |
| All other Minecraft:Animal mobs | 10 |
| Non-Animal mobs | N/A |
Water movement efficiency
Template:Infobox attribute This attribute is a factor of movement speed when submerged. A higher value lets entities move faster. This represents only the submersion factor itself; other factors (such as sprinting) also apply.
Waypoint receive range
Template:Infobox attribute This attribute determines the maximum distance from the player to a waypoint at which the waypoint is displayed on the Minecraft:locator bar. This attribute has no effect on mobs.
| Entity | Default value |
|---|---|
| Template:EntityLink | 60,000,000 |
| All other entities | 0 |
Waypoint transmit range
Template:Infobox attribute This attribute determines the distance at which an entity displays as a waypoint on the Minecraft:locator bar.
| Entity | Default value |
|---|---|
| Template:EntityLink | 60,000,000 |
| All other entities | 0 |
Modifiers
Modifiers increase or decrease the attribute's base value by using certain operations. The resulting value after modification is capped by the attribute's minimum and maximum limits. Similar to attribute names, modifiers have a Minecraft:namespaced identifiers to uniquely identify the modifier.
However, a modifier's ID does not define the modifier's behavior; instead, it is determined by its operation. Modifiers carry an amount to their modification. When attribute modifiers are applied to items, the type parameter is required; this defines which attribute the modifier affects. Modifiers can be added or removed from all living entities using the Template:Cmd command, modifying the entity's NBT data, or using item modifiers via Minecraft:data components.
Operations
Modifier operations dictate how it modifies an attribute base value. There are three operations that exist in the game:Template:Note
| Operation | Description |
|---|---|
| add_value | Adds all of the modifiers' amounts to the base attribute.
<math>\text{Total} = \text{Base} + \text{Amount}_1 + \text{Amount}_2 + \ldots + \text{Amount}_n</math> For example, applying two add_value modifiers with amounts of 2 and 4, to attribute base of 3: <math>\text{Total} = 3 + 2 + 4 = 9</math> |
| add_multiplied_base | Multiplies the base attribute by (1 + sum of modifiers' amounts).
<math>\text{Total} = \text{Base} \times (1 + \text{Amount}_1 + \text{Amount}_2 + \ldots + \text{Amount}_n)</math>Template:Note For example, applying two add_multiplied_base modifiers with amounts of 2 and 4, to attribute base of 3: <math>\text{Total} = 3 \times (1 + 2 + 4) = 3 \times 7 = 21</math> |
| add_multiplied_total | Multiplies the base attribute by (1 + modifiers' amounts) for every modifier.
<math>\text{Total} = \text{Base} \times (1 + \text{Amount}_1) \times (1 + \text{Amount}_2) \times \ldots \times (1 + \text{Amount}_n)</math> For example, applying two add_multiplied_total modifiers with amounts of 2 and 4, to attribute base of 3: <math>\text{Total} = 3 \times (1 + 2) \times (1 + 4) = 3 \times 3 \times 5 = 45</math> |
If multiple attribute modifiers are applied, the game first executes all add_value modifiers, then all add_multiplied_base modifiers, and finally all add_multiplied_total modifiers. The Total value is always carried as the Base for the next set of modifiers.
Vanilla modifiers
As stated before, a modifier's ID can be anything, and this does not affect its behavior. The following are known modifier IDs and values used in vanilla Minecraft. Manually setting vanilla modifiers with the correct ID and attribute overrides the default value.
| Modifier ID | Description and Known Values | Known Attributes Modified |
|---|---|---|
| minecraft:armor.body | Value varies based on the armor of the horse. | armor (Operation Template:Cd; Minecraft:Horses), generic.armor_toughness (Operation Template:Cd; Minecraft:Horses) |
| minecraft:armor.body | Fixed value of 11.0 for wolves wearing wolf armor. | armor (Operation Template:Cd; Minecraft:Wolves) |
| minecraft:armor.helmet
minecraft:armor.chestplate minecraft:armor.leggings minecraft:armor.boots |
Value varies based on slot and tier. | armor (Operation Template:Cd; boots, leggings, chestplate, helmet, turtle shell) |
| minecraft:armor.helmet
minecraft:armor.chestplate minecraft:armor.leggings minecraft:armor.boots |
Value varies based on tier. | armor_toughness (Operation Template:Cd; boots, leggings, chestplate, helmet, turtle shell) |
| minecraft:armor.helmet
minecraft:armor.chestplate minecraft:armor.leggings minecraft:armor.boots |
Applies knockback resistance similarily to netherite armor. A piece of netherite armor is equivalent to Template:Cd with amount 0.1. | knockback_resistance (Operation Template:Cd; boots, leggings, chestplate, helmet) |
| minecraft:attacking | Fixed value of 0.15 for Endermen and 0.05 for Zombified Piglins; exists only when attacking. | movement_speed (Operation Template:Cd; Minecraft:Endermen, Minecraft:Zombified Piglins) |
| minecraft:base_attack_damage | Value varies based on tool/weapon and tier. | attack_damage (Operation Template:Cd; tridents, shovels, pickaxes, axes, hoes, maces) |
| minecraft:base_attack_speed | Value varies based on tool/weapon and tier. | attack_speed (Operation Template:Cd; tridents, shovels, pickaxes, axes, hoes, maces) |
| minecraft:baby | Fixed value of 0.5 for Zombies and 0.2 for Piglins; exists only for their respective baby variants. | movement_speed (Operation Template:Cd; Minecraft:Baby Zombies. Minecraft:Baby Villagers) |
| minecraft:covered | Fixed value of 20.0 for Shulkers. Exists only when fully closed. | armor (Operation Template:Cd; Minecraft:Shulkers) |
| minecraft:creative_mode_block_range | Fixed value of 0.5 while player is in Creative Mode. | block_interaction_range (Operation Template:Cd; Player) |
| minecraft:creative_mode_entity_range | Fixed value of 2.0 while player is in Creative Mode. | entity_interaction_range (Operation Template:Cd; Player) |
| minecraft:drinking | Fixed value of -0.25 for Witches when drinking a potion. | movement_speed (Operation Template:Cd; Minecraft:Witches) |
| minecraft:effect.speed | Fixed value of 0.2 when under the Speed effect, multiplied by the effect's level (amplifier + 1). | movement_speed (Operation Template:Cd; All living entities) |
| minecraft:effect.slowness | Fixed value of -0.15 when under the Slowness effect, multiplied by the effect's level. | movement_speed (Operation Template:Cd; All living entities) |
| minecraft:effect.haste | Fixed value of 0.1 when under the Haste effect, multiplied by the effect's level. | attack_speed (Operation Template:Cd; All living entities) |
| minecraft:effect.mining_fatigue | Fixed value of -0.1 when under the Mining fatigue effect, multiplied by the effect's level. | attack_speed (Operation Template:Cd; All living entities) |
| minecraft:effect.strength | Fixed value of 3.0 when under the Strength effect, multiplied by the effect's level. | attack_damage (Operation Template:Cd; All living entities) |
| minecraft:effect.weakness | Fixed value of -4.0 when under the Weakness effect, multiplied by the effect's level. | attack_damage (Operation Template:Cd; All living entities) |
| minecraft:effect.health_boost | Fixed value of 4.0 when under the Health Boost effect, multiplied by the effect's level. | max_health (Operation Template:Cd; All living entities) |
| minecraft:effect.luck | Fixed value of 1.0 when under the Luck effect, multiplied by the effect's level. | luck (Operation Template:Cd; All living entities) |
| minecraft:effect.unluck | Fixed value of -1.0 when under the Unluck effect, multiplied by the effect's level. | luck (Operation Template:Cd; All living entities) |
| minecraft:effect.jump_boost | Fixed value of 0.1 when under the Jump boost effect, multiplied by the effect's level. | jump_strength (Operation Template:Cd; All living entities) |
| minecraft:leader_zombie_bonus | Has a (small) random chance of being generated on a zombie when spawned. For Spawn Reinforcements Chance, random number between 0.5 and 0.75. For max_health, random number between 1.0 and 4.0. | spawn_reinforcements (Operation Template:Cd; Minecraft:Zombies), max_health (Operation Template:Cd; Minecraft:Zombies) |
| minecraft:powder_snow | Value varies from 0 to -0.05 based on ticks spent in powder snow. | movement_speed (Operation Template:Cd; all living entities) |
| minecraft:random_spawn_bonus | Generated upon spawning. For follow range, a random number between ± 0.11485 is chosen, following a triangular distribution. For knockback resistance, a value between 0.0 and 0.05 is chosen. | follow_range (Operation Template:Cd; all mobs), Knockback Resistance (Operation Template:Cd; Minecraft:Zombies only) |
| minecraft:reinforcement_caller_charge | Fixed value of -0.05 created each time a zombie spawns another zombie as reinforcement. | spawn_reinforcements (Operation Template:Cd; Minecraft:Zombies) |
| minecraft:reinforcement_callee_charge | Fixed value of -0.05 created for each zombie spawned as a reinforcement. | spawn_reinforcements (Operation Template:Cd; Minecraft:Zombies) |
| minecraft:sprinting | Fixed value of 0.3 used by all mobs (including players) when sprinting. | movement_speed (Operation Template:Cd; all living entities) |
| minecraft:zombie_random_spawn_bonus | Generated upon spawning; a random number between 0.0 and 1.5. | follow_range (Operation Template:Cd; Minecraft:Zombies) |
| None/unknown | Unknown; created when the client reads attribute data sent by the server. | varies |
History
Java Edition
Bedrock Edition
Legacy Console Edition
Issues
References
Minecraft:de:Attribut Minecraft:es:Atributo Minecraft:fr:Attribut Minecraft:ja:属性 Minecraft:ko:속성 Minecraft:pl:Atrybuty Minecraft:pt:Atributo Minecraft:zh:属性