使用VScode搭建基于Forge的Minecraft模组开发环境
-
- 1.介绍
- 2.下载和安装JDK
- 3.配置环境变量
- 4.下载和安装VScode
- 5.配置VScode
- 6.下载和导入MDK
- 7.启动Minecraft
1.介绍
看到网络上没有使用VScode开发模组的教程，于是记录下我自己的经验供大家参考，如果有错误或更好的建议烦请在评论区留言，转载请注明来源，谢谢！
目前的Forge模组开发主要使用Ecplise或者IntelliJ IDEA，这些IDE的界面和操作对于没什么Java开发基础的初学者来说有些复杂难懂。如果你不仅仅在使用Java这一种语言，或是你觉得使用专业的IDE来制作Mod有些大材小用。。。。
不管怎样，只要你是想用VScode开发，那么，这篇教程一定对你有所帮助！
本教程主要讲解的是在Windows10-x64系统下（没用过Linux和Mac ） VScode搭建基于Forge的Minecraft（1.14.4-1.16.4）模组开发环境，并不教授模组的制作，Forge模组制作参见其它教程。
模组制作教程可以在MCBBS的编程开发板块找到。这里贴两个：
- MCBBS楼主FledgeXu的教程：
Neutrino——面向初学者者的 1.15 Mod 开发教程
- MCBBS楼主3TUSK的教程：
Harbinger - 面向中文社区的 1.12.2 Forge Mod 开发指南
那么，我们开始吧！
2.下载和安装JDK
VScode想要搭建Forge的开发环境需要同时安装两个JDK的版本，分别是jdk-8u271和jdk-11.0.9，至于为什么是两个，待会儿会讲到。
jdk8u271下载地址：https://www.oracle.com/cn/java/technologies/javase/javase-jdk8-downloads.html
jdk-11.0.9下载地址：https://www.oracle.com/java/technologies/javase-jdk11-downloads.html
需要登陆Oracle账户才能下载的话就自己创建一个好了，以后或许还要用上。
下载完后就是安装了。先安装哪个都无所谓，全都直接点击下一步就OK，不建议更改安装位置，以防止环境变量配置错误。
3.配置环境变量
安装完两个JDK后，开始配置JDK的系统变量。
步骤：打开设置——系统——关于——高级系统设置（20H2及更高）
注意，如果你的系统版本低于20H2，则按以下步骤进行：
打开设置——系统——关于——系统信息——高级系统设置
进入高级系统设置后在下面点击环境变量，然后在系统变量处点击新建，你需要新建以下三个变量：
其中JAVA_HOME的值所指向的是你需要使用的JDK版本。
目前我们只需要使用jdk-8u271（即jdk1.8.0_271），如果你需要使用jdk-11.0.9，只需将JAVA_HOME中的值改为%JAVA_HOME11%就行了。
新建完以上变量后，在系统变量中选中Path，点击编辑，然后新建、删除以下两个变量
千万注意不要删错了！（那两个需要删除的变量对应的文件夹可删可不删）
配置完系统变量后，我们来验证一下JDK环境是否搭建成功。按Win + R键输入
cmd
回车打开命令窗口，分别输入以下两个命令回车：
1 | Java -version |
1 | javac -version |
结果下如图所示，则表明你的系统环境配置成功：
至此，JDK的安装大功告成！接下来开始VScode的下载安装和配置。
4.下载和安装VScode
下载地址：https://code.visualstudio.com/#alt-downloads
选择System Installer 64bit版下载：
下载完安装，安装不建议更改安装路径，注意以下其它中的选项都勾上：
5.配置VScode
安装完打开VScode，点击最左边的扩展图标，在搜索框中搜索以下几个扩展并点击绿色的Install按钮安装
以下三个为必须安装：
| 扩展名 | 作用 |
|---|---|
| Java Extension Pack | 提供java语言支持 |
| Gradle Extension Pack | 提供Gradle构建工具支持 |
| Visual Studio IntelliCode | 智能代码提示 |
以下四个自愿安装：
| 扩展名 | 作用 |
|---|---|
| Chinese (Simplified) Language Pack for Visual Studio Code | 提供中文界面支持 |
| indent-rainbow | 使缩进更加明显 |
| TOML Language Support | 提供.toml文件的语法支持 |
| vscode-icons | 使文件和文件夹显示对应图标 |
扩展安装完后重启一下计算机。
接下来配置VScode的JDK版本。
打开VScode，按Ctrl + ,打开设置（或者点击左下角齿轮选择设置），搜索
Java home
点击在setting.json中编辑，如图所示：
全选，用以下代码覆盖（如果你安装了所有扩展）：
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 | {<!-- --> "editor.suggestSelection": "first", "vsintellicode.modify.editor.suggestSelection": "automaticallyOverrodeDefaultValue", "java.semanticHighlighting.enabled": true, "files.autoSave": "off", "workbench.startupEditor": "newUntitledFile", "workbench.activityBar.visible": true, "workbench.sideBar.location": "left", "java.configuration.runtimes": [ {<!-- --> "name": "JavaSE-1.8", "path": "C:\\Program Files\\Java\\jdk1.8.0_271", "default": true }, {<!-- --> "name": "JavaSE-11", "path": "C:\\Program Files\\Java\\jdk-11.0.9", }, ], "java.configuration.checkProjectSettingsExclusions": false, "java.refactor.renameFromFileExplorer": "autoApply", "files.autoGuessEncoding": true, "explorer.confirmDelete": false, "window.zoomLevel": 0, "explorer.confirmDragAndDrop": false, "java.home": "C:\\Program Files\\Java\\jdk-11.0.9", "workbench.iconTheme": "vscode-icons", "editor.renderControlCharacters": false } |
效果如图所示：
如果你只安装了必须的扩展，需删除以下代码：
1 | "workbench.iconTheme": "vscode-icons", |
保存后重新打开VScode。接下来我们来试试是否成功：
按Ctrl + Shift + P，输入
>java
选择创建java项目，选择No build tools，选择一个放Java项目的文件夹，输入项目名并回车，这样就新建了一个java项目。然后在资源管理器中打开src文件夹，双击App.java，按F5调试，输出结果为：
Hello, World!
如果右下角弹出错误的弹窗，重启VScode试试，还是不行则是你之前哪里设置出了问题，重新检查设置或是问问度娘或评论区留言吧。
另外，现在解答之前的疑问。之所以安装两个版本的JDK，是因为
Language Support for Java? by Red Hat
这个拓展更新到0.65.0版本的原因。Eclipse平台决定将JDK11作为9月发布的最低要求，而VScode是依赖eclipsejdt.ls服务器的，所以需要更新到JDK11。（摘自博主ElasticForce在Vscode中不再支持JDK8的解决方案中的一段话）
现在，我们安装和配置完成了VScode，接下来就是最难的部分：下载和导入Forge MDK。
6.下载和导入MDK
MDK可以在Forge官网下载和其它网友推荐的地址下载。
Forge官方网址：https://files.minecraftforge.net/
我这里选的是1.16.4的版本来介绍（1.14.4-1.16.4都行），右键复制链接，新建一个标签页，粘贴后砍掉最前面的
https://adfoc.us/serve/sitelinks/?id=271228&url=
这一截（Forge作者震怒 ），然后回车下载：
下载后解压到一个文件夹中，文件夹不能含有中文字符或空格等非法符号！
右键这个解压的文件夹，选择通过code打开，然后右下角弹窗选择Yes（防火墙也需要选择允许）:
导入的过程只有漫长的等待。
由于网络原因，以上过程会经常失败，失败需要关闭VScode重新导入。也可以使用网友们分享的地址下载离线包再导入。这里只列出两个：
- MCBBS楼主FledgeXu的地址：
https://github.com/FledgeXu/ForgeGradleOffline/tags
- MCBBS楼主耗子的地址：
Minecraft模组开发离线包
离线包的使用教程参见下载的网站。离线包初次用VScode打开也需要花一段时间来导入，但不会太久，失败了同样重新打开导入。
当问题中只有一个警告（没有错误），且右下角显示点赞（暗示 ）的图标时表明导入成功：
导入成功后，点击最左边的Gradle图标，然后在GRADLE TASKS中选择fg_runs文件夹，点击文件genVSCodeRuns右侧三角形运行（没有显示这些文件说明你前面还没有成功导入），构建成功后在终端提示如图：
回到资源管理器，打开src\main\java\com\example\examplemod\ExampleMod.java文件：
这是Mod源码，是MDK用来占位的，没有什么作用，自己开发Mod把这个删了就行。样例Mod中的一些内容也值得看看，其中的注释或许对你有所帮助！
7.启动Minecraft
现在，按下F5进行调试。Minecraft，启动！
初次启动会多花一段时间，下次就快了。
哦，听着这美妙的音乐，我疲惫的心灵都得到了升华。。。。
来看看Mod列表：
Mod成功运行！
至此，本教程结束，感谢大家的耐心阅读，谢谢！
转载请注明来源！