教學:編寫腳本API/ItemStack類基礎

ItemStack類基礎

系列教學

所屬系列

編寫腳本API

難易度

初級

實踐裝置

所需軟件

◄ System類基礎

Entity類基礎 ►

引言

ItemStack 類是 server 模組的一部分，擁有強大的功能，我們將幫助您了解和使用此類。

在此之前我們需要先了解 ItemStack 是什麼。

ItemStack是物品數據的儲存方式，各種不同的物品堆疊元件共同影響了一個物品的具體行為。

我們現在暫時把它粗略的理解為一個物品。

在正式開始前，我們可以用下面的方法來建立一個物品：

new ItemStack(itemType: ItemType | string, amount?: number)

import { ItemStack, DimensionLocation } from "@minecraft/server";
import { MinecraftItemTypes } from "@minecraft/vanilla-data";

function itemStacks(log: (message: string, status?: number) => void, targetLocation: DimensionLocation) {
  const oneItemLoc = { x: targetLocation.x + targetLocation.y + 3, y: 2, z: targetLocation.z + 1 };
  const fiveItemsLoc = { x: targetLocation.x + 1, y: targetLocation.y + 2, z: targetLocation.z + 1 };
  const diamondPickaxeLoc = { x: targetLocation.x + 2, y: targetLocation.y + 2, z: targetLocation.z + 4 };

  const oneEmerald = new ItemStack(MinecraftItemTypes.Emerald, 1);
  const onePickaxe = new ItemStack(MinecraftItemTypes.DiamondPickaxe, 1);
  const fiveEmeralds = new ItemStack(MinecraftItemTypes.Emerald, 5);

  log(`Spawning an emerald at (${oneItemLoc.x}, ${oneItemLoc.y}, ${oneItemLoc.z})`);
  targetLocation.dimension.spawnItem(oneEmerald, oneItemLoc);

  log(`Spawning five emeralds at (${fiveItemsLoc.x}, ${fiveItemsLoc.y}, ${fiveItemsLoc.z})`);
  targetLocation.dimension.spawnItem(fiveEmeralds, fiveItemsLoc);

  log(`Spawning a diamond pickaxe at (${diamondPickaxeLoc.x}, ${diamondPickaxeLoc.y}, ${diamondPickaxeLoc.z})`);
  targetLocation.dimension.spawnItem(onePickaxe, diamondPickaxeLoc);
}

這些內容取自官方文件，使用TypeScript語言編寫。

引用

1. 我的世界wiki:物品堆疊元件
2. 官方文件:itemStack類