Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Enables a mob to use kinetic weaponry by intermittently charging at its target and repositioning afterward.
Note
Lets a mob attack with an item carrying the minecraft:kinetic_weapon component by charging at the target, then repositioning between strikes.
Note
This item requires a format version of at least 1.21.130.
Entity Use Kinetic Weapon Behavior Properties
| Name | Default Value | Type | Description |
|---|---|---|---|
| approach_distance | 8 | Decimal number | The distance to the target within which the mob begins using its kinetic weapon. |
| attack_once | false | Boolean true/false | Allows the mob to perform this melee attack behavior only once during its lifetime. |
| attack_types | String | Defines the entity types this entity will attack. | |
| can_spread_on_fire | false | Boolean true/false | Allows the mob, if on fire and empty handed, to ignite its target upon a successful attack. |
| control_flags | [] | Control Flags choices | |
| cooldown_distance | {"max":8,"min":8} | Cooldown Distance item | The distance the mob retreats to after all of the item's "minecraft:kinetic_weapon" component's "max_duration" values have elapsed. |
| cooldown_speed_multiplier | 1 | Decimal number | Multiplier applied to the mob's movement speed while on cooldown. |
| cooldown_time | 1 | Decimal number | Cooldown time, in seconds, between consecutive attacks. |
| hijack_mount_navigation | false | Boolean true/false | Allows the mob to override its mount's navigation behavior with the logic defined by this goal. |
| inner_boundary_time_increase | 0.25 | Decimal number | Time, in seconds, added to the attack path recalculation interval when the target is beyond "path_inner_boundary". |
| max_path_time | 0.550000011920929 | Decimal number | Maximum base time, in seconds, before recalculating a new attack path to the target (before increases are applied). |
| melee_fov | 90 | Decimal number | Field of view, in degrees, used by the hard-coded sensing component to detect a valid attack target. |
| min_path_time | 0.20000000298023224 | Decimal number | Minimum base time, in seconds, before recalculating a new attack path to the target (before increases are applied). |
| on_attack | {"event":"","filters":{"AND":null,"NOT":null,"OR":null,"all":null,"all_of":null,"any":null,"any_of":null,"none_of":null},"target":"self"} | Attack item | Defines the event to trigger when this entity successfully attacks. |
| on_kill | {"event":"","filters":{"AND":null,"NOT":null,"OR":null,"all":null,"all_of":null,"any":null,"any_of":null,"none_of":null},"target":"self"} | Kill item | Defines the event to trigger when this entity kills the target. |
| outer_boundary_time_increase | 0.5 | Decimal number | Time, in seconds, added to the attack path recalculation interval when the target is beyond "path_outer_boundary". |
| path_fail_time_increase | 0.75 | Decimal number | Time, in seconds, added to the attack path recalculation interval when the mob cannot move along the current path. |
| path_inner_boundary | 16 | Decimal number | Distance at which to increase attack path recalculation by "inner_boundary_time_increase". |
| path_outer_boundary | 32 | Decimal number | Distance at which to increase attack path recalculation by "outer_boundary_time_increase". |
| priority | 0 | Integer number | |
| random_stop_interval | 0 | Integer number | Defines a 1-in-N chance for the mob to stop its current attack, where N equals "random_stop_interval". |
| reposition_distance | {"max":2,"min":2} | Reposition Distance item | The distance the mob retreats to once the target is closer than the midpoint of the item's "minecraft:kinetic_weapon" component's minimum and maximum "reach". |
| reposition_speed_multiplier | 1 | Decimal number | Multiplier applied to the mob's movement speed while repositioning. |
| require_complete_path | false | Boolean true/false | Specifies whether a full navigation path from the mob to the target is required. |
| speed_multiplier | 1 | Decimal number | Multiplier applied to the mob's movement speed when moving toward its target. |
| track_target | false | Boolean true/false | Allows the mob to track its target even if it lacks a hard-coded sensing component. |
| weapon_min_speed_multiplier | 1 | Decimal number | Multiplier applied to each "min_speed" and "min_relative_speed" condition in the item's "minecraft:kinetic_weapon" component. |
| weapon_reach_multiplier | 1 | Decimal number | Multiplier applied to the item's "minecraft:kinetic_weapon" component's "reach". |
| x_max_rotation | 30 | Decimal number | Maximum rotation, in degrees, on the X-axis while the mob is trying to look at its target. |
| y_max_head_rotation | 30 | Decimal number | Maximum rotation, in degrees, on the Y-axis while the mob is trying to look at its target. |
cooldown_distance
The distance the mob retreats to after all of the item's "minecraft:kinetic_weapon" component's "max_duration" values have elapsed. After reaching this position and once "cooldown" has elapsed, the mob will approach again. This value is added to the reach midpoint.
hijack_mount_navigation
Allows the mob to override its mount's navigation behavior with the logic defined by this goal. Requires the mount to be running the "minecraft:behavior.mount_pathing" goal, which default behavior will be ignored.
reposition_distance
The distance the mob retreats to once the target is closer than the midpoint of the item's "minecraft:kinetic_weapon" component's minimum and maximum "reach". After reaching this position, the mob will charge again. This value is added to the reach midpoint.
Control Flags choices
| Value | Title | Description |
|---|---|---|
| jump | Jump | |
| look | Look | |
| move | Move |
Legacy FloatRange
Legacy FloatRange Properties
JSON path: cooldown_distance
| Name | Default Value | Type | Description |
|---|---|---|---|
| max | 0 | Decimal number | |
| min | 0 | Decimal number |
Entity ActorDefinitionTrigger
Triggers an entity event when specified conditions are met. Events activate component groups that change entity behavior—transforming villagers into zombie villagers, switching mobs to aggressive mode, or triggering growth stages. Combine with filters to create conditional state machines that respond to gameplay.
Entity ActorDefinitionTrigger Properties
JSON path: on_attack
| Name | Default Value | Type | Description |
|---|---|---|---|
| event | String | ||
| filters (Filters) | {"AND":null,"NOT":null,"OR":null,"all":null,"all_of":null,"any":null,"any_of":null,"none_of":null} | Filters item | Filters allow data objects to specify test criteria which allows their use. |
| filters (Alternate 1) | not set | Object | |
| target | self | Target choices |
filters
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.
Filters
Filters Properties
JSON path: on_attack > filters
| Name | Default Value | Type | Description |
|---|---|---|---|
| domain | not set | Object | The domain the test should be performed in. |
| operator | not set | Object | The comparison to apply with 'value'. |
| subject | not set | Object | The subject of this filter test. |
| test | not set | String | The name of the test to apply. |
| value | not set | Object | The value being compared with the test. |
Target choices
| Value | Title | Description |
|---|---|---|
| baby | Baby | |
| block | Block | |
| damager | Damager | |
| holder | Holder | |
| item | Item | |
| other | Other | |
| parent | Parent | |
| player | Player | |
| self | Self | |
| target | Target |