指南
如何製作 Forge 模組
更新於 2026年10月7日
Forge 是歷史最久的大型模組載入器,NeoForge 則是它在較新版本上的接班者。Forge 模組是使用 ForgeGradle(或 NeoGradle)的 Gradle 專案,附一個 mods.toml 檔案,並透過延遲註冊器註冊內容。
一個可以拿來起步的範例。
用 Codexe 產生這個逐步說明
1.選擇 Forge 或 NeoForge 以及版本
例如 Minecraft 1.20.1 用 Forge 47,1.20.2 以後用 NeoForge。
2.設定 Gradle 專案
附 ForgeGradle 的 MDK 結構、相符的 Gradle 版本,以及 Java 17(1.20.5 之前)或 21。
3.撰寫 mods.toml
模組 id、載入器的版本範圍和相依套件。載入器範圍寫錯,是最常見的載入錯誤。
4.註冊內容
物品、方塊和實體用
DeferredRegister,遊戲事件用事件匯流排。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 產生這個