本页会带你介绍物品的一些关键概念，以及如何注册物品、添加纹理、添加模型与命名。

如果你还不知道的话，Minecraft 中的一切都存储在注册表中，物品也不例外。

准备你的物品类

为了简化物品注册，你可以创建一个接受字符串标识符、一些物品属性和工厂方法来创建 Item 实例。

这个方法会用提供的 id 创建物品并在游戏的物品注册表中注册。

你可以将这个方法放在叫做 ModItems 的类中（也可以是其他你想要的名称）。

Mojang 也是对物品这么做的！ 看看 Items 类以了解。

public class ModItems {
	public static <T extends Item> T register(String name, Function<Item.Properties, T> itemFactory, Item.Properties settings) {
		// Create the item key.
		ResourceKey<Item> itemKey = ResourceKey.create(Registries.ITEM, Identifier.fromNamespaceAndPath(ExampleMod.MOD_ID, name));

		// Create the item instance.
		T item = itemFactory.apply(settings.setId(itemKey));

		// Register the item.
		Registry.register(BuiltInRegistries.ITEM, itemKey, item);

		return item;
	}

}

注意我们使用的是 T，这是一个继承自 Item 的泛型类型。 这样我们就可以使用相同的 register 方法来注册任何继承自 Item 的类型的物品。 此外，我们还使用了 Function 作为工厂，它允许我们根据物品属性指定创建物品的方式。

注册物品

你现在可以用这个方法注册物品。

物品的注册方法会接收一个 Item.Properties 类的实例作为参数。 这个类允许你通过一系列构造器方法配置物品的属性。

TIP

如果你想要改变物品的最大堆叠数量，你可以使用Item.Properties类的stacksTo方法。

如果将物品标记为可被破坏，那么这就不会生效，因为可被破坏的物品的堆叠大小永远是 1 以避免重复损坏。

public static final Item SUSPICIOUS_SUBSTANCE = register("suspicious_substance", Item::new, new Item.Properties());

Item::new会给注册方法传递物品实例，Item.Properties是创建Item类的实例的一个参数。

可是现在你如果启动你的修改过的客户端，你会发现你的物品根本不存在！ 那是因为你没有静态地初始化你的类。

要这样做，你需要在类中添加静态的初始化方法，然后在你的模组的初始化类中调用。 当前，方法不需要里面有任何东西。

public static void initialize() {
}

public class ExampleModItems implements ModInitializer {
	@Override
	public void onInitialize() {
		ModItems.initialize();
	}
}

对类调用一个方法会静态初始化，如果还没有加载的话——这意味着所有的 static 字段都会计算。 这就是这个占位的 initialize 的方法的目的。 这就是这个占位的 initialize 的方法的目的。

将物品添加到创造标签页

INFO

如果想要将物品添加到自定义的 CreativeModeTab，请参阅自定义创造标签页页面以了解更多。

这里为举例，我们将这个物品添加到原材料的 CreativeModeTab 中，你需要使用 Fabric API 的创造标签页事件——也就是 ItemGroupEvents.modifyEntriesEvent

你可以在你的物品类的 initialize 方法中完成。

// Get the event for modifying entries in the ingredients group.
// And register an event handler that adds our suspicious item to the ingredients group.
ItemGroupEvents.modifyEntriesEvent(CreativeModeTabs.INGREDIENTS)
		.register((itemGroup) -> itemGroup.accept(ModItems.SUSPICIOUS_SUBSTANCE));

加载进入游戏，可以看到我们的物品已经注册好了，并且在“原材料”创造标签页中。

然而，还缺这些：

• 物品模型
• 纹理
• 翻译（名称）

给物品命名

物品当前还没有翻译，所以需要添加。 Minecraft 已经提供好了翻译键：item.example-mod.suspicious_substance。

在 src/main/resources/assets/example-mod/lang/zh_cn.json 创建一个新的 JSON 文件，并输入翻译键及其值：

