指南

如何製作 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。

Forge 模組可以搭配 Fabric 使用嗎?

不行,它們是不同的載入器。模組必須針對你使用的載入器建置。

製作 Forge 模組

這則提示詞開啟後即可直接傳送:

“一個 Forge 1.20.1 模組,新增紅寶石礦、紅寶石、紅寶石劍和整套紅寶石盔甲,附配方、材質、主世界 Y -60 到 16 之間的礦石生成,以及英文名稱。”

用 Codexe 產生這個
如何製作 Forge 或 NeoForge 模組 | Codexe