minecraft:behavior.melee_attack
Allows an entity to deal damage through a melee attack.
Properties
| Property | Type | Default | What it does |
|---|---|---|---|
reach_multiplier | Decimalmin 0 | 2 | Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage. |
on_kill | Object | {"event": "", "filters": {"AND": null, "NOT": null, "OR":… | Defines the event to trigger when this entity kills the target. |
event | Text | "" | |
target | Textself, other, player, target, parent, baby, block, damager, holder, item | "self" | |
filters | Object or List of object | {"AND": null, "NOT": null, "OR": null, "all": null, "all_… | Filters allow data objects to specify test criteria which allows their use. Filters can be defined by a single object of type (Filter Test), an array of tests, collection groups, or a combination of these objects. |
test | Text | — | The name of the test to apply. |
subject | Boolean or Integer or Decimal or Text | — | The subject of this filter test. |
operator | Boolean or Integer or Decimal or Text | — | The comparison to apply with 'value'. |
domain | Boolean or Integer or Decimal or Text | — | The domain the test should be performed in. |
value | Boolean or Integer or Decimal or Text | — | The value being compared with the test. |
cooldown_time | Decimalmin 0 | 1 | Cooldown time, in seconds, between consecutive attacks. |
melee_fov | Decimalmin 0 | 90 | Field of view, in degrees, used by the hard-coded sensing component to detect a valid attack target. |
x_max_rotation | Decimalmin 0 | 30 | Maximum rotation, in degrees, on the X-axis while the mob is trying to look at its target. |
y_max_head_rotation | Decimalmin 0 | 30 | Maximum rotation, in degrees, on the Y-axis while the mob is trying to look at its target. |
random_stop_interval | Integermin 0 | 0 | Defines a 1-in-N chance for the mob to stop its current attack, where N equals "random_stop_interval". |
attack_once | Boolean | false | Allows the mob to perform this melee attack behavior only once during its lifetime. |
can_spread_on_fire | Boolean | false | Allows the mob, if on fire and empty handed, to ignite its target upon a successful attack. |
min_path_time | Decimalmin 0 | 0.2 | Minimum base time, in seconds, before recalculating a new attack path to the target (before increases are applied). |
max_path_time | Decimalmin 0 | 0.55 | Maximum base time, in seconds, before recalculating a new attack path to the target (before increases are applied). |
path_fail_time_increase | Decimalmin 0 | 0.75 | Time, in seconds, added to the attack path recalculation interval when the mob cannot move along the current path. |
inner_boundary_time_increase | Decimalmin 0 | 0.25 | Time, in seconds, added to the attack path recalculation interval when the target is beyond "path_inner_boundary". |
outer_boundary_time_increase | Decimalmin 0 | 0.5 | Time, in seconds, added to the attack path recalculation interval when the target is beyond "path_outer_boundary". |
path_inner_boundary | Decimalmin 0 | 16 | Distance at which to increase attack path recalculation by "inner_boundary_time_increase". |
path_outer_boundary | Decimalmin 0 | 32 | Distance at which to increase attack path recalculation by "outer_boundary_time_increase". |
speed_multiplier | Decimalmin 0 | 1 | Multiplier applied to the mob's movement speed when moving toward its target. |
require_complete_path | Boolean | false | Specifies whether a full navigation path from the mob to the target is required. |
track_target | Boolean | false | Allows the mob to track its target even if it lacks a hard-coded sensing component. |
attack_types | Text | "" | Defines the entity types this entity will attack. |
on_attack | Object | {"event": "", "filters": {"AND": null, "NOT": null, "OR":… | Defines the event to trigger when this entity successfully attacks. |
event | Text | "" | |
target | Textself, other, player, target, parent, baby, block, damager, holder, item | "self" | |
filters | Object or List of object | {"AND": null, "NOT": null, "OR": null, "all": null, "all_… | Filters allow data objects to specify test criteria which allows their use. Filters can be defined by a single object of type (Filter Test), an array of tests, collection groups, or a combination of these objects. |
test | Text | — | The name of the test to apply. |
subject | Boolean or Integer or Decimal or Text | — | The subject of this filter test. |
operator | Boolean or Integer or Decimal or Text | — | The comparison to apply with 'value'. |
domain | Boolean or Integer or Decimal or Text | — | The domain the test should be performed in. |
value | Boolean or Integer or Decimal or Text | — | The value being compared with the test. |
priority | Integermin 0 | 0 | |
control_flags | List of text | [] |
Example from the game files
This is how vanilla Creeper uses it in Minecraft Bedrock 1.26.60.5:
{
"minecraft:behavior.melee_attack": {
"reach_multiplier": 0,
"speed_multiplier": 1.25,
"priority": 4
}
}Used by 1
Vanilla entities with minecraft:behavior.melee_attack in their definition:
Related components
behavior.nearest_attackable_targetbehavior.melee_box_attackbehavior.ranged_attackbehavior.stomp_turtle_eggbehavior.leap_at_targetbehavior.nearest_prioritized_attackable_targetbehavior.aquatic_charge_attackbehavior.charge_held_itembehavior.guardian_attackbehavior.ocelotattackbehavior.slime_attackbehavior.charge_attackbehavior.delayed_attackbehavior.dragonchargeplayerbehavior.dragonflamingbehavior.dragonstrafeplayerbehavior.fire_at_targetbehavior.knockback_roarbehavior.ram_attackbehavior.roarbehavior.send_eventbehavior.sonic_boombehavior.stomp_attackbehavior.summon_entity