类 EntityEquippableComponent实验性

Provides access to a mob's equipment slots. This component exists for all mob entities.

示例: givePlayerElytra.ts

// Gives the player Elytra
import { EquipmentSlot, ItemStack, Player, EntityComponentTypes } from '@minecraft/server';
import { MinecraftItemTypes } from '@minecraft/vanilla-data';

function giveEquipment(player: Player) {
    const equipmentCompPlayer = player.getComponent(EntityComponentTypes.Equippable);
    if (equipmentCompPlayer) {
        equipmentCompPlayer.setEquipment(EquipmentSlot.Chest, new ItemStack(MinecraftItemTypes.Elytra));
    }
}

层级 (查看完整内容)

属性

entity typeId componentId

方法

getEquipment getEquipmentSlot isValid setEquipment

属性

只读 实验性entity

entity: Entity

备注

The entity that owns this component. The entity will be undefined if it has been removed.

只读 实验性typeId

typeId: string

备注

Identifier of the component.

静态 只读 实验性componentId

componentId: "minecraft:equippable" = 'minecraft:equippable'

方法

getEquipment

  • getEquipment(equipmentSlot): ItemStack
  • 实验性

    参数

    • equipmentSlot: EquipmentSlot

      The equipment slot. e.g. "head", "chest", "offhand"

    返回 ItemStack

    Returns the item equipped to the given EquipmentSlot. If empty, returns undefined.

    备注

    Gets the equipped item for the given EquipmentSlot.

    抛出

    This function can throw errors.

getEquipmentSlot

  • getEquipmentSlot(equipmentSlot): ContainerSlot
  • 实验性

    参数

    • equipmentSlot: EquipmentSlot

      The equipment slot. e.g. "head", "chest", "offhand".

    返回 ContainerSlot

    Returns the ContainerSlot corresponding to the given EquipmentSlot.

    备注

    Gets the ContainerSlot corresponding to the given EquipmentSlot.

    抛出

    This function can throw errors.

isValid

  • isValid(): boolean
  • 实验性

    返回 boolean

    Whether the component is valid.

    备注

    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.

setEquipment

  • setEquipment(equipmentSlot, itemStack?): boolean
  • 实验性

    参数

    • equipmentSlot: EquipmentSlot

      The equipment slot. e.g. "head", "chest", "offhand".

    • 可选itemStack: ItemStack

      The item to equip. If undefined, clears the slot.

    返回 boolean

    备注

    Replaces the item in the given EquipmentSlot.

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

    抛出

    This function can throw errors.

显示设置

成员可见性

目录

属性
方法