minecraft:rideable

Determines whether this entity can be ridden. Allows specifying the different seat positions and amount.

Properties

PropertyTypeDefaultWhat it does
seat_countInteger1The number of entities that can ride this entity at the same time.
controlling_seatInteger0The 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_interactBooleantrueIf true, this entity can't be interacted with if the entity interacting with it is crouching.
pull_in_entitiesBooleanfalseIf 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_interactBooleanfalseIf true, this entity will be picked when looked at by the rider.
passenger_max_widthDecimal0The max width a mob can have to be a rider. A value of 0 ignores this parameter.
family_typesList of text[]List of entities that can ride this entity.
interact_textText""The text to display when the player can interact with the entity when playing with touch-screen controls.
dismount_modeTextdefault, 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_eventText""Event to execute on the owner entity when an entity starts riding it.
on_rider_exit_eventText""Event to execute on the owner entity when an entity stops riding it.
seatsList of object[]The list of positions and number of riders for each position for entities riding this entity.
positionList of decimal or Object[0, 0, 0]Position of this seat relative to this entity's position.
xDecimal0
yDecimal0
zDecimal0
min_rider_countInteger0Defines the minimum number of riders that need to be riding this entity before this seat can be used.
max_rider_countInteger—Defines the maximum number of riders that can be riding this entity for this seat to be valid.
rotate_rider_byText or Object or Decimal0Offset to rotate riders by.
lock_rider_rotationDecimal181Angle in degrees that a rider is allowed to rotate while riding this entity. Omit this property for no limit.
third_person_camera_radiusDecimal1 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_smoothingDecimal1 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:

Related components