1. 物品概论

1.1. 你的第一个物品

我们首先通过一个叫 RegistryEvent.Register<Item> 的事件注册一个啥都没用的物品。

@Mod.EventBusSubscriber(modid = "my_mod")
public final class ItemInitializer {

    // 我们一会会用到它。
    public static Item firstItem;

    // 和正常的事件一样，你不需要手动调用此方法！Forge 会自动调用它的。
    @SubscribeEvent
    public static void registerItem(RegistryEvent.Register<Item> event) {
        // 注意 setRegistryName 调用。
        // 每一个物品都对应唯一一个注册名，用于和其他物品区分开来。这个注册名不能含有大写字母。
        // 此方法返回被注册的 Item 对象。
        event.getRegistry().registerAll(
            firstItem = new Item().setRegistryName("my_mod:first_item")
        );
    }
}

注意，所有 Item 在注册时必须都有调用过 setRegistryName，否则会抛异常并导致游戏退出。

但是……创造物品栏里没有你的新物品。当然你可以用 /give <玩家名> <registry name> 获得你的新物品，但你不觉得显示在创造模式物品栏里更方便么。

// 我们需要一个 CreativeTabs 的实例，当然那个类下面就有原版的 10 个，可以直接拿来用，
// 但是你不觉得有一个自己的更方便吗……
// 一般是使用匿名内部类，就像这样。
public static final CreativeTabs EXAMPLE_CREATIVE_TAB = new CreativeTabs("example_tab") {
    // 获得用作标签图标的 ItemStack。你大可以往里面塞各种奇奇怪怪的数据。
    @Override
    public ItemStack createIcon() {
        return new ItemStack(Items.DIAMOND);
    }
};

然后我们需要对我们的事件订阅器稍加修改，以让我们的物品显示在这个全新的标签页中：

public static Item firstItem;

@SubscribeEvent
public static void registerItem(RegistryEvent.Register<Item> event) {
    // 注意 setRegistryName 调用。
    // 每一个物品都对应唯一一个注册名，用于和其他物品区分开来。这个注册名不能含有大写字母。
    // 此方法返回被注册的 Item 对象。
    event.getRegistry().registerAll(
        firstItem = new Item()
            .setCreativeTab(EXAMPLE_CREATIVE_TAB)
            .setRegistryName("my_mod:first_item")
    );
}

1.2. 这物品名字不对……

你可能会发现你的新物品叫 item.null.name。我们需要给它一个正常点的名字。因为 Minecraft 是个面向全球的游戏，所以这个过程有些复杂，因为我们需要确保使用其他语言的人可以翻译这个物品名称。关于这部分内容的细节可参考第十三章，这里不作详细说明。

@SubscribeEvent
public static void registerItem(RegistryEvent.Register<Item> event) {
    event.getRegistry().register(
        firstItem = new Item()
            .setCreativeTab(EXAMPLE_CREATIVE_TAB)
            // 注意此名字和 registry name 不是一个概念。
            // 这个名字仅用于国际化支持。
            // 这个方法也返回 Item。
            .setTranslationKey("my_mod.example_item")
            .setRegistryName("my_mod:first_item")
    );
}

然后，是喜闻乐见的语言文件：

在 resources 下新建 assets 文件夹
在 assets 下新建文件夹，名字和你的 modid 相同
在以你的 modid 命名的文件夹下新建 lang 文件夹

在 lang 文件夹下新建 en_us.lang：

item.my_mod.example_item.name=Example Item

等等，如果没理解错，这是英文（美国）的 Locale 啊？
OK。然后还是 lang 文件夹，新建 zh_cn.lang：
```
item.my_mod.example_item.name=示例物品
```

1.3. 紫黑块？

你可能会发现你的新物品的外观是……紫黑块。 Minecraft 所使用的模型及渲染系统会在第十一章有详细说明，这里我们在这里先从一个毫无特效的普通“贴图”开始。

首先，我们需要一个单独的类来订阅 ModelRegistryEvent，在这里我们需要让 Forge 告知 Minecraft 从我们指定的地方查找这个物品的模型：

import net.minecraft.client.renderer.block.model.ModelResourceLocation;
import net.minecraftforge.client.model.ModelLoader;

@Mod.EventBusSubscriber(value = Side.CLIENT, modid = "my_mod")
public final class ModelMapper {
    @SubscribeEvent
    public static void onModelReg(ModelRegistryEvent event) {
        ModelLoader.setCustomModelResourceLocation(ItemInitializer.firstItem, 0, new ModelResourceLocation(ItemInitializer.firstItem.getRegistryName(), "inventory"));
    }
}

在这里我们通过重用物品的注册名，将该物品的模型定义文件指向了 assets/my_mod/models/item/example_item.json。
此时我们只需要创建这个文件就可以了：

{
    "parent": "item/generated",
    "textures": {
        "layer0": "my_mod:items/example_item"
    }
}

我们在这里直接使用原版内建的默认物品模型 item/generated，并指定它唯一一层纹理位于 assets/my_mod/textures/items/example_item.png。我们只需要把预先准备好的 PNG 格式的纹理放在这个位置就好了。

此时再重启游戏，你应该能在创造模式物品栏中找到一个看起来非常普通的物品了。