Bukkit插件开发教程 - ItemStack(物品堆)

物品堆 - ItemStack

学习目标

• 了解ItemStack的创建
• 了解ItemStack中的ItemMeta
• 了解ItemMeta中对于物品的Lore和Displayname的基本操作

了解ItemStack的创建

我们先来看看ItemStack的几个构造方法

ItemStack(ItemStack stack)
ItemStack(Material type)
ItemStack(Material type, int amount)
ItemStack(Material type, int amount, short damage)
ItemStack(int type)
ItemStack(int type, int amount)
ItemStack(int type, int amount, short damage, java.lang.Byte data)
ItemStack(Material type, int amount, short damage, java.lang.Byte data)

在上方的构造方法中画删除线的都是@Deprecated过的方法，所以，可以尽量不去使用这些构造方法
那么我们要怎么去构造一个ItemStack呢？直接就new就可以了

ItemStack itemStack = new ItemStack();

那么我们在上面的构造方法里看到有个Material，那么这个Material是什么呢？Material是所有物品的枚举，它是一个枚举类，里面存放的是所有Minecraft原版中的物品枚举，比如苹果可以使用 Material.APPLE 来表示
范例: 创建一个type为苹果的ItemStack

// 实例化一个itemStack，并且这个itemStack的type是苹果
ItemStack itemStack = new ItemStack(Material.APPLE);

范例: 创建一个type为苹果，并且数量为16的的ItemStack

// 实例化一个itemStack，并且这个itemStack的type是苹果
ItemStack itemStack = new ItemStack(Material.APPLE, 16);

范例: 创建一个type为钻石剑, 数量为1, 损害值为20的ItemStack

// 实例化一个itemStack，并且这个itemStack的type是苹果
ItemStack itemStack = new ItemStack(Material.DIAMOND_SWORD, 1, (short) 20);

相信通过上方的范例你可以了解ItemStack的创建了~

了解ItemStack中的ItemMeta

ItemMeta我们称之为元数据，它是物品NBT的一个包装，它里面封装了一些我们可以很轻松的设置ItemStack的DisplayName, Lore等内容

范例: 获取一个ItemStack的元数据

ItemStack itemStack = new ItemStack(Material.APPLE);
ItemMeta itemMeta = itemStack.getItemMeta();

这里要注意的是此处的itemMeta是ItemStack内ItemMeta的一个clone版本, 我们对其操作完后需要再调用ItemStack的setItemMeta(ItemMeta itemMeta)进行设置回去

了解ItemMeta中对于物品的Lore和Displayname的基本操作

ItemMeta里有两个比较常用的方法

• setDisplayName(String name)
• setLore(List lore)

那么一个是对物品的displayName进行设置一个是对物品的Lore进行设置，直接上范例吧..

范例: 设置物品的displayName和Lore

ItemStack itemStack = new ItemStack(Material.APPLE);
ItemMeta itemMeta = itemStack.getItemMeta();
itemMeta.setDisplayName("§a绿苹果");
itemMeta.setLore(Arrays.asList("§f这是一个绿色的苹果"));
itemStack.setItemMeta(itemMeta);