一、NeoForge 的本质#

实际上，它并不是一个工具，而是三层东西结合在一起的：

1
Java Mod 代码 -> NeoForge API 注册实体、监听事件、网络包等等 -> FML / ModLauncher 注入Minecraft

FML（Forge Mod Loader） 是底层，负责在 Minecraft 启动时扫描 neoforge.mods.toml，用 ModLauncher 把模组的类和资源注入 JVM。

NeoForge API 是中间层，提供你在代码里用的所有东西：@Mod、DeferredRegister、事件总线、IItemHandler、网络系统等等。

模组就是最上层：一个被 @Mod 注解的类，通过构造函数接收 IEventBus，然后往上面注册实体、物品、事件监听器。

二、核心概念即 「注册 + 事件」#

1
// 声明一个注册器，绑定到 ENTITY_TYPE 注册表
2
public static final DeferredRegister<EntityType<?>> ENTITIES =
3
 DeferredRegister.create(Registries.ENTITY_TYPE, "mymod");
4

5
// 注册一个实体
6
public static final DeferredHolder<EntityType<?>, EntityType<MyEntity>> MY_ENTITY =
7
 ENTITIES.register("my_entity",
8
 () -> EntityType.Builder.of(MyEntity::new, MobCategory.CREATURE)
9
 .sized(0.6f, 1.8f)
10
 .build("mymod:my_entity"));
11

12
// 构造函数里挂到 MOD 总线
13
public MyMod(IEventBus modEventBus) {
14
 ENTITIES.register(modEventBus);
15
}

DeferredRegister 是一个「延迟注册容器」——你在静态初始化时往里放东西，但真正写入 Registries 是在相应的注册事件触发时。不会出现注册顺序问题。

同理，物品、方块、创造模式标签页、粒子类型、附魔……全部走同一套 DeferredRegister 模式。

三、事件#

Minecraft 运行过程中会在特定时机「发事件」，模组「监听」事件来做自己的逻辑。NeoForge 有两条独立总线：

MOD 总线：

1
获取方式：构造函数参数 IEventBus modEventBus
2
注册阶段：实体属性、模型层、能力注册
3
典型事件为：EntityAttributeCreationEvent、RegisterCapabilitiesEvent

NeoForge 总线：

1
获取方式：NeoForge.EVENT_BUS
2
游戏运行阶段：生物生成、玩家交互、世界 Tick
3
典型事件为：LivingDeathEvent、PlayerInteractEvent、ServerTickEvent

四、官方文档#

NeoForge 相关文档链接：

1
主文档：https://docs.neoforged.net/
2
社区 Wiki：https://github.com/neoforged/neoforge/wiki
3
Javadoc：https://neoforged.net/javadoc/
4

5
学习项目（车万女仆 By.酒石酸菌）：https://github.com/TartaricAcid/TouhouLittleMaid

五、解耦#

学习了dalao的开源项目，仔细发现它们的各个功能模块与注册都是解耦的。

在软件工程中，耦合（Coupling） 指的是两个模块之间的依赖程度。当两个模块紧密依赖时，修改其中一个往往会影响另一个，这种牵一发而动全身的关系就叫“高耦合”。

解耦（Decoupling） 就是通过某种方式降低这种依赖，让各个模块可以独立变化、独立理解、独立测试。

那么，在我们先前的代码开发中，不难发现把所有功能都集合在了 HelloWorld.java 中，把所有功能全部在此进行注册与功能实现，如果所有逻辑都写在 HelloWorld.java 里：主类、事件监听、注册逻辑……全部挤在一起。一旦要修改事件监听逻辑，就得打开这个庞大的文件，在众多代码中找到那一小块。

所以我们需要对项目进行重构，从开源学习项目中不难发现，dalao在软件包下将诸多功能模块分别置于不同软件包下，仅在主类里完成注册。

那么，就让我们开始吧。

1
com.helloworld/
2
    - HelloWorld.java
3
    - ModEvents.java

1
com.helloworld/
2
    - HelloWorld.java
3
    - com.helloworld.event/
4
        - ModEvents.java
5
    - com.helloworld.init/
6
        - InitItems.java
7
        - InitTab.java

1
@Mod(HelloWorld.MODID)
2
public class HelloWorld {
3
    public static final String MODID = "helloworld";
4

5
    public HelloWorld(IEventBus modEventBus) {
6
        // 注册物品
7
        InitItems.register(modEventBus);
8

9
        // 注册物品栏
10
        InitTab.register(modEventBus);
11
    }
12
}

1
@EventBusSubscriber(modid = HelloWorld.MODID)
2
public class ModEvents {
3
    @SubscribeEvent
4
    public static void onPlayerLogin(PlayerEvent.PlayerLoggedInEvent event) {
5
        event.getEntity().sendSystemMessage(Component.literal("Hello World!"));
6
    }
7
}

1
public class InitItems {
2
    public static final DeferredRegister<Item> ITEM =
3
            DeferredRegister.create(Registries.ITEM, HelloWorld.MODID);
4

5
    public static void register(IEventBus modEventBus) {
6
        ITEM.register(modEventBus);
7
    }
8
}

1
public class InitTab {
2
    public static final DeferredRegister<CreativeModeTab> CREATIVE_TABS =
3
            DeferredRegister.create(Registries.CREATIVE_MODE_TAB, HelloWorld.MODID);
4

5
    public static final DeferredHolder<CreativeModeTab, CreativeModeTab> EXAMPLE_TAB =
6
            CREATIVE_TABS.register("example_tab", () -> CreativeModeTab.builder()
7
                    .title(Component.translatable("springtsuki.tab"))
8
                    .icon(() -> new ItemStack(Items.DIAMOND))
9
                    .displayItems((parameters, output) -> {
10
                        output.accept(Items.COBBLESTONE);
11
                        output.accept(Items.OAK_PLANKS);
12
                    })
13
                    .build());
14

15
    public static void register(IEventBus modEventBus) {
16
        CREATIVE_TABS.register(modEventBus);
17
    }
18
}