minecraft:behavior.melee_box_attack

Allows an entity to deal damage through a melee attack with reach calculations based on bounding boxes.

Properties

PropertyTypeDefaultWhat it does
horizontal_reachDecimalmin 00.8The attack reach of the mob will be a box with the size of the mobs bounds increased by this value in all horizontal directions.
on_killObject{"event": "", "filters": {"AND": null, "NOT": null, "OR":…Defines the event to trigger when this entity kills the target.
eventText""
targetTextself, other, player, target, parent, baby, block, damager, holder, item"self"
filtersObject 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.
testText—The name of the test to apply.
subjectBoolean or Integer or Decimal or Text—The subject of this filter test.
operatorBoolean or Integer or Decimal or Text—The comparison to apply with 'value'.
domainBoolean or Integer or Decimal or Text—The domain the test should be performed in.
valueBoolean or Integer or Decimal or Text—The value being compared with the test.
cooldown_timeDecimalmin 01Cooldown time, in seconds, between consecutive attacks.
melee_fovDecimalmin 090Field of view, in degrees, used by the hard-coded sensing component to detect a valid attack target.
x_max_rotationDecimalmin 030Maximum rotation, in degrees, on the X-axis while the mob is trying to look at its target.
y_max_head_rotationDecimalmin 030Maximum rotation, in degrees, on the Y-axis while the mob is trying to look at its target.
random_stop_intervalIntegermin 00Defines a 1-in-N chance for the mob to stop its current attack, where N equals "random_stop_interval".
attack_onceBooleanfalseAllows the mob to perform this melee attack behavior only once during its lifetime.
can_spread_on_fireBooleanfalseAllows the mob, if on fire and empty handed, to ignite its target upon a successful attack.
min_path_timeDecimalmin 00.2Minimum base time, in seconds, before recalculating a new attack path to the target (before increases are applied).
max_path_timeDecimalmin 00.55Maximum base time, in seconds, before recalculating a new attack path to the target (before increases are applied).
path_fail_time_increaseDecimalmin 00.75Time, in seconds, added to the attack path recalculation interval when the mob cannot move along the current path.
inner_boundary_time_increaseDecimalmin 00.25Time, in seconds, added to the attack path recalculation interval when the target is beyond "path_inner_boundary".
outer_boundary_time_increaseDecimalmin 00.5Time, in seconds, added to the attack path recalculation interval when the target is beyond "path_outer_boundary".
path_inner_boundaryDecimalmin 016Distance at which to increase attack path recalculation by "inner_boundary_time_increase".
path_outer_boundaryDecimalmin 032Distance at which to increase attack path recalculation by "outer_boundary_time_increase".
speed_multiplierDecimalmin 01Multiplier applied to the mob's movement speed when moving toward its target.
require_complete_pathBooleanfalseSpecifies whether a full navigation path from the mob to the target is required.
track_targetBooleanfalseAllows the mob to track its target even if it lacks a hard-coded sensing component.
attack_typesText""Defines the entity types this entity will attack.
on_attackObject{"event": "", "filters": {"AND": null, "NOT": null, "OR":…Defines the event to trigger when this entity successfully attacks.
eventText""
targetTextself, other, player, target, parent, baby, block, damager, holder, item"self"
filtersObject 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.
testText—The name of the test to apply.
subjectBoolean or Integer or Decimal or Text—The subject of this filter test.
operatorBoolean or Integer or Decimal or Text—The comparison to apply with 'value'.
domainBoolean or Integer or Decimal or Text—The domain the test should be performed in.
valueBoolean or Integer or Decimal or Text—The value being compared with the test.
priorityIntegermin 00
control_flagsList of text[]

Example from the game files

This is how vanilla Bee uses it in Minecraft Bedrock 1.26.60.5:

{
  "minecraft:behavior.melee_box_attack": {
    "priority": 2,
    "attack_once": true,
    "speed_multiplier": 1.4,
    "on_attack": {
      "event": "countdown_to_perish_event",
      "target": "self"
    }
  }
}

Used by 32

Vanilla entities with minecraft:behavior.melee_box_attack in their definition:

Related components