minecraft:rideable
Determines whether this entity can be ridden. Allows specifying the different seat positions and amount.
Properties
| Property | Type | Default | What it does |
|---|---|---|---|
seat_count | Integer | 1 | The number of entities that can ride this entity at the same time. |
controlling_seat | Integer | 0 | The seat that designates the driver of the entity. Entities with the "minecraft:behavior.controlled_by_player" goal ignore this field and give control to any player in any seat. |
crouching_skip_interact | Boolean | true | If true, this entity can't be interacted with if the entity interacting with it is crouching. |
pull_in_entities | Boolean | false | If true, this entity will pull entities matching the specified "family_types" into any available seats. Entities that are leashed will only be pulled in if their distance to their leash holder is less than the "hard_distance" defined in their own "minecraft:leashable" component. |
rider_can_interact | Boolean | false | If true, this entity will be picked when looked at by the rider. |
passenger_max_width | Decimal | 0 | The max width a mob can have to be a rider. A value of 0 ignores this parameter. |
family_types | List of text | [] | List of entities that can ride this entity. |
interact_text | Text | "" | The text to display when the player can interact with the entity when playing with touch-screen controls. |
dismount_mode | Textdefault, on_top_center, look_direction | "default" | Defines where riders are placed when dismounting this entity: - "default", riders are placed on a valid ground position around the entity, or at the center of the entity's collision box if none is found. - "on_top_center", riders are placed at the center of the top of the entity's collision box. - "look_direction", riders are placed at the center of the top neighboring block in the riders look direction on a block that is not lava. |
on_rider_enter_event | Text | "" | Event to execute on the owner entity when an entity starts riding it. |
on_rider_exit_event | Text | "" | Event to execute on the owner entity when an entity stops riding it. |
seats | List of object | [] | The list of positions and number of riders for each position for entities riding this entity. |
position | List of decimal or Object | [0, 0, 0] | Position of this seat relative to this entity's position. |
x | Decimal | 0 | |
y | Decimal | 0 | |
z | Decimal | 0 | |
min_rider_count | Integer | 0 | Defines the minimum number of riders that need to be riding this entity before this seat can be used. |
max_rider_count | Integer | — | Defines the maximum number of riders that can be riding this entity for this seat to be valid. |
rotate_rider_by | Text or Object or Decimal | 0 | Offset to rotate riders by. |
lock_rider_rotation | Decimal | 181 | Angle in degrees that a rider is allowed to rotate while riding this entity. Omit this property for no limit. |
third_person_camera_radius | Decimal1 to 64 | — | A different radius that the third_person and third_person_front cameras should use for the player is in this seat. Negative values are ignored. |
camera_relax_distance_smoothing | Decimal1 to 32 | — | When the camera relaxes to the full distance after being pushed by an obstacle, this value can override the default movement. This value describes the stiffness of the spring that pushes the camera back out. Negative values are ignored. |
Example from the game files
This is how vanilla Boat uses it in Minecraft Bedrock 1.26.60.5:
{
"minecraft:rideable": {
"interact_text": "action.interact.ride.boat",
"passenger_max_width": 1.375,
"seats": [
{
"lock_rider_rotation": 90,
"min_rider_count": 0,
"max_rider_count": 1,
"position": [
0.0,
-0.2,
0.0
],
"rotate_rider_by": -90
},
{
"lock_rider_rotation": 90,
"min_rider_count": 2,
"max_rider_count": 2,
"position": [
0.2,
-0.2,
0.0
],
"rotate_rider_by": "query.has_any_family('blaze', 'creeper', 'enderman', 'illager', 'magmacube', 'piglin', 'player', 'skeleton', 'slime', 'villager', 'wandering_trader', 'witch', 'zombie', 'zombie_pigman', 'happy_ghast') ? -90 : 0"
},
{
"lock_rider_rotation": 90,
"min_rider_count": 2,
"max_rider_count": 2,
"position": [
-0.6,
-0.2,
0.0
],
"rotate_rider_by": "query.has_any_family('blaze', 'creeper', 'enderman', 'illager', 'magmacube', 'piglin', 'player', 'skeleton', 'slime', 'villager', 'wandering_trader', 'witch', 'zombie', 'zombie_pigman', 'happy_ghast') ? -90 : 0"
}
],
"pull_in_entities": true,
"seat_count": 2
}
}Used by 36
Vanilla entities with minecraft:rideable in their definition: