千舸竞流写于2023年2月19日，3月19日发布于哔哩哔哩（774662369257193493/cv22500514）

第一节 下载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环境

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

变量名：JAVA_HOME
变量值：C:\Program Files\Java\jdk-17                            //根据自己实际路径配置
变量名：CLASSPATH
变量值：.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;    //记得前面有个"."
变量名：Path
变量值：%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin;

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

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

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

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

·配置IDEA

第三节 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”，它就是这个模组的基本信息。以下为举例和说明。

#这个是配置模组时设置的内存大小，默认为1G，可以适当调大，但一般没有必要。
org.gradle.jvmargs=-Xmx1G
org.gradle.parallel=true
#这个是Fabric模组的基本信息，用fabric-example-mod制作最新版模组时需要去检查一下是否为最新版的内容。模组版本随游戏版本更新的时候也需要更新这一部分。
#新版内容可在Fabric官网内：【https://fabricmc.net/develop/】查到，同时还包含了下文的Fabric API。
minecraft_version=1.19.3
yarn_mappings=1.19.3+build.5
loader_version=0.14.14
#下面是模组的自定义内容，从上到下依次是模组版本（自定），模组主文件夹位置，模组名。
mod_version = 1.0.0
maven_group = com.example
archives_base_name = fabric-example-mod
#下面是fabric API的版本。
fabric_version=0.73.2+1.19.3

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 即可。

systemProp.http.proxyHost=127.0.0.1
systemProp.http.proxyPort=10809
systemProp.https.nonProxyHosts=10.*|localhost

systemProp.https.proxyHost=127.0.0.1
systemProp.https.proxyPort=10809
systemProp.https.nonProxyHosts=10.*|localhost

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

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

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

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

pluginManagement {
    repositories {
        maven {
            name = 'Fabric'
            url = 'https://repository.hanbings.io/proxy'
        }
        gradlePluginPortal()
    }
}

同时在build.gradle中的repositories节点修改为以下内容，用于加速 FabricAPI 的下载

repositories {
    maven {
        url 'https://maven.aliyun.com/nexus/content/groups/public'
    }
    maven {
        url 'https://repository.hanbings.io/proxy'
    }
}

感谢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/