Entity Movement

In Minecraft, entities have the ability to move through the world, either by walking, swimming or flying. To get these behaviors, your entity will generally need quite a few behaviors, broken out into various types.

As you read this tutorial, keep in mind that your entity will need at least:


The best way to create a moving entity is by picking a similar entity from the vanilla behavior pack, and copying the components into your entity.

For example entities like Phantom, or Ghast, or Parrot are all flying entities, but have very different in-game behavior! Use the closest-matching entity as a template.

Movement Speed

The first thing your entity needs is a speed component. This sets how quickly your entity will move through the world.

minecraft:movementSet movement speed (required)
minecraft:underwater_movementSet movement speed in the water.
minecraft:flying_speedSet the speed in the air.

You should always include minecraft:movement. Add the other two as needed.

All vanilla "swimming" entities like Dolphin include underwater_movement. Only some flying entities have flying_speed. It is not known why this is the case.

Movement Type

Your entity will also need a movement type. Movement types set hard-coded behavior for how your entity will move through the world.

You may only include one movement type in your entity. Select the component that most closely matches your needs. Generally basic, amphibious and fly are good ones to use.

minecraft:movement.amphibiousThis move control allows the mob to swim in the water and walk on land.
minecraft:movement.basicThis component accents the movement of an entity.
minecraft:movement.flyThis move control causes the mob to fly.
minecraft:movement.genericThis move control allows a mob to fly, swim, climb, etc.
minecraft:movement.hoverThis move control causes the mob to hover.
minecraft:movement.jumpMove control causes the mob to jump as it moves with a specified delay between jumps.
minecraft:movement.skipThis move control causes the mob to hop as it moves.
minecraft:movement.swayThis move control causes the mob to sway side to side, giving the impression it is swimming.

Movement Modifiers

Movement modifiers provide additional information about how your entity will move through the world. These components are not required for normal entities, but you should be aware of them.

minecraft:water_movementSets the friction the entity experiences in water.
minecraft:rail_movementSets that the entity can move on rails (only).
minecraft:friction_modifierSets the friction the entity experiences on land.

The next thing your entity needs is a navigation component. Navigation components have quite a few fields, like whether the entity can open doors or avoid sunlight. How you set these fields is generally more important than the navigation component you pick!

The reason there are so many navigation components is that each one gives a slightly different hard-coded behavior. Pick the navigation component whose name/description best matches the kind of navigation your entity will be doing.

You can only have one navigation component at any given time.


This component is very important. You should check vanilla examples for inspiration on what fields and values to use.

minecraft:navigation.climbAllows this entity to generate paths that include vertical walls like the vanilla Spiders do.
minecraft:navigation.floatAllows this entity to generate paths by flying around the air like the regular Ghast.
minecraft:navigation.genericAllows this entity to generate paths by walking, swimming, flying and climbing around, and jumping up and down a block.
minecraft:navigation.flyAllows this entity to generate paths in the air as the vanilla Parrots do.
minecraft:navigation.swimAllows this entity to generate paths that include water.
minecraft:navigation.walkAllows this entity to generate paths by walking around and jumping up and down a block like regular mobs.

On top of the movement and the navigation component, there exist many additional components to augment the abilities of your entity as they move through the world.

minecraft:annotation.break_doorAllows entity to break doors. It must also be turned on in the navigation component.
minecraft:annotation.open_doorAllows entity to open doors. It must also be turned on in the navigation component.
minecraft:buoyantSpecifies which liquids the entity can float in.
minecraft:can_climbAllows this entity to climb up ladders.
minecraft:can_flyMarks the entity as being able to fly. The pathfinder won't be restricted to paths where a solid block is required underneath it.
minecraft:can_power_jumpAllows the entity to power jump like the horse does in vanilla.
minecraft:floats_in_liquidSets that this entity can float in liquid blocks.
minecraft:jump.dynamicDefines a dynamic type jump control that will change jump properties based on the speed modifier of the mob.
minecraft:jump.staticGives the entity the ability to jump.

There are also components like minecraft:preferred_path, which will modify navigation based on block-based path-cost.

AI Goals

The navigation component tells the entity how to generate paths, but it doesn't say when or where to generate paths. This is what the AI components are for.

AI Goals are prefixed with behavior and follow a priority system to pick which behavior to run. The lower priorities will be picked first.

In general, you should usually add quite a few AI components, with different priorities. Layered together, these will create realistic movement and behavior for your entity. As always, vanilla entities provide a good template for which components to add, and with what properties/priorities.

There are too many AI components that generate paths to list in this document. A few will be provided as examples:


For a full list, visit bedrock.dev.