第一节 下载JAVA

1、（这一步并没有什么用）虽然现在启动器基本上都会自己下载和配置JAVA，但是我们还是可以下载一下JAVA。下载地址是

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

平台更加全的列表在

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

2、（这一步才是真的有用）下载JDK是必要的一步。如今（2023年）的Minecraft早就在使用JAVA17了，所以我们制作的模组也要在JAVA17的环境下运行。JAVA17的下载地址是

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

可以选用EXE或者MSI，后者不会被杀毒软件报毒，除此之外两者没有区别。

除此之外，也可以在后文的IDEA中直接下载JDK。将在后文介绍。

3、下载完成后的JAVA默认位置是【C:\Program Files\Java\jdk-17】。推荐不要再安装时改JAVA的安装位置。

4、除了在Oracle官网下载，还可以在Adoptium中下载安装包，下载地址是

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

它的一个好处是会自动配置JAVA环境，也就是说使用这个安装包可以直接跳过下一节手动配置JAVA环境的部分。

·手动配置JAVA环境

这里介绍手动配置的方法。鼠标右击“此电脑”（部分系统显示“我的电脑”），点击二级菜单中的“属性”。 打开后，点击“高级系统设置”，打开后，点击“高级”内的“环境变量”，接下来在“系统变量”内新建变量，内容如下：

第二节 下载集成开发环境（以IntelliJ IDEA为例）

1、IDEA是Minecraft模组制作教程中使用最广泛的一个集成开发环境（IDE），下载地址是

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

我们制作Minecraft模组可以直接使用免费且开源的社区版（Community Edition）。

第三节 Fabric安装与配置

1、（这一步也并没有什么用，这两个是游玩时使用的）Fabric本体与API的下载。

Fabric官网内下载地址是

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

其中可以下载Fabric安装器。

Fabric API下载地址在CurseForge内

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

2、Fabric模组模板下载。

①fabric-example-mod。它是Fabric官方提供的一个模板模组，是初学者非常好的学习材料。下载地址在GitHub

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

缺点是不能够即时更新，像后文要介绍的gradle.properties内的fabric_version、yarn_mappings、loader_version都有可能过时，此时就需要手动配置。

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

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

可以自定义模组的基本信息，且能够即时更新上述内容。

③Minecraft Dev。它是IntelliJ IDEA一个专门用来编写Minecraft模组的插件。官网是【https://mcdev.io】，也可以在IDEA软件内直接下载，亦或是IDEA官方插件（Plugin）网站内下载

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

它用来配置模组时比Fabric官方的模板模组生成器更加复杂。

·Minecraft Dev使用。

3、模组参数调制。

模组文件夹里有一个文件，文件名是“gradle.properties”，它就是这个模组的基本信息。以下为举例和说明。

4、在中国加速fabric构建的方法。

以项目模式打开fabric模组文件有两种办法，第一种是直接打开模组文件夹内的“build.gradle”文件，第二种是打开IDEA后再用程序打开模组文件夹，两种情况下IDEA会自动识别并生成项目。

在打开文件之后IDEA会自动进行模组配置（Gradle），此时IDEA右下角会出现一个进度条，左下角“Build”内会显示配置的进度。配置完成之后我们就可以开始正式制作模组了。但是问题来了，在大多数情况下，国内配置模组的速度非常慢，甚至可能达到几小时。以下是一些解决办法。

①②来自【https://fabricmc.cn/2021/06/28/如何加速Fabric模组的构建】③来自fabricwiki，和模组配置有点关系。

①让 Gradle 使用代理的方案(推荐)

Gradle 不会根据系统的全局代理方案的启动而自动设定自身的代理方案，它需要一点小小的帮助才会使用代理。

Gradle 的代理分为两种方案：项目方案，全局方案。其中项目方案会针对当前项目进行设定，而全局方案会对所有 Gradle 项目进行设定

·项目代理：在我们当前的 Fabric 模组文件夹之下会有一个 gradle.properties

·全局代理：在对应操作系统之下存在一个.gradle 文件夹，在其中新建 gradle.properties 文件即可

选择好你的目标之后，写入以下内容到文件内。重启 IDEA 即可。

在这其中，代理的地址127.0.0.1以及代理端口10809需要自行替换为自己的代理配置，以及需要同时配置https以及http代理，方可让 Gradle 正常工作。

另外，如果有需要的话请在noProxyHosts添加不需要通过代理的地址，这样可以避免 Gradle 通过代理拉取国内的内容。

②切换 Fabric 以及 MavenCenter 源，加速 Gradle 拉取内容

需要将settings.gradle替换为以下内容，加速 fabric-loom 的下载

感谢hanbings提供的 FabricMC 镜像服务站，让国内开发者能有更好的开发体验。

③可选，但推荐做的一件事： IDEA 默认使用 Gradle 来构建你的项目，而这在 Fabric 是不必要的，而且会导致构建时间变长以及热交换（hotswapping）相关的种种问题。以下是让 IDEA 使用默认编译器的步骤：

1. 在 Gradle 页面里打开“Gradle 设置（Gradle      Settings）”

2. 将“使用此工具构建和运行（Build and run      using）”和“使用此工具运行测试（Run      tests using）”选项改成“IntelliJ      IDEA”。

3. 进入 文件（File）→ 项目结构…（Project Structure…）→      项目（Project）然后将模块编译输出路径（Project compiler      output）改成 $PROJECT_DIR$/out。

不幸的是，目前还不能给“使用此工具构建和运行”和“使用此工具运行测试”设置一个全 IDE 内的默认值，所以这些每创建一个新项目都得重复上述步骤。

第四节 IDEA内部配置

1、生成 Minecraft 源代码

阅读 Minecraft 源代码是编写模组时的重要一部分。但是，我们不能发布 Minecraft 的源代码，因为这违反了 Minecraft 的最终用户许可协议（EULA）。你需要自己生成 Minecraft 源代码。（不过IDEA 已经自带反编译功能，所以生成不生成都随意）

要生成 Minecrat 源代码，运行 gradle任务genSources。如果你的 IDE 没有嵌入gradle，在终端内运行以下命令：./gradlew genSources。反编译可能需要一段时间，取决于计算机的能力。你可能需要在运行任务之后刷新 gradle。

2、在IDEA内部运行Minecraft。（这样调试模组的时候就不用导出模组了，方便了特别多）

①推荐做法：在终端输入./gradlew idea进行配置。配置成功后右上角会出现“Minecraft Client”和“Minecraft Server”，前者为本地端，后者为服务端。之后点击旁边的绿三角就可以运行Minecraft了。

②便捷做法：配置完成后点击右侧栏的“Gradle”，在模组名下的“Tasks”内的“fabric”中有个“runClient”和“Server”，前者为本地端，后者为服务端。

相关文章

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

②https://fabricmc.cn/2021/06/28/如何加速Fabric模组的构建/

③https://github.com/Mouse0w0/MinecraftDeveloperGuide#fabric模组开发

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