mindustry

Mindustry 是一款开源的实时战略游戏，将塔防与自动化相结合：玩家通过构建和连接生产链来为防御提供资源，而不仅仅是放置炮塔。该游戏使用 Java 编写，并在 GitHub 上公开开发，其 README 文件将其简单描述为“自动化塔防 RTS 游戏”。 平台与分发 该项目可编译为桌面客户端、Android 客户端和独立服务器版本。预构建的发布版本托管于 GitHub，README 中也链接了 itch.io、Google Play、F-Droid 和 Flathub 的下载地址。每个提交都会在单独的构建仓库中生成自动更新的最新版本，方便测试者无需自行编译即可跟进开发进度。 从源码构建 贡献代码需要 JDK 17，README 明确指出这一点（其他 JDK 版本无法使用）。构建系统采用 Gradle，Windows 和 Linux/Mac 均配有包装脚本。常用命令包括 `gradlew desktop:run` 运行游戏、`gradlew desktop:dist` 打包桌面 JAR、`gradlew server:dist` 构建服务器版本、`gradlew tools:pack` 打包精灵图。Android 构建依赖 Android SDK 命令行工具，需设置 `ANDROID_HOME`、通过 sdkmanager 接受许可协议并启用设备开发者模式；`gradlew android:assembleDebug` 生成未签名 APK，`gradlew android:installDebug android:run` 则安装并在连接设备上运行。输出路径分别为 `desktop/build/libs/Mindustry.jar` 和 `server/build/libs/server-release.jar`。README 还列出了常见的权限拒绝问题解决方法（`chmod +x ./gradlew`），并提醒首次运行 Gradle 可能需要数分钟下载依赖。 代码生成与架构 项目的一个显著特点是 `mindustry.gen` 包在构建时自动生成，且不在代码仓库中直接存在。README 解释了其来源：`Call` 和数据包类来自标注有 `@Remote` 注解的方法；实体类如 `Unit`、`EffectState` 和 `Posc` 来自 `mindustry.entities.comp` 中的组件类，并通过 `mindustry.content.UnitTypes` 中的定义组合生成；`Sounds`、`Musics`、`Tex` 和 `Icon` 则由对应的资源文件夹自动生成。该生成包被标记为不应手动编辑。 社区与贡献 项目维护了一份贡献指南，涵盖代码风格和拉取请求期望。新贡献者可参考独立的 Mindustry-Suggestions 仓库中的“candidate”标签问题，该仓库也是功能请求和反馈的提交地。README 中还链接了用于发布计划的 Trello 板、项目维基、生成的 Javadoc 以及活跃的 Discord 社区。