This version moves crafting remainders to recipes and adds brewing recipes.

For a few more details regarding the split and future you can look at the roadmap to 1.21!

Changes

Assets

• Added four textures for the Brewing Stand recipe book filter button.
• Added four textures for the Brewing Stand recipe book alternatives overlay.

Items

• Added the optional attribute_modifiers field to the item.
  • Its value is the same as the list form of the minecraft:attribute_modifiers data component.
• Added the minecraft:before_death_holder item event.
• Added new item tags:
  • #minecraft:brewing_inputs, which is used for the accepted items for the Brewing Stand input slots.
  • #minecraft:mundane_potion_reagents, which is used to convert Water Bottles to Mundane Potions in a brewing recipe.

Item Behaviour Components

• Removed the following item behaviour components:
  • minecraft:attribute_modifiers
    • This has been replaced with the attribute_modifiers field on the item and entries should be moved there.

So if you had this:

{
  "behavior": {
    "minecraft:attribute_modifiers": [
      {
        "id": "example:tool.heavy",
        "type": "minecraft:gravity",
        "amount": 0.01,
        "operation": "add_value",
        "slot": "hand"
      }
    ]
  }
}

You now have to use this instead:

{
  "attribute_modifiers": [
    {
      "id": "example:tool.heavy",
      "type": "minecraft:gravity",
      "amount": 0.01,
      "operation": "add_value",
      "slot": "hand"
    }
  ]
}

• minecraft:life_saving
  • This has been replaced with the new minecraft:before_death_holder item event.
  • To replicate the previous behaviour, the minecraft:clear_status_effects and minecraft:add_status_effects actions can be used.
  • Note that this means that the minecraft:death_protection data component is unused as a result.
  • The reason this was moved to an item event is to support the newly added 'consume effects' from the minecraft:death_protection data component from vanilla in 1.21.3, which the action system accommodates for with even more possibilities.
• minecraft:recipe_remainder
  • This has been replaced by remainders in recipe ingredients directly and the new remainder field in the minecraft:fuel item behaviour component.
• minecraft:useable_on_fluid
  • This has been replaced in favour of passes in their respective behaviour components.

minecraft:consumable

• Moved the result_item field to remainder in minecraft:useable.

minecraft:entity

• Added an optional passes field, which is a list of strings that allows its user to place an entity given a certain context.
  • block: Allows the user to place the entity on a block.
  • fluid: Allows the user to place the entity on a fluid.
• Its default value is ["block"].

Example:

{
  "allow_item_data": true,
  "entity": {
    "type": "minecraft:pig"
  },
  "passes": [
    "block",
    "fluid"
  ]
}

minecraft:food

• Removed the effects field.
• This should now be applied with the minecraft:consume_item or minecraft:eat_item item event combined with predicates and the new minecraft:add_status_effects action.

So if you had this:

{
  "components": {
    "minecraft:food": {
      "effects": [
        {
          "effect": {
            "id": "minecraft:hunger",
            "duration": 600,
            "show_icon": true
          },
          "probability": 0.8
        }
      ],
      "nutrition": 4,
      "saturation": 0.8
    }
  }
}

You now have to use this instead:

{
  "components": {
    "minecraft:food": {
      "nutrition": 4,
      "saturation": 0.8
    }
  },
  "events": {
    "minecraft:consume_item": {
      "action": {
        "type": "minecraft:add_status_effects",
        "effects": [
          {
            "id": "minecraft:hunger",
            "duration": 600,
            "show_icon": true
          }
        ],
        "entity": "this"
      },
      "requirements": {
        "conditions": {
          "chance": 0.8,
          "condition": "minecraft:random_chance"
        },
        "context": {
          "entity": "this",
          "position": "this"
        }
      }
    }
  }
}

minecraft:fuel

• Added an optional remainder field, which is the item stack to leave when used as a fuel.
• This replaces the minecraft:recipe_remainder item behaviour that was used previously for this.

Example:

{
  "remainder": {
    "id": "minecraft:bucket",
    "count": 1
  },
  "ticks": 20000
}

minecraft:useable

• Added an optional remainder field, which is the item stack to leave when finished using, whether instantaneous or over a specified duration.

Example:

{
  "animation": "eat",
  "remainder": {
    "id": "minecraft:bowl",
    "count": 1
  },
  "ticks": {
    "type": "minecraft:constant",
    "amount": 32
  }
}

