[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]