第一節(jié) 下載JAVA

1、（這一步并沒有什么用）雖然現(xiàn)在啟動器基本上都會自己下載和配置JAVA，但是我們還是可以下載一下JAVA。下載地址是

【https://www.java.com/en/download】

平臺更加全的列表在

【https://www.java.com/en/download/manual.jsp】

2、（這一步才是真的有用）下載JDK是必要的一步。如今（2023年）的Minecraft早就在使用JAVA17了，所以我們制作的模組也要在JAVA17的環(huán)境下運(yùn)行。JAVA17的下載地址是

【https://www.oracle.com/cn/java/technologies/downloads/#java17】

可以選用EXE或者M(jìn)SI，后者不會被殺毒軟件報毒，除此之外兩者沒有區(qū)別。

除此之外，也可以在后文的IDEA中直接下載JDK。將在后文介紹。

3、下載完成后的JAVA默認(rèn)位置是【C:\Program Files\Java\jdk-17】。推薦不要再安裝時改JAVA的安裝位置。

4、除了在Oracle官網(wǎng)下載，還可以在Adoptium中下載安裝包，下載地址是

【https://adoptium.net/zh-CN/temurin/releases/】

它的一個好處是會自動配置JAVA環(huán)境，也就是說使用這個安裝包可以直接跳過下一節(jié)手動配置JAVA環(huán)境的部分。

·手動配置JAVA環(huán)境

這里介紹手動配置的方法。鼠標(biāo)右擊“此電腦”（部分系統(tǒng)顯示“我的電腦”），點擊二級菜單中的“屬性”。 打開后，點擊“高級系統(tǒng)設(shè)置”，打開后，點擊“高級”內(nèi)的“環(huán)境變量”，接下來在“系統(tǒng)變量”內(nèi)新建變量，內(nèi)容如下：

第二節(jié) 下載集成開發(fā)環(huán)境（以IntelliJ IDEA為例）

1、IDEA是Minecraft模組制作教程中使用最廣泛的一個集成開發(fā)環(huán)境（IDE），下載地址是

【https://www.jetbrains.com/idea/download】

我們制作Minecraft模組可以直接使用免費(fèi)且開源的社區(qū)版（Community Edition）。

第三節(jié) Fabric安裝與配置

1、（這一步也并沒有什么用，這兩個是游玩時使用的）Fabric本體與API的下載。

Fabric官網(wǎng)內(nèi)下載地址是

【https://fabricmc.net/use/installer/】

其中可以下載Fabric安裝器。

Fabric API下載地址在CurseForge內(nèi)

【https://www.curseforge.com/minecraft/mc-mods/fabric-api】。

2、Fabric模組模板下載。

①fabric-example-mod。它是Fabric官方提供的一個模板模組，是初學(xué)者非常好的學(xué)習(xí)材料。下載地址在GitHub

【https://github.com/FabricMC/fabric-example-mod】。

缺點是不能夠即時更新，像后文要介紹的gradle.properties內(nèi)的fabric_version、yarn_mappings、loader_version都有可能過時，此時就需要手動配置。

②官方模板模組生成器。地址在

【https://fabricmc.net/develop/template/】

可以自定義模組的基本信息，且能夠即時更新上述內(nèi)容。

③Minecraft Dev。它是IntelliJ IDEA一個專門用來編寫Minecraft模組的插件。官網(wǎng)是【https://mcdev.io】，也可以在IDEA軟件內(nèi)直接下載，亦或是IDEA官方插件（Plugin）網(wǎng)站內(nèi)下載

【https://plugins.jetbrains.com/plugin/8327-minecraft-development】

它用來配置模組時比Fabric官方的模板模組生成器更加復(fù)雜。

·Minecraft Dev使用。

3、模組參數(shù)調(diào)制。

模組文件夾里有一個文件，文件名是“gradle.properties”，它就是這個模組的基本信息。以下為舉例和說明。

4、在中國加速fabric構(gòu)建的方法。

以項目模式打開fabric模組文件有兩種辦法，第一種是直接打開模組文件夾內(nèi)的“build.gradle”文件，第二種是打開IDEA后再用程序打開模組文件夾，兩種情況下IDEA會自動識別并生成項目。

在打開文件之后IDEA會自動進(jìn)行模組配置（Gradle），此時IDEA右下角會出現(xiàn)一個進(jìn)度條，左下角“Build”內(nèi)會顯示配置的進(jìn)度。配置完成之后我們就可以開始正式制作模組了。但是問題來了，在大多數(shù)情況下，國內(nèi)配置模組的速度非常慢，甚至可能達(dá)到幾小時。以下是一些解決辦法。

①②來自【https://fabricmc.cn/2021/06/28/如何加速Fabric模組的構(gòu)建】③來自fabricwiki，和模組配置有點關(guān)系。