• Changed the way the use duration in the ticks field works:
• If not specified, the item will be used instantly instead of being used indefinitely.
• To reproduce the previous behaviour, use the new minecraft:indefinite use duration provider.
• This makes the field in the behaviour component the same as the data component in all cases.
• A positive integer can still be used as a direct usage of minecraft:constant.

So if you had this:

{
  "minecraft:useable": {
    "animation": "block"
  }
}

You now have to use this instead:

{
  "minecraft:useable": {
    "animation": "block",
    "ticks": {
      "type": "minecraft:indefinite"
    }
  }
}

Data Components

• Removed the following data components:
  • minecraft:immune_to_damage
    • This has been replaced by minecraft:damage_resistant from vanilla.
    • Entries are datafixed properly.

minecraft:use_duration

• You now no longer specify a ticks field, making it consistent with the way it is used in the minecraft:useable behaviour.

So if you had this:

{
  "ticks": {
    "type": "minecraft:constant",
    "amount": 32
  }
}

You now have to use this instead:

{
  "type": "minecraft:constant",
  "amount": 32
}

• You can no longer specify an empty map to specify an indefinite use duration and you must use the minecraft:indefinite use duration provider instead.

So if you had this:

{}

You must now use this:

{
  "type": "minecraft:indefinite"
}

• A positive integer can still be used as a direct usage of the minecraft:constant use duration provider.

minecraft:weapon_attack_damage

• When determining whether to add the base minecraft:attack_damage attribute or not, it now defaults to true instead of false and must be explicitly set by rules accordingly.

Use Durations

• Added the following use durations:
  • minecraft:indefinite

minecraft:indefinite

• Always uses the item indefinitely.
• Has no additional fields.

Actions

• Added the following actions:
  • minecraft:add_status_effects

minecraft:add_status_effects

• Adds status effects to an entity.
• The action is unsuccessful if the entity does not exist, is not a living entity or if no effect is added.
• Fields:
  • effects: A list of status effects. The effects to apply to the entity.
  • entity: An action context parameter. The entity to target.

Example:

{
  "type": "minecraft:add_status_effects",
  "effects": [
    {
      "id": "minecraft:regeneration",
      "amplifier": 1,
      "duration": 100,
      "show_icon": true
    },
    {
      "id": "minecraft:absorption",
      "duration": 2400,
      "show_icon": true
    }
  ],
  "entity": "this"
}

Recipes

• Added the following recipe types:
  • minecraft:brewing_amplify
  • minecraft:brewing_modify
• Added remainders to ingredients.
  • Replaces the minecraft:recipe_remainder item behaviour component.
  • The existing format still works.
  • Currently only in use for shaped and shapeless recipes.
  • Fields:
    • items: An ingredient entry or list of ingredient entries.
    • remainder: An optional item stack. The item stack to leave when the ingredient is consumed.

Example:

{
  "items": {
    "item": "minecraft:milk_bucket"
  },
  "remainder": {
    "id": "minecraft:bucket",
    "count": 1
  }
}

minecraft:brewing_amplify

• Transforms the item into another one after brewing.
• Format:
  • group: An optional string. Used to group recipes together.
  • base: An item. The item to transform.
  • reagent: An ingredient. The items to accept to modify the item.
  • result: An item. The item to transform into.
  • brewing_time: An optional positive integer. The number of ticks the recipe takes to complete.
    • Its default value is 400.
• A remainder may be specified for the reagent that is left in the slot or dropped in the world after brewing.

Example:

{
  "type": "minecraft:brewing_amplify",
  "reagent": {
    "items": {
      "item": "minecraft:dragon_breath"
    },
    "remainder": {
      "id": "minecraft:glass_bottle",
      "count": 1
    }
  },
  "base": "minecraft:splash_potion",
  "result": "minecraft:lingering_potion"
}

minecraft:brewing_modify

• Changes the potion present on the item into another one after brewing.
• Format:
  • group: An optional string. Used to group recipes together.
  • base: A potion. The potion to modify.
  • reagent: An ingredient. The items to accept to modify the potion.
  • result: A potion. The potion to leave.
• A remainder may be specified for the reagent that is left in the slot or dropped in the world after brewing.

Example:

{
  "type": "minecraft:brewing_modify",
  "reagent": {
    "item": "minecraft:sugar"
  },
  "base": "minecraft:awkward",
  "result": "minecraft:swiftness"
}