{
  "item.example-mod.suspicious_substance": "Suspicious Substance"
}

要应用更改，可以重启游戏，或者构建模组并按下F3+T。

添加客户端物品、纹理和模型

为了使你的物品拥有合适的外观，它需要：

• 物品纹理
• 物品模型
• 客户端物品

添加纹理

INFO

有关此主题的更多信息，请参阅物品模型页面。

要为你的物品提供纹理和模型，只需为你的物品创建一个 16x16 的纹理图像并将其保存在 assets/example-mod/textures/item 文件夹中。 根据物品的 id 命名纹理文件的名字，但要有 .png 扩展名。

例如，将示例纹理用于 suspicious_substance.png。

下载 纹理

添加模型

重启或重新加载游戏时，你会发现物品还没有纹理，这是因为需要添加一个使用了此纹理的模型。

简单创建一个 item/generated 模型，接收一个输入纹理，没有其他的。

在 assets/example-mod/models/item 文件夹中创建模型 JSON，与物品同名；suspicious_substance.json

{
  "parent": "minecraft:item/generated",
  "textures": {
    "layer0": "example-mod:item/suspicious_substance"
  }
}

逐个分析模型 JSON

• parent：模型要继承的模型。 在这个例子中，是 item/generated 模型。
• textures：为模型定义纹理的地方。 textures：为模型定义纹理的地方。 layer0 键是模型使用的纹理。

大多物品继承的模型是 item/generate，因为这是显示纹理的简单模型。

也有其他的，比如 item/handheld，用于拿在玩家手中的物品，例如工具。

创建客户端物品

Minecraft 不会自动找到物品模型文件的位置，我们需要提供一个客户端物品。

在 assets/example-mod/items 目录下创建客户端物品 JSON 文件，文件名与物品标识符相同：spilication_substance.json。

{
  "model": {
    "type": "minecraft:model",
    "model": "example-mod:item/suspicious_substance"
  }
}

逐个分析客户端物品 JSON

• model：这是包含对我们模型的引用的属性。
  • type：这是模型的类型。 对于大多数物品，应该为 minecraft:model
  • model：这是模型的标识符。 它应该有这种形式：example-mod:item/item_name

你的物品在游戏内看上去应该是这样：

让物品可堆肥或作燃料

Fabric API 添加了各种注册表，可用于为物品添加额外属性。

例如，要让物品可堆肥，可以使用 CompostingChanceRegistry：

// Add the suspicious substance to the composting registry with a 30% chance of increasing the composter's level.
CompostingChanceRegistry.INSTANCE.add(ModItems.SUSPICIOUS_SUBSTANCE, 0.3f);

又如，如果要让物品可作燃料，可以使用 FuelRegistry 类。

// Add the suspicious substance to the registry of fuels, with a burn time of 30 seconds.
// Remember, Minecraft deals with logical based-time using ticks.
// 20 ticks = 1 second.
FuelRegistryEvents.BUILD.register((builder, context) -> {
	builder.add(ModItems.SUSPICIOUS_SUBSTANCE, 30 * 20);
});

添加基本的合成配方

如果要为你的物品添加合成配方，需要将配方 JSON 文件放在 data/example-mod/recipe 文件夹中。

更多关于配方格式的信息，可参考以下资源：

• 配方 JSON 生成器
• 中文 Minecraft Wiki - 配方 JSON

自定义物品提示

如果要让你的物品有自定义的物品提示，需要创建继承了 Item 的类，并覆盖 appendHoverText 方法。

INFO

这个例子使用 LightningStick 类，这是在自定义物品交互页面创建的。

@Override
public void appendHoverText(ItemStack stack, TooltipContext context, TooltipDisplay displayComponent, Consumer<Component> textConsumer, TooltipFlag type) {
	textConsumer.accept(Component.translatable("itemTooltip.example-mod.lightning_stick").withStyle(ChatFormatting.GOLD));
}

每次调用 accept() 都会添加一行提示。