Entity Documentation - minecraft:behavior.move_to_water

Allows the mob to move back into water when on land.

Note

This behavior is used by aquatic and semi-aquatic mobs like axolotl, dolphin, and pregnant frogs. The entity will search for and move toward water blocks when on land.

Entity Move To Water Behavior Properties

Name	Default Value	Type	Description	Example Values
control_flags	[]	Control Flags choices
goal_radius	0.5	Decimal number	Distance in blocks within the mob considers it has reached the goal. This is the "wiggle room" to stop the AI from bouncing back and forth trying to reach a specific spot. Value must be > 0.	Frog: 1.5
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.	Dolphin: 1, Frog: 3
search_count	10	Integer number	The number of randomly selected blocks each tick that the mob will check within its search range and height for a valid block to move to.
search_height	1	Integer number	Height in blocks the mob will look for water to move towards Value must be > 0.	Dolphin: 5
search_range	0	Integer number	The distance in blocks it will look for water to move towards Value must be > 0.	Dolphin: 15, Frog: 20
speed_multiplier	1	Decimal number	Movement speed multiplier of the mob when using this goal.

search_count

The number of randomly selected blocks each tick that the mob will check within its search range and height for a valid block to move to. A value of 0 will have the mob check every block within range in one tick.

Control Flags choices

Value	Title	Description
jump	Jump
look	Look
move	Move

Samples

Dolphin

"minecraft:behavior.move_to_water": {
  "priority": 1,
  "search_range": 15,
  "search_height": 5
}

Frog

"minecraft:behavior.move_to_water": {
  "goal_radius": 1.5,
  "priority": 3,
  "search_height": 5,
  "search_range": 20
}