Entity Documentation - minecraft:behavior.melee_attack

minecraft:behavior.melee_attack compels entities to make close combat melee attacks.

Important

In order for the entity to be able to attack its target, the entity will also need another component that sets its target, such as:

Parameters

Name Default Value Type Description
attack_once false Boolean Allows the entity to use this attack behavior, only once EVER.
attack_types N/A String Defines the entity types this entity will attack.
cooldown_time 1 Decimal Cooldown time (in seconds) between attacks.
inner_boundary_time_increase 0.25 Decimal Time (in seconds) to add to attack path recalculation when the target is beyond the "path_inner_boundary".
max_dist N/A Decimal Unused. No effect on "minecraft:behavior.melee_attack".
max_path_time 0.55 Decimal Maximum base time (in seconds) to recalculate new attack path to target (before increases applied).
melee_fov 90 Decimal Field of view (in degrees) when using the sensing component to detect an attack target.
min_path_time 0.2 Decimal Minimum base time (in seconds) to recalculate new attack path to target (before increases applied).
on_attack N/A Trigger Defines the event to trigger when this entity successfully attacks.
on_kill N/A Trigger Defines the event to trigger when this entity successfully kills.
outer_boundary_time_increase 0.5 Decimal Time (in seconds) to add to attack path recalculation when the target is beyond the "path_outer_boundary".
path_fail_time_increase 0.75 Decimal Time (in seconds) to add to attack path recalculation when this entity cannot move along the current path.
path_inner_boundary 16 Decimal Distance at which to increase attack path recalculation by "inner_boundary_tick_increase".
path_outer_boundary 32 Decimal Distance at which to increase attack path recalculation by "outer_boundary_tick_increase".
priority not set Integer The higher the priority, the sooner this behavior will be executed as a goal.
random_stop_interval 0 Integer This entity will have a 1 in N chance to stop it's current attack, where N = "random_stop_interval".
reach_multiplier 2 Decimal Used with the base size of the entity to determine minimum target-distance before trying to deal attack damage.
require_complete_path false Boolean Toggles (on/off) the need to have a full path from the entity to the target when using this melee attack behavior.
set_persistent false Boolean Allows the entity to be set to persist upon targeting a player
speed_multiplier 1 Decimal This multiplier modifies the attacking entity's speed when moving toward the target.
target_dist N/a Decimal Unused. No effect on "minecraft:behavior.melee_attack".
track_target false Boolean Allows the entity to track the attack target, even if the entity has no sensing.
x_max_rotation 30 Decimal Maximum rotation (in degrees), on the X-axis, this entity can rotate while trying to look at the target.
y_max_head_rotation 30 Decimal Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.

Example

"minecraft:behavior.melee_attack":{
    "priority":3,
 "melee_fov":90,
 "speed_multiplier":1,
 "track_target":false,
 "attack_types":"minecraft:sheep",
 "reach_multiplier":2,
 "attack_once":false
}

Vanilla mob examples

Zombie

"minecraft:behavior.melee_attack": {
    "priority": 3
}

Cave Spider

"minecraft:behavior.melee_attack": {
    "priority": 3,
    "track_target": true,
    "random_stop_interval": 100,
    "reach_multiplier": 0.8
}

Vanilla mobs using melee_attack