Hileb 发表于 2024/5/25 10:15

[1.12.2]Forge注册物品

本帖最后由 Hileb 于 2024/5/25 10:32 编辑

原版的注册表是一套简单粗暴的中注册表 RegistryNamespaced , 这套注册表能够处理注册名,注册项和数字id之间的映射关系,但这仅满足了原版的需求。
经 Forge patch 后,原版物品注册改用 IForgeRegistry,原有的 RegistryNamespaced 变更为 FMLControlledNamespacedRegistry 即 IForgeRegistry 版本的 RegistryNamespaced,已处理各种情况下的id变动(存档,网络)。

因此,在forge环境下注册物品,你只需要和其他 IForgeRegistry 一样,订阅 RegistryEvent.Register事件。其为一个 GenericEvent,正常情况下,你需要添加一个泛型指定其准确类型,对于物品来说:
RegistryEvent.Register<Item>
你可以通过 getRegistry()V 从该事件拿到 IForgeRegister ,并调用 register 注册单个项目 或 registerAll 注册一个数组内的全部项目。

注册的项目通常同时也是 IForgeRegistryEntry。Item便是如此。
public class Item extends net.minecraftforge.registries.IForgeRegistryEntry.Impl<Item>
因此,一般情况下,一个物品只对应一个注册项,拥有一个注册名,使用setRegistryName指定,其返回值为 Item。这意味着在 Forge 的设计中,注册的项目通常就是 IForgeRegistryEntry。
因此,有n个注册项,通常需要n个对象。

实例:使用数组注册两个物品:
@SubscribeEvent
    public static void registerItem(RegistryEvent.Register<Item> event){
        //注册物品
      event.getRegistry().registerAll(new Item[]{
                new Item().setRegistryName(new ResourceLocation("example", "demo")),
                new ItemSword(
                        EnumHelper.addToolMaterial("fancy_material", 9, 9 , 9f, 9f, 40))
                        .setRegistryName(new ResourceLocation("example", "fancy_sword"))

      });
    }
    @GameRegistry.ObjectHolder("example:demo")
    public static Item DEMO;
    @GameRegistry.ObjectHolder("example:fancy_sword")
    public static Item FANCY_SWORD;
    //因为加了GameRegistry.ObjectHolder,FML会初始化它们,当然你也可以不使用GameRegistry.ObjectHolder,而是直接捕获它们:
    //IDL的思路是在构造它们时把它们统一加入一个List再批量注册,这样:public static final ItemSword FANCY_SWORD = new FancySword(); 添加List在构造函数完成。
    //上面这个例子还可以改成: event.getRegistry().register(DEMO =new Item().setRegistryName(new ResourceLocation("example", "demo"))); 逐行注册
    //你也可以将IDF中list设计保留,但不在构造时决定注册名和写死加入list,而是像低配版DeferredRegistry:
    // public static <T extends Item> T registerItem(String name, T value){
             ITEMS.add(value.setRegistryName(new ResourceLocation("example", name))); return value;
    //}
    //public static final FancySword FANCY_SWORD = registerItem("fancy_sword", new FancySword());
页: [1]
查看完整版本: [1.12.2]Forge注册物品