编辑

Entity Documentation - minecraft:breedable

Allows an entity to establish a way to get into the love state used for breeding.

Note

This component is commonly used in conjunction with the 'minecraft:behavior.breed' component.

Note

In 1.21.130 the transform_to_item field on each entry of breed_items was renamed to result_item. The new field is defined per-item, so different breed items can transform into different result items on use.

Note

In 1.26.0 the offspring-related fields were split out into the separate minecraft:offspring_data component. minecraft:breedable now contains only love-state, taming/health requirements, and pregnancy-flow data; the new minecraft:offspring_data component is required to actually spawn the child entity.

Breedable Properties

Name Default Value Type Description Example Values
allow_sitting false Boolean true/false If true, entities can breed while sitting
blend_attributes true Boolean true/false If true, the entities will blend their attributes in the offspring after they breed. For example, horses blend their health, movement, and jump_strength in their offspring.
breed_cooldown 60 Decimal number Time in seconds before the Entity can breed again.
breed_items not set Array of strings The list of items that can be used to get the entity into the 'love' state. Can be a single item or an array. Chicken: ["wheat_seeds","beetroot_seeds","melon_seeds","pumpkin_seeds","pitcher_pod","torchflower_seeds"], Cow: ["wheat"], Frog: ["slime_ball"]
breed_items (as String) not set String
breeds_with not set Array of Breeds With items The entity definitions that this entity can breed with. Can be a single object or an array. Chicken: {"minecraft:chicken":{}}, Cow: {"minecraft:cow":{}}, Frog: {"minecraft:frog":{"event":"become_pregnant","target":"self"}}
breeds_with (as Object) not set Breeds With (Breed With Single) item
causes_pregnancy false Boolean true/false If true, the entity will become pregnant instead of spawning a baby. Frog: true
combine_parent_colors false Boolean true/false If true and no color mutation occurs, the baby's minecraft:color is set to a blend of the parents' colors (following DyeItem combination rules).
deny_parents_variant not set Deny Parents Variant item Determines how likely the baby of parents with the same variant will deny that variant and take a random variant within the given range instead.
environment_requirements not set Array of Environment Requirements items The list of nearby block requirements to get the entity into the 'love' state.
extra_baby_chance 0 Percent Range Chance that up to 16 babies will spawn.
inherit_tamed not set Boolean true/false If true, the babies will be automatically tamed if its parents are.
love_filters not set Minecraft filter The filters to run when attempting to fall in love.
mutation_factor not set Mutation Factor item Determines how likely the babies are to NOT inherit one of their parent's variances.
require_full_health false Boolean true/false If true, the entity needs to be at full health before it can breed.
require_tame true Boolean true/false If true, the entities need to be tamed first before they can breed. Llama: true

combine_parent_colors

If true and no color mutation occurs, the baby's minecraft:color is set to a blend of the parents' colors (following DyeItem combination rules). If the parents' colors aren't compatible, the baby inherits one parent's color at random. This item requires a format version of at least 1.21.60.

Breeds With

Breeds With Properties

JSON path: breeds_with

Name Default Value Type Description
baby_type not set String The entity definition of this entity's babies.
breed_event not set String Event to run when this entity breeds. Can be a simple event name string or a trigger object with event and optional filters.
breed_event (as Object) not set Object
mate_type not set String from a list of choices The entity definition that this entity can mate with.

Breeds With (Breed With Single)

Same structure as Breeds With.

Deny Parents Variant

Deny Parents Variant Properties

JSON path: deny_parents_variant

Name Default Value Type Description
chance not set Decimal number The percentage chance of denying the parents' variant.
max_variant not set String The inclusive maximum of the variant range.
min_variant not set String The inclusive minimum of the variant range.

Environment Requirements

Environment Requirements Properties

JSON path: environment_requirements

Name Default Value Type Description
block_types not set Array of strings The block types required nearby for the entity to breed.
count not set Integer number The number of the required block types nearby for the entity to breed.
radius not set Decimal number How many blocks radius from the mob's center to search in for the required blocks. Bounded between 0 and 16.

Mutation Factor

Mutation Factor Properties

JSON path: mutation_factor

Name Default Value Type Description
color not set Percent Range The percentage chance of denying the parents' variant.
color (as Decimal number) not set Decimal number
extra_variant not set Percent Range The percentage chance of a mutation on the entity's extra variant type.
extra_variant (as Decimal number) not set Decimal number
variant not set Percent Range The percentage chance of a mutation on the entity's variant type.
variant (as Decimal number) not set Decimal number

Samples

Chicken

"minecraft:breedable": {
  "require_tame": false,
  "breeds_with": {
    "minecraft:chicken": {}
  },
  "breed_items": [
    "wheat_seeds",
    "beetroot_seeds",
    "melon_seeds",
    "pumpkin_seeds",
    "pitcher_pod",
    "torchflower_seeds"
  ]
}

Cow

"minecraft:breedable": {
  "require_tame": false,
  "breed_items": [
    "wheat"
  ],
  "breeds_with": {
    "minecraft:cow": {}
  }
}

Frog

"minecraft:breedable": {
  "breed_items": [
    "slime_ball"
  ],
  "breeds_with": {
    "minecraft:frog": {
      "event": "become_pregnant",
      "target": "self"
    }
  },
  "causes_pregnancy": true,
  "require_tame": false
}

Goat

"minecraft:breedable": {
  "require_tame": false,
  "breed_items": [
    "wheat"
  ],
  "breeds_with": {
    "minecraft:goat": {}
  }
}

Llama

"minecraft:breedable": {
  "require_tame": true,
  "breeds_with": {
    "minecraft:llama": {}
  },
  "breed_items": [
    "hay_block"
  ]
}