类 Container实验性

只读 实验性emptySlotsCount

只读 实验性size

addItem

• addItem(itemStack): ItemStack
• 实验性

  参数

  • itemStack: ItemStack

    The stack of items to add.

  返回 ItemStack

  备注

  Adds an item to the container. The item is placed in the first available slot(s) and can be stacked with existing items of the same type. Note, use Container.setItem if you wish to set the item in a particular slot.

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

  抛出

  This function can throw errors.

clearAll

• clearAll(): void
• 实验性

  返回 void

  备注

  Clears all inventory items in the container.

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

  抛出

  Throws if the container is invalid.

getItem

• getItem(slot): ItemStack
• 实验性

  参数

  • slot: number

    Zero-based index of the slot to retrieve items from.

  返回 ItemStack

  备注

  Gets an ItemStack of the item at the specified slot. If the slot is empty, returns undefined. This method does not change or clear the contents of the specified slot. To get a reference to a particular slot, see Container.getSlot.

  抛出

  Throws if the container is invalid or if the slot index is out of bounds.

  示例: getFirstHotbarItem.ts

  import { world, EntityInventoryComponent, DimensionLocation } from "@minecraft/server";
  
  function getFirstHotbarItem(log: (message: string, status?: number) => void, targetLocation: DimensionLocation) {
    for (const player of world.getAllPlayers()) {
      const inventory = player.getComponent(EntityInventoryComponent.componentId) as EntityInventoryComponent;
      if (inventory && inventory.container) {
        const firstItem = inventory.container.getItem(0);
  
        if (firstItem) {
          log("First item in hotbar is: " + firstItem.typeId);
        }
  
        return inventory.container.getItem(0);
      }
      return undefined;
    }
  }
  复制

getSlot

• getSlot(slot): ContainerSlot
• 实验性

  参数

  • slot: number

    The index of the slot to return. This index must be within the bounds of the container.

  返回 ContainerSlot

  备注

  Returns a container slot. This acts as a reference to a slot at the given index for this container.

  抛出

  Throws if the container is invalid or if the slot index is out of bounds.

isValid

• isValid(): boolean
• 实验性

  返回 boolean

  备注

  Returns whether a container object (or the entity or block that this container is associated with) is still available for use in this context.

moveItem

• moveItem(fromSlot, toSlot, toContainer): void
• 实验性

  参数

  • fromSlot: number

    Zero-based index of the slot to transfer an item from, on this container.
  • toSlot: number

    Zero-based index of the slot to transfer an item to, on toContainer.
  • toContainer: Container

    Target container to transfer to. Note this can be the same container as the source.

  返回 void

  备注

  Moves an item from one slot to another, potentially across containers.

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

  抛出

  Throws if either this container or toContainer are invalid or if the fromSlot or toSlot indices out of bounds.

  示例: moveBetweenContainers.ts

  import { world, EntityInventoryComponent, EntityComponentTypes, DimensionLocation } from "@minecraft/server";
  import { MinecraftEntityTypes } from "@minecraft/vanilla-data";
  
  function moveBetweenContainers(
      targetLocation: DimensionLocation
  ) {
    const players = world.getAllPlayers();
  
    const chestCart = targetLocation.dimension.spawnEntity(MinecraftEntityTypes.ChestMinecart, {
      x: targetLocation.x + 1,
      y: targetLocation.y,
      z: targetLocation.z,
    });
  
    if (players.length > 0) {
      const fromPlayer = players[0];
  
      const fromInventory = fromPlayer.getComponent(EntityComponentTypes.Inventory) as EntityInventoryComponent;
      const toInventory = chestCart.getComponent(EntityComponentTypes.Inventory) as EntityInventoryComponent;
  
      if (fromInventory && toInventory && fromInventory.container && toInventory.container) {
        fromInventory.container.moveItem(0, 0, toInventory.container);
      }
    }
  }
  复制

setItem

• setItem(slot, itemStack?): void
• 实验性

  参数

  • slot: number

    Zero-based index of the slot to set an item at.
  • 可选itemStack: ItemStack

    Stack of items to place within the specified slot. Setting itemStack to undefined will clear the slot.

  返回 void

  备注

  Sets an item stack within a particular slot.

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

  抛出

  Throws if the container is invalid or if the slot index is out of bounds.

swapItems

• swapItems(slot, otherSlot, otherContainer): void
• 实验性

  参数

  • slot: number

    Zero-based index of the slot to swap from this container.
  • otherSlot: number

    Zero-based index of the slot to swap with.
  • otherContainer: Container

    Target container to swap with. Note this can be the same container as this source.

  返回 void

  备注

  Swaps items between two different slots within containers.

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

  抛出

  Throws if either this container or otherContainer are invalid or if the slot or otherSlot are out of bounds.

transferItem

• transferItem(fromSlot, toContainer): ItemStack
• 实验性

  参数

  • fromSlot: number

    Zero-based index of the slot to transfer an item from, on this container.
  • toContainer: Container

    Target container to transfer to. Note this can be the same container as the source.

  返回 ItemStack

  An itemStack with the items that couldn't be transferred. Returns undefined if all items were transferred.

  备注

  Moves an item from one slot to another container, or to the first available slot in the same container.

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

  抛出

  Throws if either this container or toContainer are invalid or if the fromSlot or toSlot indices out of bounds.

  示例: transferBetweenContainers.ts

  import { world, EntityInventoryComponent, EntityComponentTypes, DimensionLocation } from "@minecraft/server";
  import { MinecraftEntityTypes } from "@minecraft/vanilla-data";
  
  function transferBetweenContainers(
      targetLocation: DimensionLocation
  ) {
    const players = world.getAllPlayers();
  
    const chestCart = targetLocation.dimension.spawnEntity(MinecraftEntityTypes.ChestMinecart, {
      x: targetLocation.x + 1,
      y: targetLocation.y,
      z: targetLocation.z,
    });
  
    if (players.length > 0) {
      const fromPlayer = players[0];
  
      const fromInventory = fromPlayer.getComponent(EntityComponentTypes.Inventory) as EntityInventoryComponent;
      const toInventory = chestCart.getComponent(EntityComponentTypes.Inventory) as EntityInventoryComponent;
  
      if (fromInventory && toInventory && fromInventory.container && toInventory.container) {
        fromInventory.container.transferItem(0, toInventory.container);
      }
    }
  }
  复制