minecraft:behavior.random_swim

Allows an entity to randomly move through water

Properties

PropertyTypeDefaultWhat it does
avoid_surfaceBooleantrueIf true, the mob will avoid surface water blocks by swimming below them
speed_multiplierDecimal1Movement speed multiplier of the mob when using this AI Goal
xz_distInteger10Distance in blocks on ground that the mob will look for a new spot to move to. Must be at least 1
y_distInteger7Distance in blocks that the mob will look up or down for a new spot to move to. Must be at least 1
intervalInteger120A random value to determine when to randomly move somewhere. This has a 1/interval chance to choose this goal
priorityIntegermin 00
control_flagsList of text[]

Example from the game files

This is how vanilla Nautilus uses it in Minecraft Bedrock 1.26.60.5:

{
  "minecraft:behavior.random_swim": {
    "priority": 6,
    "speed_multiplier": 1.5,
    "xz_dist": 16,
    "y_dist": 4,
    "interval": 0
  }
}

Used by 12

Vanilla entities with minecraft:behavior.random_swim in their definition:

Related components