The very first release for multiple Minecraft versions! This version has a lot of changes regarding shooters.

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

Changes

Item Behaviour Components

minecraft:consumable

• Added a new optional field called has_consume_particles.
  • Its value is a boolean which determines whether particles are displayed when consuming the item.
  • It has a default value of true.
• Added a new optional field called sound.
  • Its value is a sound event and determines what sound to play when consuming the item.
  • If no sound is specified, it will not play any sound when consuming the item.

Example:

{
  "minecraft:consumable": {
    "has_consume_particles": false,
    "result_item": "minecraft:glass_bottle",
    "sound": "minecraft:item.honey_bottle.drink"
  }
}

minecraft:projectile

• Removed the damage field.
  • This data is now specified in the minecraft:shooter item behaviour component in the item_damage field.
• Removed the charged_speed field.
  • This data is now specified in the minecraft:shooter item behaviour component in the charged_power_rules field of a minecraft:chargeable shooter method.

minecraft:shooter

• Removed the chargeable field.
  • This behaviour is replaced with shooter methods.
• Added a new field called method.
  • Its value is a shooter method which determines what kind of shooter this item is.
  • See the shooter methods section for more information.
• Added a new field called item_damage.
  • Its value is an item damage provider and determines the damage to apply to the item stack when used to shoot.
  • Format:
    • rules: A list of item damage rules. Determines the damage to apply to the item stack. See the item damage rules section for more information.
    • default_damage: A non-negative integer. The default damage to apply.
  • This value can be changed for individual item stacks in the new minecraft:shooter_damage_rules data component.

Example:

{
  "minecraft:shooter": {
    "ammunition": "#minecraft:bow_ammunition",
    "held_ammunition": "#minecraft:crossbow_ammunition",
    "item_damage": {
      "default_damage": 1,
      "rules": [
        {
          "damage": 3,
          "items": "minecraft:firework_rocket"
        }
      ]
    },
    "method": {
      "type": "minecraft:chargeable",
      "charged_power_rules": {
        "default_power": 3.15,
        "rules": [
          {
            "items": "minecraft:firework_rocket",
            "power": 1.6
          }
        ]
      },
      "default_charge_time": 1.25,
      "default_charging_sounds": {
        "end": "minecraft:item.crossbow.loading_end",
        "mid": "minecraft:item.crossbow.loading_middle",
        "start": "minecraft:item.crossbow.loading_start"
      }
    },
    "range": 8
  }
}

Data Components

• Added the following data components:
  • minecraft:shooter_charged_power_rules
  • minecraft:shooter_damage_rules
  • minecraft:shooter_default_charge_time
  • minecraft:shooter_default_charging_sounds
  • minecraft:shooter_shoot_sound

minecraft:shooter_charged_power_rules

• Specified and used by the minecraft:chargeable shooter method in the minecraft:shooter item behaviour component.
• If removed, the charged shooter will not shoot any projectile.
• Format:
  • rules: A list of charged power rules. Determines the power to add to the projectile shot from the charged shooter by using the lowest amount picked from all projectiles. See the charged power rules section for more information.
  • default_power: A non-negative float. The default power to add.

Example:

{
  "default_power": 3.15,
  "rules": [
    {
      "items": "minecraft:firework_rocket",
      "power": 1.6
    }
  ]
}

minecraft:shooter_damage_rules

• Specified and used by the minecraft:shooter item behaviour component.
• If removed, the item stack will not be damaged.
• Format:
  • rules: A list of item damage rules. Determines the damage to apply to the item stack. See the item damage rules section for more information.
  • default_damage: A non-negative integer. The default damage to apply.

Example:

{
  "default_damage": 1,
  "rules": [
    {
      "damage": 3,
      "items": "minecraft:firework_rocket"
    }
  ]
}

minecraft:shooter_default_charge_time

• Specified and used by the minecraft:chargeable shooter method in the minecraft:shooter item behaviour component.
• If removed, the chargeable shooter will always use a charge time of 0 ticks (it charges instantly when used), regardless of its enchantments.
• The actual value used can be further modified by enchantments via the minecraft:crossbow_charge_time effect component.
• Its value is a non-negative float.

