如何安裝 Fabric 模組

逐步說明

1. 1.選擇 Minecraft 版本

   每個模組都是針對某一個 Minecraft 版本（或一小段版本範圍）建置的。先選定版本，再下載對應的模組。

2. 2.安裝 Fabric Loader

   從 fabricmc.net 下載 Fabric 安裝程式，選擇 Client，選好 Minecraft 版本後安裝。它會在 Minecraft 啟動器裡新增一個「fabric-loader」設定檔。

3. 3.先啟動一次這個設定檔

   用 Fabric 設定檔啟動遊戲，然後關閉。這會在 .minecraft 裡建立 mods/ 資料夾。

4. 4.加入 Fabric API 和模組

   下載同一個 Minecraft 版本的 Fabric API，然後把它和模組 .jar 一起放進 .minecraft/mods/。不要解壓縮。

5. 5.啟動遊戲並確認

   啟動 Fabric 設定檔。如果某個模組缺少相依模組或版本不對，Fabric 會顯示一個畫面，寫出是哪個模組以及它需要什麼。

mods 資料夾在哪裡

• Windows：%appdata%\.minecraft\mods（貼到「執行」對話方塊或檔案總管的網址列）。
• macOS：~/Library/Application Support/minecraft/mods。
• Linux：~/.minecraft/mods。
• 其他啟動器（Prism、MultiMC、Modrinth App、CurseForge 應用程式）每個實例都有各自的資料夾：使用它們的「開啟 mods 資料夾」按鈕。

在伺服器上安裝

要玩多人遊戲，伺服器也需要 Fabric。取得相同 Minecraft 和載入器版本的 Fabric 伺服器啟動器（或用安裝程式的 Server 模式），先啟動一次，然後把 Fabric API 和模組放進伺服器的 mods/ 資料夾，再重新啟動。

哪些模組要裝在哪裡，取決於模組本身：

• 內容類模組（新的方塊、物品、生物）：裝在伺服器上，也要裝在每位玩家的用戶端上。
• 僅限用戶端的模組（HUD、小地圖、光影、按鍵綁定）：只裝在用戶端。有些裝到專用伺服器上會讓它當機。
• 僅限伺服器的模組（效能、管理工具、部分遊戲規則）：只裝在伺服器上；如果模組說明允許，玩家用單純的 Fabric 甚至原版就能加入。

常見問題

• 「Incompatible mods found」（發現不相容的模組）：某個模組是為其他 Minecraft 版本做的，或需要更新的 Fabric Loader。Fabric 會寫出是哪個模組：換成正確的版本就好。
• 需要 fabric-api：mods/ 裡沒有 Fabric API，或它的版本不對。
• 模組沒有任何作用：你啟動的是一般設定檔而不是 Fabric 設定檔，或這個模組是 Forge 或 NeoForge 用的。Fabric 不會載入 Forge 模組。
• 專用伺服器當機並提到用戶端類別：伺服器上裝了僅限用戶端的模組。

用 Codexe 製作的模組

在 Codexe 上做的 Fabric 模組，在變成就緒之前會先編譯，而且 .jar 必須包含有效的 fabric.mod.json。它是針對 Fabric API 建置的，所以請在旁邊一起安裝 Fabric API。編譯成功只能證明模組可以建置，不代表執行時不會當機，而且模組目前還不能在 Codexe 測試伺服器上試用：請在你自己的用戶端，用它所針對的版本來測試。

常見問題