Entity Documentation - minecraft:behavior.ranged_attack

Allows an entity to attack by using ranged shots. "charge_shoot_trigger" must be greater than 0 to enable charged up burst-shot attacks. Requires minecraft:shooter to define projectile behaviour.

Entity Ranged Attack Behavior Properties

Name	Default Value	Type	Description	Example Values
attack_interval	{"max":-1,"min":-1}	Attack Interval item	Reload-time range (in seconds), when not using a charged shot.	Blaze: `{"min":3,"max":5}`, Bogged: `3.5`, `2.5`
attack_interval_max	0	Decimal number	Maximum bound for reload-time range (in seconds), when not using a charged shot. Reload-time range scales with target-distance.
attack_interval_min	0	Decimal number	Minimum bound for reload-time range (in seconds), when not using a charged shot. Reload-time range scales with target-distance.
attack_radius	0	Decimal number	Minimum distance to target before this entity will attempt to shoot.	Bogged: `15`, Llama: `64`
attack_radius_min	0	Decimal number	Minimum distance the target can be for this mob to fire. If the target is closer, this mob will move first before firing
attack_range	{"max":0,"min":0}	Attack Range item	Range of distances from the target within which the entity can perform a ranged attack. Check that the limits imposed on the range (minimum, maximum and maximum distance between values) are respected	Blaze: `{"min":0,"max":48}`, Drowned: `{"min":0,"max":10}`
burst_interval	0	Decimal number	Time (in seconds) between each individual shot when firing a burst of shots from a charged up attack. Value must be > 0.	Blaze: `0.3`
burst_shots	1	Integer number	Number of shots fired every time the attacking entity uses a charged up attack.	Blaze: `3`
charge_charged_trigger	0	Decimal number	Time (in seconds, then add "charge_shoot_trigger"), before a charged up attack is done charging. Charge-time decays while target is not in sight. Value must be > 0.	Llama: `1`
charge_shoot_trigger	0	Decimal number	Amount of time (in seconds, then doubled) a charged shot must be charging before reloading burst shots. Charge-time decays while target is not in sight. Value must be > 0.	Blaze: `4`, Llama: `2`
control_flags	[]	Control Flags choices
in_range_movement_mode	hold_position	In Range Movement Mode choices	Controls how the entity moves while its target is within the configured attack range.
priority	0	Integer number	As priority approaches 0, the priority is increased. The higher the priority, the sooner this behavior will be executed as a goal.	Blaze: `3`, Llama: `2`, Parched: `1`
ranged_fov	90	Decimal number	Field of view (in degrees) when using sensing to detect a target for attack.
set_persistent	false	Boolean true/false	Allows the actor to be set to persist upon targeting a player
speed_multiplier	1	Decimal number	During attack behavior, this multiplier modifies the entity's speed when moving toward the target. Value must be > 0.
swing	false	Boolean true/false	If a swing animation (using variable.attack_time) exists, this causes the actor to swing their arm(s) upon firing the ranged attack.	Drowned: `true`
target_in_sight_time	1	Decimal number	Minimum amount of time (in seconds) the attacking entity needs to see the target before moving toward it. Value must be > 0.
x_max_rotation	30	Decimal number	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 number	Maximum rotation (in degrees), on the Y-axis, this entity can rotate its head while trying to look at the target.

attack_interval

Reload-time range (in seconds), when not using a charged shot. Reload-time range scales with target-distance. Check that the limits imposed on the range (minimum, maximum and maximum distance between values) are respected.

in_range_movement_mode

Controls how the entity moves while its target is within the configured attack range. "hold_position" makes the entity stop and hold its position while facing and attacking the target. "follow_target" makes the entity continue moving toward the target while attacking, stopping just outside the minimum attack range.

Legacy FloatRange

Legacy FloatRange Properties

JSON path: attack_interval

Name	Default Value	Type	Description
max	0	Decimal number
min	0	Decimal number

Control Flags choices

Value	Title	Description
jump	Jump
look	Look
move	Move

In Range Movement Mode choices

Value	Title	Description
follow_target	Follow target
hold_position	Hold position

Samples

Blaze

"minecraft:behavior.ranged_attack": {
  "charge_shoot_trigger": 4,
  "attack_interval": {
    "min": 3,
    "max": 5
  },
  "attack_range": {
    "min": 0,
    "max": 48
  },
  "burst_interval": 0.3,
  "burst_shots": 3,
  "priority": 3
}

Bogged

At /minecraft:entity/component_groups/minecraft:ranged_attack/minecraft:behavior.ranged_attack/:

"minecraft:behavior.ranged_attack": {
  "attack_interval": 3.5,
  "attack_radius": 15,
  "priority": 0
}

At /minecraft:entity/component_groups/minecraft:ranged_attack_hard/minecraft:behavior.ranged_attack/:

"minecraft:behavior.ranged_attack": {
  "attack_interval": 2.5,
  "attack_radius": 15,
  "priority": 0
}

Drowned

"minecraft:behavior.ranged_attack": {
  "attack_interval": {
    "min": 1,
    "max": 3
  },
  "attack_range": {
    "min": 0,
    "max": 10
  },
  "priority": 3,
  "swing": true
}

Llama

At /minecraft:entity/component_groups/minecraft:llama_angry/minecraft:behavior.ranged_attack/:

"minecraft:behavior.ranged_attack": {
  "priority": 2,
  "attack_radius": 64,
  "charge_shoot_trigger": 2,
  "charge_charged_trigger": 1
}

Parched