所有命令在仓库根目录执行。开工前运行 git status --short 确认工作区状态。
- 普通
git clone即可;API 源码已内联,无需初始化子模块,来源与版本见附属 API。 - 准备 JDK 17 与 21。core 和 Forge 节点使用 17,NeoForge 节点使用 21;
JAVA_HOME决定启动 Gradle 的 JVM,JAVA17_HOME、JAVA21_HOME用于发现工具链。 - 使用仓库 Wrapper:Linux/macOS 为
./gradlew,Windows PowerShell 为.\gradlew.bat。当前 Wrapper 为 Gradle 8.8,Stonecutter 为 0.7.11。 - 首次运行需要下载 Gradle、插件及游戏依赖。执行
./gradlew --version,按需用./gradlew projects和目标节点的tasks --all查询任务。
配置依据:settings.gradle、Wrapper、工具链属性、CI 环境。
gradle.properties 当前没有代理配置。个人代理或 JDK 路径放用户级 ~/.gradle/gradle.properties,或使用命令行覆盖。local.properties 虽被忽略,本项目没有通用自动读取它的逻辑。
| 目的 | 命令与说明 |
|---|---|
| 编译两个平台 | compile |
| 生成发行模组、公共 API 库或 SDK | assemble;产物区别见该页产物位置 |
| 运行公共 API、core、buildtools 或平台 API 单元测试 | junit |
| 检查外部消费者看到的 API 契约 | api-contracts |
| 格式检查与格式化 | format |
| 启动开发客户端、服务端或可选集成 | manual-ingame |
| 运行 Minecraft 场景测试 | gametest |
改动后的必需检查按验证与验收选择。全仓检查可用 ./gradlew check,但不包含 GameTest;单节点 build 同样不能代替游戏验收。
根 compileJava、runClient、runServer 等兼容入口委托给 Forge 节点。开发运行和单平台检查应明确节点,任务关系见 stonecutter-native.gradle。
优先定位首个实际失败原因(工具链、代理、依赖解析、源码编译、Mixin 或运行期异常)。将失败命令及关键日志保留在 work/<任务名>/,修复真实源输入后重新运行受影响检查,保持本地构建缓存完整。
Forge runData 会写入源码资源,使用前查阅资源指南。