指南

如何製作 Fabric 模組

更新於 2026年10月7日

Fabric 是輕量的模組載入器,跟進新 Minecraft 版本的速度很快。Fabric 模組是用 Loom 插件建置的 Gradle 專案,附一個 fabric.mod.json,告訴載入器這個模組是什麼。玩家把它裝在用戶端(如果模組有新增內容,伺服器也要裝)。

一個可以拿來起步的範例。

用 Codexe 產生這個

逐步說明

  1. 1.選擇 Minecraft 和載入器版本

    模組是針對單一 Minecraft 版本建置的。Fabric API 和載入器的版本都必須跟它相符。

  2. 2.設定 Gradle 專案

    Loom、Minecraft 和 mappings 相依套件、Fabric API,目前的版本還需要 Java 21。

  3. 3.撰寫 fabric.mod.json

    模組 id、名稱、版本、進入點(main、client)和相依套件。

  4. 4.撰寫程式碼

    在進入點註冊物品、方塊和事件。沒有對應事件時,就用 Mixin 修改原版程式碼。

  5. 5.建置並執行

    ./gradlew build 會在 build/libs/ 產生模組 .jar;把它和 Fabric Loader、Fabric API 一起放進 mods/ 資料夾。

用 Codexe

描述模組和版本(「Fabric 1.21.1」)。Codexe 會產生完整的 Loom 專案,用正確的 Java 和 Gradle 編譯、修正建置錯誤,並檢查 .jar 裡有沒有有效的 fabric.mod.json。Minecraft 26.x 的模組使用新的未混淆工具鏈,Codexe 也支援。

常見問題

Fabric 還是 Forge?

Fabric 比較輕量、更新比較快;Forge 和 NeoForge 在某些版本上有龐大的模組生態系。選你的模組包或玩家用的載入器就對了。

Fabric 模組能在伺服器上執行嗎?

可以,只要它是為此撰寫的。會新增內容的模組必須同時裝在伺服器和用戶端上。

製作 Fabric 模組

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

“一個 Fabric 1.21.1 模組,新增銅錘:一種能挖 3x3 範圍的工具,用銅錠和木棒合成,附材質、合成配方和英文名稱。”

用 Codexe 產生這個
如何製作 Minecraft 的 Fabric 模組 | Codexe