Minecraft Forge编程入门一 “环境搭建”

什么是Forge

Minecraft Forge is a Minecraft application programming interface (API) which allows almost maximum compatibility between other Forge mods. It contains a clean room rewrite of RML (Risugami's Modloader) which allows compatibility with modloader mods. It contains hooks into the base Minecraft files that allows modders to make their mods more advanced without editing base classes.

以上是官网wiki的介绍，大体说的是Forge是Minecraft程序的开发api，使用它来开发Minecraft的mod可以于其他的mod有比较大的兼容性。并且它还包含了一个FML（forge mod loader）来加载mod。

forge的api包涵很多特性，比如add plant(增加植物)，Add Sleep Handlers(添加睡眠处理)等。

开发环境搭建

我这里是用的是mac os系统，建议使用linux或mac os系统，强烈反对windows系统别问为什么。

获取forge源码

第一步要做的就是获取forge的源码，可以通过官网http://files.minecraftforge.net选择合适的版本进行下载。

选择Mdk进行下载

解压源码

下载完上面的文件后解压，你可以在src/main/java中看到一些实例代码和一些其它文件。

复制一下文件几目录

• src/
• build.gradle
• gradlew (both .bat and .sh)
• gradle/

在本地你喜欢的位置新建一个目录，将以上复制的内容粘贴到其中。

初始化工作空间

打开终端，进入到上面你新建的目录，使用命令

./gradlew setupDecompWorkspace

来初始化工作环境，这一过程主要下载一些用于forge和Minecraft的编译和构建的文件，而且可能需要翻墙，持续十分钟左右。若gradlew没有运行权限，可使用chmod对其进行权限设置：

chmod 777 gradlew

选择开发工具

推荐使用Eclipse，以下是初始化Eclipse工作环境的命令

在你之前新建的目录下运行：

./gradlew eclipse

它会下载一些eclipse工程相关的配置文件，同样需要翻墙，可能会持续十分钟左右。

导入并运行程序

如果前面两个初始化工作都顺利完成，那么可以导入并运行最原始的mod工程了。

eclipse->file->import->existing projects into workspace->[选择你之前新建的那个工程目录]->OK

导入完工程以后可以看到



类似的工程，其中forge-project就是我新建的目录名字。

接着右击工程名

run as->java application->[找到GradleStart]->OK

运行结果如下：

参考

http://www.minecraftforge.net/wiki/Minecraft_Forge

http://mcforge.readthedocs.org/en/latest/