Attribute

This feature is exclusive to Java Edition.

 

An attribute is a value that determines certain properties of mobs, armor stands, and players. Attributes also have modifiers that adjust the strength of their effects.

Applying attributes

Attributes can be applied directly to living entities using the /attribute 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:

/attribute @p minecraft:luck base set 1024

After it's modified, it can then be reset to the default value (which is 0.0 for minecraft:luck attribute):

/attribute @p minecraft:luck base reset

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 40:

/summon zombie ~ ~ ~ {attributes:[{id:"follow_range", base:100.0}]}

Item modifiers

Attributes can also be applied as attribute modifiers on items by using data components. When applied to an item, a modifier adjusts the corresponding attribute if the item is held or worn.^[1][2] Attribute modifiers can be added to items by adding data tags to the item. Each attribute modifier has a unique identifier, which is a resource location to identify the modifier.

The following command gives the player a netherite sword that deals 20HP × 10 extra damage:

/give @s netherite_sword[attribute_modifiers=[{type:"attack_damage", amount:20.0, operation:"add_value", id:"example:custom_damage", slot:"mainhand"}]]

Attributes

A single attribute controls some property of an 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 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.

Attribute Name	Default Base	Minimum ~ Maximum	Description	Mob	Base Value
armor	0	0~30	Armor defense points.	Killer Bunny	8
				Wither	4
				Zombie Husk Drowned Zombie Villager Zombified Piglin	2
				Every other mob	0
armor_toughness	0	0~20	Armor toughness.	Every mob	0
attack_damage	2	0~2048	Damage dealt by attacks, in half-hearts.	Giant	50
				Warden	30
				Ravager	12
				Frog	10
				Elder Guardian	8
				Enderman Piglin Brute	7
				Blaze Guardian Hoglin Panda Phantom Polar Bear Zoglin	6
				Piglin Pillager Vindicator Zombified Piglin	5
				Vex	4
				Cat Dolphin Drowned Husk Ocelot Zombie Zombie Villager	3
				Allay Axolotl Bee Breeze Cave Spider Creeper Endermite Evoker Fox Goat Illusioner Magma Cube Skeleton Slime Spider Stray Witch Wither Wither Skeleton Wolf	2
				Silverfish Player	1
attack_knockback	0	0~5	Knockback applied to attacks. Applies only to mobs with physical attacks.[3]	Ravager Warden	1.5
				Hoglin Zoglin	1
				Player Every other mob	0
generic.attack_reach​	2.5	0~6	Determines the reach at which players can attack entities. Does not affect interaction range.	Player	2.5
attack_speed	4	0~1024	Determines recharging rate of attack strength. Value is the number of full-strength attacks per second.	Player	4
block_break_speed	1	0~1024	The speed the player can break blocks as a multiplier.	Player	1
block_interaction_range	4.5	0~64	The block interaction range for players in blocks.	Player	4.5[note 1]
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.	Every mob	1
camera_distance	4	0~32	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.	Ghast Happy Ghast	8
				Giant Ender Dragon	16
				Every other mob	4
entity_interaction_range	3	0~64	The entity interaction range for players in blocks.	Player	3[note 1]
explosion_knockback_resistance	0	0~1	Defines what percentage of knockback an entity resists from explosions. A value of 1 eliminates the knockback.	Every mob	0
fall_damage_multiplier	1	0~100	The amount of fall damage an entity takes as a multiplier.	Camel Donkey Horse Llama Mule Skeleton Horse Trader Llama Zombie Horse	0.5
				Every other mob	1
flying_speed	0.4	0~1024	Flight speed modifier in some unknown metric.	Bee Wither	0.6
				Parrot	0.4
				Allay	0.1
follow_range	32	0~2048	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. Actual value used by most mobs is 16; for zombies it is 35.	Ghast	100
				Enderman	64
				Allay Bee Blaze Villager	48
				Llama Wither	40
				Zombie Husk Drowned Zombie Villager Zombified Piglin	35
				Fox Pillager Ravager	32
				Breeze	24
				Polar Bear	20
				Illusioner	18
				Evoker Vindicator	12
				Every other mob	16
gravity	0.08	-1~1	The gravity affecting an entity in blocks per tick squared.	Every mob	0.08
jump_strength	0.42[note 2]	0~32	The initial vertical velocity of an entity when they jump, in blocks per tick.	Horse Skeleton Horse Zombie Horse	0.4-1 Random value
				Donkey Mule Llama Trader Llama	0.175
				Every other mob	0.42
knockback_resistance	0	0~1	The scale of horizontal knockback resisted from attacks and projectiles. Vertical knockback is not affected. Does not affect explosions.[4] 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.	Iron Golem Warden	1
				Ravager	0.75
				Hoglin Zoglin	0.6
				Every other mob	0
