2.1 物品的表示——ItemStack和Ingredient
关于ProbeJS提示
带有🔎符号的段落代表该段内容ProbeJS中有语言文档，或使用ProbeJS编写较为简便。
一、ItemStack
顾名思义，ItemStack可以代表一组物品。
🔎 以下为一些实例：
| 例子 | 解释 |
|---|---|
| Item.of("minecraft:diamond") | 1个铁锭 |
| Item.of("minecraft:diamond").withCount(6) | 4个铁锭 |
| Item.of("minecraft:iron_ingot").withCount(5).withName("KubeJS魔改教程") | 5个名字为"KubeJS魔改教程"的铁锭 |
| Item.of("minecraft:diamond_sword").ignoreNBT() | 忽略了NBT的钻石剑（多用于忽略物品耐久、附魔等属性） |
| Item.of("minecraft:enchanted_book", StoredEnchantments]}) | 横扫之刃I附魔书（直接添加NBT例子） |
| Item.of("minecraft:enchanted_book").enchant("minecraft:sweeping", 1) | 横扫之刃I附魔书（使用函数添加NBT例子） |
| Item.of(/create:.*/) | 所有机械动力物品（正则表达式） |
| ... | ... |
在KubeJS中，你可以直接使用物品ID来表示单个物品，例如"minecraft:diamond_sword"代表一把钻石剑。
你还可以在物品前加上倍数来表示物品个数，例如"5x minecraft:cobblestone"代表5个圆石。
二、Ingredient
Ingredient类似于一个集合，它能够代表其所包含的所有物品，包括但不限于tag、物品列表......
以下为一些实例：
| 例子 | 意义 |
|---|---|
| Ingredient.of("#minecraft:logs") | 代表tag：#minecraft:logs |
| Ingredient.matchAny["minecraft:diamond", "@tinkersconstruct"]) | 获得一个包含当前筛选条件的物品组 |
| ... | ... |
Ingredient.of()可以接受很多类型的输入并返回对应的Ingredient，包括正则表达式，tag（如上例），Ingredient[]，模组名称（如@xplus）
另请参阅：ItemStackJS (kubejs.com) 、IngredientJS (kubejs.com) 、旧版本教程 2.1物品表示
我们将在后续章节中详细讲解ItemStack。
M1hono
Wudji