GradleTemplate

相变晶 DLC 最小可构建运行模板。提供一个空 DLC 骨架——克隆后 ./gradlew runClient 即可启动 Minecraft 26.1.2，直接开始编写内容。

基于 NeoForge + ModDevGradle，预配置 BreakdownKernel 依赖环境。

预配置

开箱已集成相变晶 DLC 开发所需的全部构建设施：

• NeoForge + ModDevGradle — 模组构建
• BreakdownKernel 依赖 — dependencies.gradle 和 mods.toml 已预配置核心依赖
• Kotlin + Lombok — 现代语言特性
• Spotless — Google Java Style 自动格式化
• Maven Publish + Sources Jar — 发布准备就绪

快速开始

git clone -b modDevGradle/26.1.2 https://github.com/PhasetransCrystal/GradleTemplate.git BreakdownYourCategory-name
cd BreakdownYourCategory-name

1. 修改项目标识

编辑 gradle.properties：

mod_group_id=net.ptcrys
mod_id=breakdownyourcategory_name
mod_version=0.1.0

编辑 settings.gradle，修改 rootProject.name。

2. 构建并运行

./gradlew build        # 构建
./gradlew runClient    # 启动测试客户端

目录结构

├── build.gradle              # 构建配置
├── dependencies.gradle       # 依赖声明（已预配置 BreakdownKernel）
├── gradle.properties         # 项目属性
├── settings.gradle           # 项目名
├── gradle/
│   ├── wrapper/
│   └── scripts/              # 复用构建脚本
└── src/
    ├── main/java/            # DLC 源码
    └── main/resources/       # 资产、Data Pack、mods.toml

环境要求

组件	版本
JDK	25
Minecraft	26.1.2
NeoForge	26.1.2.71
Gradle	9.6.1（Wrapper 自带）

开发规范

• 命名：Breakdown<Category>-<name>（如 BreakdownTech-induction）
• 仅依赖 BreakdownKernel api/ 包，禁止引用 impl/
• 配方/结构/研究树通过 Data Pack 定义
• 提交前运行 ./gradlew test && ./gradlew spotlessCheck

详见 组织首页 及内部开发规范。

License

MIT © 2025 PhasetransCrystal — 详见 LICENSE。