目录

构建开发环境

这篇文章是借 Anuken 的官方模组示例来构建并测试环境,所以请先下载好模组示例如果打不开,请使用 github520 或镜像站服务,例如可以将链接内的github.com换成hub.gitfast.org

IDE

如果你不是跟风狗,请等待应用自动向你提示本地化语言包设置中文。

构建

我们需要把下载到的文件放在一个文件夹内,注意不能出现中文特殊字符,如果你下载的文件是zip文档则需要解压缩。

然后,双击打开“build.gradle”文件,如果无误,那么 IJ 就应该启动了,如果您动了默认设置,请将此文件右键设为由 IJ打开。 之后 IJ 就会自动帮我们下载必要的文件,例如 Mindustry的源码。注意:请确保你的网络可以连接到github,请适当使用github520或魔法上网。

接下来检查自己的 JDK版本:确定SDK版本为 1.8 , Language Level使用的是 8 。查询方法为:程序左上角的 Project Structure — Project

如果你这个小疯子执意要用java11或17的话,请在gradle文件里将sourceCompatibility调为你使用的版本,注意:某些版本的功能可能与java8有差异,且不支持unicode字符,如果你还清醒就不要用中文文件夹。另外,可能出现改了还是不能用的情况。去做实验,然后把结果告诉大家。

尝试编译

在 IJ 的侧边栏中,我们找到 Gradle标签页,找到Tutorial/Tasks/build/jar并双击运行。如果没有,请耐心等待至出现。

运行后,在弹出的 RUN 标签页中会打印出运行情况,以及可能存在的报错信息。首次构建可能需要一些时间,请坐和放宽。如果耗时太长,可能是出现了某些错误导致 Java 的死机,请手动重启。如果出现了报错,请耐心按照其指示排查,后附一些常见的错误供查阅。

当你看到 “BUILD SUCCESSFUL” 的字样时,就说明编译成功了,就可以在build/lib找到编译出来的 jar 文件,将其装载到游戏当中了!

至此,您已经成功搭建了 Mindustry 的 Mod 开发环境。

附1:错误排查

出现此类错误请将 build.gradle更改为如下

targetCompatibility = 8
sourceCompatibility = 8
sourceSets.main.java.srcDirs = ["src"]
repositories{
    mavenCentral()
    maven{ url 'https://www.jitpack.io' }
}
ext{
    //the build number that this mod is made for
    mindustryVersion = 'v131'
    jabelVersion = "0.7.0"
    sdkRoot = System.getenv("ANDROID_HOME") ?: System.getenv("ANDROID_SDK_ROOT")
}