luck	0	-1024~1024	Affects the results of loot tables using the quality or bonus_rolls tag (e.g. when opening chests or chest minecarts, fishing, and killing mobs).	Player	0
max_absorption	0	0~2048	The maximum absorption of this mob (in half-hearts); determines the highest health they may gain by the Absorption effect.	Every mob	0
max_health	20	1~1024	The maximum health of this mob (in half-hearts); 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 {Health:200.0f} for example. (Disabled in 1.17)	Every mob	The maximum health of the mob
mining_efficiency	0	0~1024	A factor to speed up the mining of blocks when using the right tool.	Player	0
movement_efficiency	0	0~1	A factor to improve walking on terrain that slows down movement. A value of 1 removes the slowing down.	Every mob	0
movement_speed	0.7	0~1024	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.	Dolphin	1.2
				Axolotl Frog Tadpole	1
				Armor Stand Bat Cod Ender Dragon Ghast Glow Squid Phantom Pufferfish Salmon Shulker Squid Tropical Fish Vex Wandering Trader	0.7
				Breeze Wither	0.6
				Evoker Giant Guardian Illusioner Villager	0.5
				Piglin Piglin Brute Pillager Vindicator	0.35
				Bee Cat Cave Spider Creaking Elder Guardian Enderman Fox Hoglin Ocelot Rabbit Ravager Spider Warden Wolf Zoglin	0.3
				Chicken Creeper Endermite Iron Golem Pig Polar Bear Silverfish Skeleton Stray Turtle Witch Wither Skeleton	0.25
				Blaze Drowned Husk Sheep Zombie Zombie Villager Zombified Piglin	0.23
				Horse	0.1125 and 0.3375 Random value
				Magma Cube Slime	0.3 + 0.1 × Size
				Cow Goat Mooshroom Parrot Skeleton Horse Snow Golem Zombie Horse	0.2
				Donkey Llama Mule Strider Trader Llama	0.175
				Panda	0.15
				Armadillo	0.14
				Allay Sniffer Player	0.1
				Happy Ghast	0.05
				Camel	0.09
				Panda (lazy)	0.07
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).	Every mob	0
safe_fall_distance	3	-1024~1024	The number of blocks an entity can fall before fall damage starts to be accumulated. Also the minimum amount of blocks the entity has to fall to make fallling particles and sounds.	Fox	5
				Camel Donkey Horse Llama Mule Skeleton Horse Trader Llama Zombie Horse	6
				Every other mob	3
scale	1	0.0625~16	The multiplier of the size of an entity.	Every mob	1
spawn_reinforcements	0	0~1	Chance for a zombie to spawn another zombie when attacked.	Zombie Husk Drowned Zombie Villager Zombified Piglin	0~0.1 Random value
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.	Player	0.3
step_height	0.6	0~10	The maximum number of blocks that an entity can step up without jumping. Sneaking prevents drops from heights that are higher than this attribute.[5] This happens if the height that the player is above a block is equal or less than the attribute.	Axolotl Donkey Drowned Enderman Frog Horse Iron Golem Llama Mule Ravager Skeleton Horse Trader Llama Turtle Zombie Horse	1
				Camel	1.5
				Every other mob	0.6
				Armor Stand	0[6]
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.	Player	0.2
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)	Player	0
tempt_range	10	0~2048	Determines the range, in blocks, at which temptable mobs can be tempted.	Armadillo Axolotl Bee Camel Cat Chicken Cow Donkey Fox Frog Goat Horse Llama Mooshroom Mule Ocelot Panda Parrot Pig Polar Bear Rabbit Sheep Skeleton Horse Sniffer Strider Tadpole Trader Llama Turtle Wolf Zombie Horse	10
water_movement_efficiency	0	0~1	The movement speed factor when submerged. A higher value lets entities move faster. This represents only the submersion factor itself; other factors (such as sprinting) also apply.	Every mob	0
waypoint_receive_range	0	0~60,000,000	The maximum distance from the player to a waypoint at which it is displayed on the locator bar. This attribute has no effect on mobs.	Player	60,000,000
				Every other mob	0
waypoint_transmit_range	0	0~60,000,000	The distance at which an entity displays as a waypoint on the locator bar.	Player	60,000,000
				Every other mob	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 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 /attribute command, modifying the entity's NBT data, or using item modifiers via data components.

Operations

Modifier operations dictate how it modifies an attribute base value. There are three operations that exist in the game:^{[note 1]}

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.

History

Issues

Issues relating to "Attribute" are maintained on the bug tracker. Issues should be reported and viewed there.

References

Navigation

v t e Gameplay
General mechanics	Add-ons Commands Distance Effect Potency Explosion Game rules Interaction range Inventory Creative inventory Saved Hotbars Generated loot Hitbox Multiplayer Server Server list Realms Splitscreen Oxidation Rarity Legacy Redstone circuits Conductivity Renewability Renewable Non-renewable Rotation Snowlogging South-east rule Spawn protection Tiers Waterlogging
Survival	Achievements Advancements Archaeology Armor materials Bartering Breaking Instant mining Breeding Brewing Cooking Crafting 2×2 grid Recipe book Dual wield Difficulty Durability Enchanting Experience Farming Fishing Health Healing Hunger Item repair Mob spawning Ominous Event Ominous Trial Raid Patrol Raid captain Smelting Smithing World Spawn Taming Trading Workstations Zombie siege
Combat	Blocking Damage Attack cooldown Critical hit Knockback Sprint-knockback Drops Monster infighting Geared mobs
Environment	Biomes Daylight cycle Dimensions Seeds Structures Weather World generation More
Movement	Crawling Flying Gliding Jumping Lying Riding Sitting Sneaking Sprinting Swimming Walking
User interface	Action bar Bossbar Chat Death messages Game mode switcher Heads-up display Narrator Locator bar Scoreboard Toasts Tutorial hints Tooltip
Visuals	Color Block colors Item colors Effect colors Miscellaneous colors Emotes Enchantment glint Error Light Resource pack Screen effects Skins Character Skin pack Third-person view Vibrant Visuals
Outdated	Sword blocking Materials Update Suppression