Mindustry Java Mod Template

一款适用于Mindustry游戏的Java模组模板，支持Android和PC双平台运行。该模板的Kotlin版本可在此处查看。

构建桌面测试版本

1. 安装JDK 17
2. 执行命令：gradlew jar [1]
3. 生成的模组JAR文件将保存在build/libs目录下。注意：此版本仅适用于桌面测试，无法在Android设备上运行

若需构建Android兼容版本，可通过Github Actions自动构建或手动配置环境，详情如下：

通过Github Actions构建

本仓库已配置Github Actions持续集成，可在每次提交时自动构建模组：

1. 创建以模组命名的Github仓库，上传本模板内容，完成修改后提交并推送
2. 在仓库页面点击"Actions"标签，选择最新的构建记录
3. 构建成功后，在"Artifacts"部分找到下载链接（通常以仓库名命名）
4. 下载的是压缩包形式的JAR文件（非直接JAR）[2]，解压后将内部JAR文件导入Mindustry即可。此版本同时兼容Android和PC平台

本地构建（Android+PC兼容版本）

本地构建需要更多设置，但对有Android开发经验的用户不成问题：

1. 下载Android SDK，解压后设置环境变量：ANDROID_HOME指向SDK根目录
2. 确保已安装API级别30及最新版本构建工具（如30.0.1）
3. 将构建工具路径添加到系统PATH：$ANDROID_HOME/build-tools/30.0.1（Windows使用%ANDROID_HOME%）
4. 执行：gradlew deploy
   • 若配置正确，将在build/libs目录生成同时兼容Android和PC的JAR文件

添加依赖项注意事项

重要：所有对Mindustry、Arc及其子模块的依赖必须在Gradle中声明为compileOnly，绝不能使用implementation

• implementation会将整个依赖打包进JAR，这在大多数模组开发中非常不可取（不想让模组包含完整的Mindustry API）
• compileOnly表示依赖仅在编译时存在，不包含在最终JAR中

仅在以下情况使用implementation： 你希望将另一个Java库与模组一起打包，且该库不在Mindustry中已存在

---

[1] Linux/Mac系统使用./gradlew jar，Windows直接使用gradlew jar [2] 这是Github的UI限制，尽管JAR文件本身未压缩上传，但目前无法直接下载单个JAR文件