指南

如何制作 Forge 模组

更新于 2026年10月7日

Forge 是历史最久的大型模组加载器，NeoForge 是它面向较新版本的继任者。Forge 模组是使用 ForgeGradle（或 NeoGradle）的 Gradle 项目，带有 mods.toml 文件，并通过延迟注册器来注册内容。

一个可以作为起点的例子。

用 Codexe 生成这个

分步说明

  1. 1.选择 Forge 或 NeoForge 以及版本

    例如 Minecraft 1.20.1 用 Forge 47，1.20.2 及更新版本用 NeoForge。

  2. 2.设置 Gradle 项目

    带 ForgeGradle 的 MDK 布局、匹配的 Gradle 版本，以及 Java 17（1.20.5 之前）或 21。

  3. 3.编写 mods.toml

    模组 id、加载器的版本范围和依赖。加载器范围写错，是最常见的加载错误。

  4. 4.注册内容

    物品、方块和实体使用 DeferredRegister，游戏事件使用事件总线。

  5. 5.构建

    ./gradlew build；第一次构建会下载工具链，可能需要几分钟。

用 Codexe

描述模组，并写明“Forge 1.20.1”或“NeoForge 1.21.1”。Codexe 编写项目，用匹配的环境构建，并检查 .jar 里含有 mods.toml 或 neoforge.mods.toml。

常见问题

MCreator 更简单吗？

MCreator 以可视化的方式逐个元素地构建模组；Codexe 根据描述编写代码。见 Codexe 与 MCreator。

我能在 Fabric 上使用 Forge 模组吗？

不能，它们是不同的加载器。模组必须针对你使用的加载器来构建。

制作 Forge 模组

这条提示词打开后即可直接发送：

“一个 Forge 1.20.1 模组，添加红宝石矿、红宝石、红宝石剑和整套红宝石盔甲，带配方、贴图、主世界 Y -60 到 16 之间的矿石生成，以及英文名称。”

用 Codexe 生成这个
如何制作 Forge 或 NeoForge 模组 | Codexe