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:
- A component that sets the entities movement speed.
- A component to set how the entity will move (walking, flying, etc)
- A component to set the entities navigation abilities, so it can generate paths.
- A component that sets where/when the entity should move (AI Goals).
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.
The first thing your entity needs is a speed component. This sets how quickly your entity will move through the world.
|minecraft:movement||Set movement speed (required)|
|minecraft:underwater_movement||Set movement speed in the water.|
|minecraft:flying_speed||Set 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.
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
fly are good ones to use.
|minecraft:movement.amphibious||This move control allows the mob to swim in the water and walk on land.|
|minecraft:movement.basic||This component accents the movement of an entity.|
|minecraft:movement.fly||This move control causes the mob to fly.|
|minecraft:movement.generic||This move control allows a mob to fly, swim, climb, etc.|
|minecraft:movement.hover||This move control causes the mob to hover.|
|minecraft:movement.jump||Move control causes the mob to jump as it moves with a specified delay between jumps.|
|minecraft:movement.skip||This move control causes the mob to hop as it moves.|
|minecraft:movement.sway||This move control causes the mob to sway side to side, giving the impression it is swimming.|
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_movement||Sets the friction the entity experiences in water.|
|minecraft:rail_movement||Sets that the entity can move on rails (only).|
|minecraft:friction_modifier||Sets 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.climb||Allows this entity to generate paths that include vertical walls like the vanilla Spiders do.|
|minecraft:navigation.float||Allows this entity to generate paths by flying around the air like the regular Ghast.|
|minecraft:navigation.generic||Allows this entity to generate paths by walking, swimming, flying and climbing around, and jumping up and down a block.|
|minecraft:navigation.fly||Allows this entity to generate paths in the air as the vanilla Parrots do.|
|minecraft:navigation.swim||Allows this entity to generate paths that include water.|
|minecraft:navigation.walk||Allows 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_door||Allows entity to break doors. It must also be turned on in the navigation component.|
|minecraft:annotation.open_door||Allows entity to open doors. It must also be turned on in the navigation component.|
|minecraft:buoyant||Specifies which liquids the entity can float in.|
|minecraft:can_climb||Allows this entity to climb up ladders.|
|minecraft:can_fly||Marks 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_jump||Allows the entity to power jump like the horse does in vanilla.|
|minecraft:floats_in_liquid||Sets that this entity can float in liquid blocks.|
|minecraft:jump.dynamic||Defines a dynamic type jump control that will change jump properties based on the speed modifier of the mob.|
|minecraft:jump.static||Gives the entity the ability to jump.|
There are also components like
minecraft:preferred_path, which will modify navigation based on block-based path-cost.
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.