Fabric

本文件更新日誌【ChangeLog】：

支援版本為1.18.2-1.19 Snapshot

準備：

IntelliJ IDEA(www.jetbrains.com/zh-cn/idea/download/#section=windows)

JDK 17或18 (Java Development Kit) 

【可選但十分十分推薦！】IDEA外掛：Minecraft Development

良好的網路

IDEA中文語言包外掛

好的，讓我們來開始吧！

第一步：IDEA

開啟上方的IDEA官網，下載社群版即可（與旗艦版並沒有什麼區別），然後安裝。

甲骨文官網：www.oracle.com/java/technologies/downloads/

BellSoft：bell-sw.com/pages/downloads/

BELLSOFT :

Package Type這裡最好選擇Full JDK。

mac和Linux的看到這裡可以跳到第三步了，Windows的可能需要配置一下環境變數，百度上JvavJava環境變數教程滿天飛，大家可以自行去百度搜索（如果你用外掛自動配置開發環境的話當我沒說）

第三步：安裝IDEA中文語言包外掛

開啟IDEA後，應該會是一片英文。

首先，點選左邊的Plugins

然後點選Marketplace，輸入Chinese，第二個就是

第二個就是安裝完之後重啟IDEA。

第四步：Minecraft Development外掛

如上方一樣如法炮製。——輸入Minecraft Dev就會出來，然後安裝。搞定！

至此，準備工作全部完成。

正文--構建工作區

外掛自動構建：

開啟IDEA主介面，點選新建專案。

左邊側邊欄選擇Minecraft。然後右邊就變成了這個樣子。如果你沒有配置環境變數，那麼專案SDK裡可以進行手動設定。隨後在下面這一坨中選擇Fabric Mod。然後下一步。

隨後就來到了這個頁面。GroupId這裡一般是你的域名的倒寫。例如我是fabricmc工作室的，GroupId這裡就填net.fabricmc，或者我是GitHub上的村民工作室，我就填github.plainsvillager。最前面這個可以是com、cn、top、xyz、org等。GroupId下面這個就是你模組的名字，建議填寫名稱空間id【注意事項：這兩欄都不能含有漢語、阿拉伯數字、大寫英文字母！】

隨後來到了這裡。Mod Name就是你模組名，這裡可以自由點，起碼能有大寫字母。Minecraft Version這裡就填你要開發的Minecraft版本。這裡我填寫1.18.2。後邊出現了一個Yarn的東西。這是什麼呢？第0.5篇的概念篇我們將會講解。反正選最新就完事了！Loader Version就是fabric載入器的版本。相信大家都玩過模組吧！這就是那個模組載入器。Loom則是另一個東西，這裡建議不要選帶有snapshot字樣的版本。Minecraft License這裡可以選擇你的模組的許可證，萌新就不要亂動了。這些都是必須的，下面則是可選的。

Fabric API：強烈建議啟用。若啟用選最新就好。

Description：你模組的描述。雖然是字串但也不要輸入中文！我試過會亂碼。

Authors：作者/貢獻團隊，你寫幾十個都沒問題，但別忘英文逗號。

Website：官網：

Repository：這個模組的github倉庫地址。

專案名稱這裡隨便寫，也不能有中文！！！寫完了點完成。

然後就開始漫長的等待吧。

右下角大概率會開始有個“找到Gradle構建指令碼”，不用管它。然後IDEA就開始自動匯入了。如果終端裡說TASK FAILED的話，多重新開啟幾次。

如果是genSources任務failed的話，多試幾次。

手動配置開發環境教程（不推薦但某些情況還是有用的）：

在左側的分支這裡選擇版本，隨後在右邊code這裡點download zip，並把它儲存到一個沒有中文的資料夾。下載完之後進行解壓。隨後重新命名資料夾名稱為你的模組名（中文非法）。隨後開啟IDEA

點選主介面的開啟（如果已經開啟專案的話點檔案->開啟），選擇你剛解壓出的那個資料夾下的build.gradle，並點選確定。

隨後IDEA會彈出一個視窗，這裡選作為專案開啟。

隨後就開始了匯入。如果是第一次構建可能要等幾個小時。失敗的話重新開啟專案。

BUILD SUCCESFUL後，參照下方的生成Minecraft原始碼的教程。

生成Minecraft原始碼

但是還是有機率執行失敗。這時候，就需要 禾鬥    雪--/*上*旺了。注意，gensources這一步肥腸重要，一定不能不進行！

succesful後的話，點選左邊的外部庫並展開。

找到net.minecraft:minecraft-project-@merged-named ……（太長了不打了）這個包，點小三角把它展開。下面有個叫做net.minecraft的包，這就是yarn為我們做的貢獻。再展開就是yarn的minecraft原始碼。【注：Mojang從未釋出Minecraft的原始碼，這只是yarn自己的（或者你也可以理解為第三方的）】這些東東對你寫模組會有很大的幫助。

到現在，模組的開發環境就算配置完成了！

另外，如果你有問題，可以隨時在評論區或私信給我留言。我看到了的話都會回覆。

加油！