Minecraft Forge 1.20.1 模组制作（1）：IDEA 开发环境搭建

不知不觉做模组已经两年了。从Java新手开始，踩了不少坑，也无数次地因为不了解Minecraft原版或Forge机制而花了很多额外的时间。因此，我想在这里做一个简易的教程，同时也作为自己的一个笔记。

在这一篇教程中，我们会将Forge提供的模板项目导入IDEA开发环境，最终能够在IDE中打开调试游戏。

1.        配置Java和Gradle环境变量

MC 1.20.1需要JDK17和Gradle 8。到官网下载相应版本并安装。

随后，我们需要首先配置环境变量，以使系统能够识别Java和Gradle。打开系统属性->高级->配置环境变量（Win10+左下角搜索env可直接找到）。

1.1        Java环境变量

在系统变量中增加变量：变量名：JAVA_HOME，值为Java安装目录（即包含bin和lib两个文件夹的目录）。例如：

H:\Java\jdk17

在系统变量的Path变量中增加条目：

%JAVA_HOME%\bin
%JAVA_HOME%\jre\bin

"%JAVA_HOME%"表示对此前我们定义的变量"JAVA_HOME"的引用。这两个条目相当于：

H:\Java\jdk17\bin
H:\Java\jdk17\jre\bin

保存退出。在命令行中输入：

java -version

如果显示Java版本则表示环境变量配置成功。

1.2        Gradle环境变量

同理，增加变量：变量名"GRADLE_HOME"，值为Gradle安装目录，即包含bin和lib两个文件夹的目录）。例如：

H:\Gradle\gradle-8.3

在Path变量中增加条目：

%GRADLE_HOME%\bin

保存退出。在命令行中输入：

gradle -version

如果显示Gradle版本则表示环境变量配置成功。

2.        下载和导入模板项目

Minecraft 1.20.1的项目模板（MDK）可以在官网下载到：

https://maven.minecraftforge.net/net/minecraftforge/forge/1.20.1-47.4.0/forge-1.20.1-47.4.0-mdk.zip

解压缩到项目文件夹。打开Intellij IDEA，选择File -> Open，选择刚才解压的项目模板文件夹。第一次打开时需要下载大量依赖文件，需要等待大约十分钟。由于国内（大陆）连接国外的一些数据仓库比较卡慢，下载容易超时报错，建议使用代理服务器。

如果挂代理以后导入项目时立刻报“找不到资源”类的错误，可能是IDEA的代理没配置好，前往File -> Settings，搜索HTTP Proxy，手动配置端口即可。

构建完成后，右侧Gradle选项卡下应当出现选项。选择Tasks -> forgegradle runs -> genIntellijRuns，等待执行完成。执行完成后，点击下方所示按钮刷新项目，等待执行完成。

执行完成后，选择上方debug选项 -> runClient ，按debug打开调试游戏。

如果成功，应当弹出一个Minecraft游戏窗口。