minecraft:behavior.explore_outskirts
Allows the entity to first travel to a random point on the outskirts of the village, and then explore random points within a small distance. This goal requires "minecraft:dweller" and "minecraft:navigation" to execute.
Properties
| Property | Type | Default | What it does |
|---|---|---|---|
next_xz | Integer | 5 | A new explore point will randomly be chosen within this XZ distance of the current target position when navigation has finished and the wait timer has elapsed. |
next_y | Integer | 3 | A new explore point will randomly be chosen within this Y distance of the current target position when navigation has finished and the wait timer has elapsed. |
min_wait_time | Decimal | 3 | The wait time in seconds between choosing new explore points will be chosen on a random interval between this value and the maximum wait time. |
max_wait_time | Decimal | 0 | The wait time in seconds between choosing new explore points will be chosen on a random interval between this value and the minimum wait time. This value is also the total amount of time the entity will explore random points before the goal stops. |
max_travel_time | Decimal | 60 | This is the maximum amount of time an entity will attempt to reach it's travel point on the outskirts of the village before the goal exits. |
speed_multiplier | Decimal | 1 | The multiplier for speed while using this goal. 1.0 maintains the speed. |
explore_dist | Decimal | 5 | Total distance in blocks the the entity will explore beyond the village bounds when choosing its travel point. |
min_perimeter | Decimal | 1 | The minimum perimeter of the village required to run this goal. |
min_dist_from_target | Decimal | 2.25 | The entity must be within this distance for it to consider it has successfully reached its target. |
timer_ratio | Decimal | 2 | Each new explore point will be chosen on a random interval between the minimum and the maximum wait time, divided by this value. This does not apply to the first explore point chosen when the goal runs. |
dist_from_boundary | List of decimal or Object | [5, 0, 5] | The distance from the boundary the villager must be within in to explore the outskirts. |
x | Decimal | 0 | |
y | Decimal | 0 | |
z | Decimal | 0 | |
priority | Integermin 0 | 0 | |
control_flags | List of text | [] |
Example from the game files
This is how vanilla Villager uses it in Minecraft Bedrock 1.26.60.5:
{
"minecraft:behavior.explore_outskirts": {
"max_wait_time": 10,
"speed_multiplier": 0.6,
"explore_dist": 6,
"min_dist_from_target": 2.5,
"priority": 9
}
}Used by 1
Vanilla entities with minecraft:behavior.explore_outskirts in their definition:
Related components
behavior.floatbehavior.random_swimbehavior.swim_idlebehavior.swim_wanderbehavior.use_kinetic_weaponbehavior.move_to_waterbehavior.teleport_to_ownerbehavior.float_wanderbehavior.go_homebehavior.random_hoverbehavior.slime_floatbehavior.slime_keep_on_jumpingbehavior.slime_random_directionbehavior.move_to_landbehavior.move_to_random_blockbehavior.circle_around_anchorbehavior.dragonholdingpatternbehavior.dragonlandingbehavior.dragontakeoffbehavior.find_underwater_treasurebehavior.move_to_blockbehavior.move_to_liquidbehavior.random_breachbehavior.random_fly