①讓 Gradle 使用代理的方案(推薦)

Gradle 不會根據(jù)系統(tǒng)的全局代理方案的啟動而自動設(shè)定自身的代理方案，它需要一點小小的幫助才會使用代理。

Gradle 的代理分為兩種方案：項目方案，全局方案。其中項目方案會針對當(dāng)前項目進(jìn)行設(shè)定，而全局方案會對所有 Gradle 項目進(jìn)行設(shè)定

·項目代理：在我們當(dāng)前的 Fabric 模組文件夾之下會有一個 gradle.properties

·全局代理：在對應(yīng)操作系統(tǒng)之下存在一個.gradle 文件夾，在其中新建 gradle.properties 文件即可

選擇好你的目標(biāo)之后，寫入以下內(nèi)容到文件內(nèi)。重啟 IDEA 即可。

在這其中，代理的地址127.0.0.1以及代理端口10809需要自行替換為自己的代理配置，以及需要同時配置https以及http代理，方可讓 Gradle 正常工作。

另外，如果有需要的話請在noProxyHosts添加不需要通過代理的地址，這樣可以避免 Gradle 通過代理拉取國內(nèi)的內(nèi)容。

②切換?Fabric?以及?MavenCenter?源，加速 Gradle 拉取內(nèi)容

需要將settings.gradle替換為以下內(nèi)容，加速 fabric-loom 的下載

感謝hanbings提供的?FabricMC 鏡像服務(wù)站，讓國內(nèi)開發(fā)者能有更好的開發(fā)體驗。

③可選，但推薦做的一件事： IDEA 默認(rèn)使用 Gradle 來構(gòu)建你的項目，而這在 Fabric 是不必要的，而且會導(dǎo)致構(gòu)建時間變長以及熱交換（hotswapping）相關(guān)的種種問題。以下是讓 IDEA 使用默認(rèn)編譯器的步驟：

1. 在 Gradle 頁面里打開“Gradle 設(shè)置（Gradle ? ? ?Settings）”

2. 將“使用此工具構(gòu)建和運(yùn)行（Build and run ? ? ?using）”和“使用此工具運(yùn)行測試（Run ? ? ?tests using）”選項改成“IntelliJ ? ? ?IDEA”。

3. 進(jìn)入 文件（File）→ 項目結(jié)構(gòu)…（Project Structure…）→ ? ? ?項目（Project）然后將模塊編譯輸出路徑（Project compiler ? ? ?output）改成?$PROJECT_DIR$/out。

不幸的是，目前還不能給“使用此工具構(gòu)建和運(yùn)行”和“使用此工具運(yùn)行測試”設(shè)置一個全 IDE 內(nèi)的默認(rèn)值，所以這些每創(chuàng)建一個新項目都得重復(fù)上述步驟。

第四節(jié) IDEA內(nèi)部配置

1、生成 Minecraft 源代碼

閱讀 Minecraft 源代碼是編寫模組時的重要一部分。但是，我們不能發(fā)布 Minecraft 的源代碼，因為這違反了 Minecraft 的最終用戶許可協(xié)議（EULA）。你需要自己生成 Minecraft 源代碼。（不過IDEA 已經(jīng)自帶反編譯功能，所以生成不生成都隨意）

要生成 Minecrat 源代碼，運(yùn)行 gradle任務(wù)genSources。如果你的 IDE 沒有嵌入gradle，在終端內(nèi)運(yùn)行以下命令：./gradlew genSources。反編譯可能需要一段時間，取決于計算機(jī)的能力。你可能需要在運(yùn)行任務(wù)之后刷新 gradle。

2、在IDEA內(nèi)部運(yùn)行Minecraft。（這樣調(diào)試模組的時候就不用導(dǎo)出模組了，方便了特別多）

①推薦做法：在終端輸入./gradlew idea進(jìn)行配置。配置成功后右上角會出現(xiàn)“Minecraft Client”和“Minecraft Server”，前者為本地端，后者為服務(wù)端。之后點擊旁邊的綠三角就可以運(yùn)行Minecraft了。

②便捷做法：配置完成后點擊右側(cè)欄的“Gradle”，在模組名下的“Tasks”內(nèi)的“fabric”中有個“runClient”和“Server”，前者為本地端，后者為服務(wù)端。

相關(guān)文章

①https://fabricmc.net/wiki/zh_cn:tutorial:setup

②https://fabricmc.cn/2021/06/28/如何加速Fabric模組的構(gòu)建/

③https://github.com/Mouse0w0/MinecraftDeveloperGuide#fabric模組開發(fā)

④https://imxiaoanag.gitbook.io/minecraft-fabric-mod/