Entity Documentation - minecraft:rideable

This entity can be ridden.

Rideable Properties

Name Default Value Type Description Example Values
controlling_seat 0 Integer number 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 true Boolean true/false If true, this entity can't be interacted with if the entity interacting with it is crouching. Camel: true
dismount_mode default Dismount Mode choices 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.
Happy Ghast: "on_top_center"
family_types not set Array of strings List of entities that can ride this entity. Camel: ["player"], Cat: ["zombie"], Donkey: ["player","zombie"]
interact_text not set String The text to display when the player can interact with the entity when playing with touch-screen controls. Camel: "action.interact.ride.horse", Donkey: "action.interact.mount", Minecart: "action.interact.ride.minecart"
on_rider_enter_event not set Minecraft Event Reference Event to execute on the owner entity when an entity starts riding it. Happy Ghast: "minecraft:on_passenger_mount"
on_rider_exit_event not set Minecraft Event Reference Event to execute on the owner entity when an entity stops riding it. Happy Ghast: "minecraft:on_passenger_dismount"
passenger_max_width 0 Decimal number The max width a mob can have to be a rider. A value of 0 ignores this parameter.
priority not set Integer number This field may exist in old data but isn't used by "minecraft:rideable".
pull_in_entities false Boolean true/false If true, this entity will pull in entities that are in the correct "family_types" into any available seats. Camel: true
rider_can_interact false Boolean true/false If true, this entity will be picked when looked at by the rider.
seat_count 1 Integer number The number of entities that can ride this entity at the same time. Camel: 2, Cat: 1, Happy Ghast: 4
seats not set Array of Seats items The list of positions and number of riders for each position for entities riding this entity. Camel: [{"min_rider_count":0,"max_rider_count":2,"position":[0,1.905,0.5]},{"min_rider_count":1,"max_rider_count":2,"position":[0,1.905,-0.5]}], Cat: {"position":[0,0.35,0]}, Chicken: {"position":[0,0.48,0]}
(deprecated) pulls_in_entities not set Boolean true/false

Dismount Mode choices

Value Title Description
default Default
on_top_center On Top Center

Seats item type

The list of positions and number of riders for each position for entities riding this entity.

Seats Properties

Name Default Value Type Description Example Values
camera_relax_distance_smoothing not set Decimal number
lock_rider_rotation 181 Decimal number Angle in degrees that a rider is allowed to rotate while riding this entity. Omit this property for no limit.
max_rider_count 0 Integer number Defines the maximum number of riders that can be riding this entity for this seat to be valid.
min_rider_count 0 Integer number Defines the minimum number of riders that need to be riding this entity before this seat can be used.
position [0, 0, 0] x, y, z coordinate array Position of this seat relative to this entity's position.
rotate_rider_by 0 String Offset to rotate riders by.
third_person_camera_radius not set Decimal number

Samples

Camel

"minecraft:rideable": {
  "seat_count": 2,
  "crouching_skip_interact": true,
  "pull_in_entities": true,
  "family_types": [
    "player"
  ],
  "interact_text": "action.interact.ride.horse",
  "seats": [
    {
      "min_rider_count": 0,
      "max_rider_count": 2,
      "position": [
        0,
        1.905,
        0.5
      ]
    },
    {
      "min_rider_count": 1,
      "max_rider_count": 2,
      "position": [
        0,
        1.905,
        -0.5
      ]
    }
  ]
}

Cat

"minecraft:rideable": {
  "seat_count": 1,
  "family_types": [
    "zombie"
  ],
  "seats": {
    "position": [
      0,
      0.35,
      0
    ]
  }
}

Chicken

"minecraft:rideable": {
  "seat_count": 1,
  "family_types": [
    "zombie"
  ],
  "seats": {
    "position": [
      0,
      0.48,
      0
    ]
  }
}

Cow

At /minecraft:entity/component_groups/minecraft:cow_baby/minecraft:rideable/:

