类 ItemDurabilityComponent实验性

表示物品耐久组件。当出现在物品上时，表示该物品可以在使用中受到损坏。 注意，只能在数驱物品上获取和使用该组件。

When present on an item, this item can take damage in the process of being used. Note that this component only applies to data-driven items.

示例: giveHurtDiamondSword.ts

import { world, ItemStack, EntityInventoryComponent, EntityComponentTypes, ItemComponentTypes, ItemDurabilityComponent, DimensionLocation } from "@minecraft/server";
import { MinecraftItemTypes } from "@minecraft/vanilla-data";

function giveHurtDiamondSword(
    targetLocation: DimensionLocation
) {
  const hurtDiamondSword = new ItemStack(MinecraftItemTypes.DiamondSword);

  const durabilityComponent = hurtDiamondSword.getComponent(ItemComponentTypes.Durability) as ItemDurabilityComponent;

  if (durabilityComponent !== undefined) {
    durabilityComponent.damage = durabilityComponent.maxDurability / 2;
  }

  for (const player of world.getAllPlayers()) {
    const inventory = player.getComponent(EntityComponentTypes.Inventory) as EntityInventoryComponent;
    if (inventory && inventory.container) {
      inventory.container.addItem(hurtDiamondSword);
    }
  }
}

层级 (查看层级一览)

属性

damage isValid maxDurability typeId componentId

方法

getDamageChance getDamageChanceRange

属性

实验性damage

damage: number

备注

此物品当前的损坏值。 物品当前耐久度为 maxDurability - damage。 当被设置为 负数，Infinity，NaN 等值时，值为 0。

Returns the current damage level of this particular item.

无法在只读模式下修改此属性，详见 WorldBeforeEvents。

只读 实验性isValid

isValid: boolean

备注

返回组件是否有效。若组件的拥有者有效，并且组件需要的任何 额外验证也通过，则该组件被认为是有效的。

Returns whether the component is valid. A component is considered valid if its owner is valid, in addition to any addition to any additional validation required by the component.

只读 实验性maxDurability

maxDurability: number

备注

表示该物品在损坏前可以承受的损坏值。

Represents the amount of damage that this item can take before breaking.

抛出

This property can throw when used.

只读 实验性typeId

typeId: string

备注

组件的标识符。 Identifier of the component.

静态 只读 实验性componentId

componentId: "minecraft:durability" = 'minecraft:durability'

方法

getDamageChance

  • getDamageChance(unbreakingEnchantmentLevel?: number): number
  • 实验性

    参数

    • 可选unbreakingEnchantmentLevel: number

      耐久魔咒等级，在计算损坏概率时受到此参数的影响。 传入的 unbreakingEnchantmentLevel 参数必须介于 [0, 3]。

      Unbreaking factor to consider in factoring the damage chance. Incoming unbreaking parameter must be within the range [0, 3].

    返回 number

    使用时的最大损坏概率。

    备注

    返回根据 damageRange 属性生成的最大损坏概率， 附带一个耐久附魔等级作为可选参数。

    Returns the maximum chance that this item would be damaged using the damageRange property, given an unbreaking enchantment level.

    无法在只读模式下调用此函数，详见 WorldBeforeEvents。

    抛出

    若 unbreakingEnchantmentLevel 参数未在范围内时，抛出 TypeError 。

getDamageChanceRange

  • getDamageChanceRange(): NumberRange
  • 实验性

    返回 NumberRange

    备注

    返回用于计算物品损失耐久的概率范围。最终物品损失耐久的概率将落在此范围中。

    A range of numbers that is used to calculate the damage chance for an item. The damage chance will fall within this range.

    无法在只读模式下调用此函数，详见 WorldBeforeEvents。

    抛出

    This function can throw errors.

显示设置

成员可见性

目录

属性
方法