Edit

Share via


Entity Documentation - 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.

Note

Requires the following components in order to work properly:

Explore Outskirts Behavior Properties

Name Default Value Type Description Example Values
dist_from_boundary [5, 0, 5] x, y, z coordinate array The distance from the boundary the villager must be within in to explore the outskirts. Villager v2: [5,0,5]
explore_dist 5 Decimal number Total distance in blocks the the entity will explore beyond the village bounds when choosing its travel point. Villager v2: 6
max_travel_time 60 Decimal number 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. Villager v2: 60
max_wait_time 0 Decimal number 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. Villager v2: 10
min_dist_from_target 2.2 Decimal number The entity must be within this distance for it to consider it has successfully reached its target. Villager v2: 2.5
min_perimeter 1 Decimal number The minimum perimeter of the village required to run this goal. Villager v2: 1
min_wait_time 3 Decimal number 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. Villager v2: 3
next_xz 5 Integer number 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. Villager v2: 5
next_y 3 Integer number 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. Villager v2: 3
priority not set Integer number As priority approaches 0, the priority is increased. The higher the priority, the sooner this behavior will be executed as a goal. Villager v2: 9
speed_multiplier 1 Decimal number The multiplier for speed while using this goal. 1.0 maintains the speed. Villager v2: 0.6
timer_ratio 2 Decimal number 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. Villager v2: 2

Samples

Villager v2

At /minecraft:entity/component_groups/job_specific_goals/minecraft:behavior.explore_outskirts/:

"minecraft:behavior.explore_outskirts": {}

At /minecraft:entity/component_groups/wander_schedule_villager/minecraft:behavior.explore_outskirts/:

"minecraft:behavior.explore_outskirts": {
  "priority": 9,
  "next_xz": 5,
  "next_y": 3,
  "min_wait_time": 3,
  "max_wait_time": 10,
  "max_travel_time": 60,
  "speed_multiplier": 0.6,
  "explore_dist": 6,
  "min_perimeter": 1,
  "min_dist_from_target": 2.5,
  "timer_ratio": 2,
  "dist_from_boundary": [
    5,
    0,
    5
  ]
}