minecraft:healable

Defines the interactions with this entity for healing it.

Properties

PropertyTypeDefaultWhat it does
itemsList of object[]The array of items that can be used to heal this entity.
itemText or Object—Item identifier that can be used to heal this entity.
result_itemText or Object—The feed item used will transform to this item upon successful interaction.
heal_amountInteger1The amount of health this entity gains when fed this item.
effectsList of object[]The effects to apply when this item is used to heal the entity.
nameText""The name of the effect to apply.
durationDecimal or Text0The duration of the effect in seconds, or "infinite".
amplifierInteger1The amplifier of the effect.
chanceDecimal1The chance that the effect is applied.
force_useBooleanfalseDetermines if item can be used regardless of entity being at full health.
filtersObject or List of object{"AND": null, "NOT": null, "OR": null, "all": null, "all_…The filter group that defines the conditions for using this item to heal the entity.
testText—The name of the test to apply.
subjectBoolean or Integer or Decimal or Text—The subject of this filter test.
operatorBoolean or Integer or Decimal or Text—The comparison to apply with 'value'.
domainBoolean or Integer or Decimal or Text—The domain the test should be performed in.
valueBoolean or Integer or Decimal or Text—The value being compared with the test.

Example from the game files

This is how vanilla Nautilus uses it in Minecraft Bedrock 1.26.60.5:

{
  "minecraft:healable": {
    "items": [
      {
        "item": "pufferfish_bucket",
        "result_item": "water_bucket:0",
        "heal_amount": 2
      },
      {
        "item": "cod_bucket",
        "result_item": "water_bucket:0",
        "heal_amount": 4
      },
      {
        "item": "salmon_bucket",
        "result_item": "water_bucket:0",
        "heal_amount": 4
      },
      {
        "item": "tropical_fish_bucket",
        "result_item": "water_bucket:0",
        "heal_amount": 2
      },
      {
        "item": "fish",
        "heal_amount": 4
      },
      {
        "item": "salmon",
        "heal_amount": 4
      },
      {
        "item": "clownfish",
        "heal_amount": 2
      },
      {
        "item": "pufferfish",
        "heal_amount": 2
      },
      {
        "item": "cooked_fish",
        "heal_amount": 10
      },
      {
        "item": "cooked_salmon",
        "heal_amount": 12
      }
    ]
  }
}

Used by 14

Vanilla entities with minecraft:healable in their definition:

Related components