Items are the pieces of content that appear in your inventory. They can perform actions when you click, act as food, or spawn entities. The following documentation will give you a rundown of the entire Item class and everything related to it. For a tutorial you can follow along, visit Practical Example: Adding an Item.

Item（物品类）的构造方法（constructor）需要一个Item.Settings（物品设置类）的实例。该建造者类（builder class）定义物品的诸多行为，例如堆叠数量、耐久度、是否可食用、等等。以下是所有可用的建造者方法：

Fabric的物品API提供了一些额外的方法来设置一些其他属性。要使用这些新方法，只需要将new Item.Settings()替换成new FabricItemSettings()即可。 下列是所有FabricItemSettings提供的额外功能：

public Item.Settings food(FoodComponent foodComponent)

foodComponent - 一个FoodComponent对象。设置时物品的可食属性会根据FoodComponent的值而变化。更深一步的讲解请见FoodComponent的简介页。

public Item.Settings maxCount(int maxCount)

maxCount - 物品在物品堆中可堆叠的最大数量。如果之前已经调用过maxDamage()，游戏会抛出一个RuntimeException（运行时异常），因为一个物品无法同时拥有数量与耐久度。推荐将最大堆叠数量设为64以下的值，更高的值可能会引发许多问题。

public Item.Settings maxDamageIfAbsent(int maxDamage)

maxDamage - 物品在物品堆中的最大耐久度。

如果之前还没有调用过maxDamage()，则会将最大耐久度设成参数的值。工具和盔甲在没有设置耐久度时会使用此方法来将物品的最大耐久度设置为工具材料（ToolMaterial）的最大耐久度。

public Item.Settings maxDamage(int maxDamage)

maxDamage - 物品在物品堆中的最大耐久度。

public Item.Settings recipeRemainder(Item recipeRemainder)

recipeRemainder - 原物品在合成完成之后返回的物品

有设置了合成剩余物的物品在合成后会将剩余物返回给玩家。设置了该属性的物品有桶（岩浆、水、牛奶）和瓶子（龙息、蜂蜜），合成过后则会返回对应的空物品。

public Item.Settings group(ItemGroup group)

group - 该物品加入的ItemGroup（物品组）

每个物品组都会被显示为创造模式物品栏中的一个标签页，将物品添加进该组则会将该物品加入标签页中，而显示的顺序由注册的顺序决定。若要添加一个新物品组请见这里。

public Item.Settings rarity(Rarity rarity)

rarity - 该物品的稀有度。（默认为常见）

有自定义的稀有度的物品名称会变成不同的颜色。