"minecraft:rideable": {
  "seat_count": 1,
  "family_types": [
    "zombie"
  ],
  "seats": {
    "position": [
      0,
      1,
      0
    ]
  }
}

At /minecraft:entity/component_groups/minecraft:cow_adult/minecraft:rideable/:

"minecraft:rideable": {
  "seat_count": 1,
  "family_types": [
    "zombie"
  ],
  "seats": {
    "position": [
      0,
      1.15,
      0
    ]
  }
}

Donkey

At /minecraft:entity/component_groups/minecraft:donkey_wild/minecraft:rideable/:

"minecraft:rideable": {
  "seat_count": 1,
  "family_types": [
    "player",
    "zombie"
  ],
  "interact_text": "action.interact.mount",
  "seats": {
    "position": [
      0,
      0.925,
      -0.2
    ]
  }
}

At /minecraft:entity/component_groups/minecraft:donkey_tamed/minecraft:rideable/:

"minecraft:rideable": {
  "seat_count": 1,
  "crouching_skip_interact": true,
  "family_types": [
    "player"
  ],
  "interact_text": "action.interact.ride.horse",
  "seats": {
    "position": [
      0,
      0.925,
      -0.2
    ]
  }
}

Happy Ghast

"minecraft:rideable": {
  "seat_count": 4,
  "family_types": [
    "player"
  ],
  "dismount_mode": "on_top_center",
  "on_rider_enter_event": "minecraft:on_passenger_mount",
  "on_rider_exit_event": "minecraft:on_passenger_dismount",
  "interact_text": "action.interact.ride.horse",
  "seats": [
    {
      "min_rider_count": 0,
      "max_rider_count": 4,
      "position": [
        0,
        3.8,
        1.7
      ],
      "third_person_camera_radius": 8,
      "camera_relax_distance_smoothing": 6
    },
    {
      "min_rider_count": 1,
      "max_rider_count": 4,
      "position": [
        -1.7,
        3.8,
        0
      ],
      "third_person_camera_radius": 8,
      "camera_relax_distance_smoothing": 6
    },
    {
      "min_rider_count": 2,
      "max_rider_count": 4,
      "position": [
        0,
        3.8,
        -1.7
      ],
      "third_person_camera_radius": 8,
      "camera_relax_distance_smoothing": 6
    },
    {
      "min_rider_count": 3,
      "max_rider_count": 4,
      "position": [
        1.7,
        3.8,
        0
      ],
      "third_person_camera_radius": 8,
      "camera_relax_distance_smoothing": 6
    }
  ]
}

Hoglin

"minecraft:rideable": {
  "seat_count": 3,
  "family_types": [
    "piglin"
  ],
  "seats": [
    {
      "position": [
        0,
        1.125,
        -0.3
      ],
      "lock_rider_rotation": 0
    },
    {
      "position": [
        0,
        2.625,
        -0.3
      ],
      "lock_rider_rotation": 0
    },
    {
      "position": [
        0,
        4.125,
        -0.3
      ],
      "lock_rider_rotation": 0
    }
  ]
}

Horse

At /minecraft:entity/component_groups/minecraft:horse_wild/minecraft:rideable/:

"minecraft:rideable": {
  "seat_count": 1,
  "family_types": [
    "player",
    "zombie"
  ],
  "interact_text": "action.interact.mount",
  "seats": {
    "position": [
      0,
      1.1,
      -0.2
    ]
  }
}

At /minecraft:entity/component_groups/minecraft:horse_tamed/minecraft:rideable/:

"minecraft:rideable": {
  "seat_count": 1,
  "crouching_skip_interact": true,
  "family_types": [
    "player"
  ],
  "interact_text": "action.interact.ride.horse",
  "seats": {
    "position": [
      0,
      1.1,
      -0.2
    ]
  }
}

Husk

"minecraft:rideable": {
  "seat_count": 1,
  "family_types": [
    "zombie"
  ],
  "seats": {
    "position": [
      0,
      1.175,
      -0.35
    ],
    "lock_rider_rotation": 0
  }
}