minecraft:shooter_default_charging_sounds

• Specified and used by the minecraft:chargeable shooter method in the minecraft:shooter item behaviour component.
• If removed, the chargeable shooter will not play any sounds by default.
• The actual value used can be further modified by enchantments via the minecraft:crossbow_charging_sounds effect component.
• Format:
  • start: An optional sound event. The sound to play when the chargeable shooter is 20% charged.
  • mid: An optional sound event. The sound to play when the chargeable shooter is 50% charged.
  • end: An optional sound event. The sound to play when the chargeable shooter is 100% charged.

Example:

{
  "end": "minecraft:item.crossbow.loading_end",
  "mid": "minecraft:item.crossbow.loading_middle",
  "start": "minecraft:item.crossbow.loading_start"
}

minecraft:shooter_shoot_sound

• Specified and used by the minecraft:direct shooter method in the minecraft:shooter item behaviour component.
• If removed, the direct shooter will not play a sound when used to shoot.
• Its value is a sound event.

Actions

minecraft:play_sound

• Made the category field optional.
  • If not specified, will try to use the sound category from this entity instead.
  • Now fails if no sound category was available.

Shooter Methods

A shooter method determines how a shooter item should behave.

• Format: A map with fields determined by the type in the type field.

minecraft:chargeable

• Charges projectiles before shooting them, like the Crossbow.
• Format:
  • default_charge_time: A non-negative float. The default charge time to use without enchantments. This value can be changed for individual item stacks in the new minecraft:shooter_default_charge_time data component.
  • default_charging_sounds: The same structure as the minecraft:shooter_default_charge_time data component. The default charge sounds to use without enchantments. This value can be changed for individual item stacks in the new minecraft:shooter_default_charging_sounds data component.
  • charged_power_rules: The same structure as the minecraft:shooter_charged_power_rules data component. Determines the power used for projectiles. This value can be changed for individual item stacks in the new minecraft:shooter_charged_power_rules data component.

Example:

{
  "type": "minecraft:chargeable",
  "charged_power_rules": {
    "default_power": 3.15,
    "rules": [
      {
        "items": "minecraft:firework_rocket",
        "power": 1.6
      }
    ]
  },
  "default_charge_time": 1.25,
  "default_charging_sounds": {
    "end": "minecraft:item.crossbow.loading_end",
    "mid": "minecraft:item.crossbow.loading_middle",
    "start": "minecraft:item.crossbow.loading_start"
  }
}

minecraft:direct

• Shoots projectiles immediately when used, like the Bow.
• Format:
  • shoot_sound: An optional sound event. The sound to play when shooting with the shooter. Its default value is "minecraft:entity.arrow.shoot". This value can be changed for individual item stacks in the new minecraft:shooter_shoot_sound data component.

Example:

{
  "type": "minecraft:direct"
}

Item Damage Rules

An item damage rule determines the damage to apply to the item stack when used to shoot.

Fields

• items: An item, list of items or hash-prefixed item tag. When specified, the item stack has to be one of the specified items in order for the rule to pass.
• damage: An optional non-negative integer. When specified, will be the damage applied to the item stack.

Example

{
  "damage": 3,
  "items": "minecraft:firework_rocket"
}

Charged Power Rules

A charged power rule determines the maximum power to apply to the charged projectiles when they are shot.

Fields

• items: An item, list of items or hash-prefixed item tag. When specified, the item stack has to be one of the specified items in order for the rule to pass.
• power: An optional non-negative float. When specified, will be the maximum power applied to the charged projectiles.

Example

{
  "items": "minecraft:firework_rocket",
  "power": 1.6
}

Fixes

• Multishot and Piercing don't work on Bows (#57)
• Infinity does not work on Crossbows (#58)
• Eating Beetroot Soup does not leave a Bowl (#61)
• Fixed shooter animations
• Fixed Books not working in Enchanting Tables
• Fixed Anvils accepting any enchantment, even if disallowed