Gearheaven Core

Gearheaven 整合包的核心自定义模组。本仓库负责承载需要由 Java 与 NeoForge 实现的整合包专用逻辑；整合包本体位于当前工作区的 ../Gearheaven/。

当前项目是可运行的空白模组骨架，只包含模组入口和基础元数据，不包含示例方块、物品或配置。

技术版本

组件	版本
Minecraft	1.21.1
NeoForge	21.1.248
Java	21
Gradle	9.2.1
ModDevGradle	2.0.143

NeoForge 版本与 ../Gearheaven/pack.toml 保持一致。

• 模组 ID：gearheaven
• 基础包名：xdu.undarubra.gearheaven
• 当前版本：0.1.0
• 许可证：All Rights Reserved

开发环境

1. 安装 IntelliJ IDEA 和 JDK 21。
2. 在 IntelliJ IDEA 中打开本仓库根目录，并将其作为 Gradle 项目导入。
3. 确认 Gradle JVM 使用 JDK 21，等待依赖下载和项目同步完成。
4. 使用 IDE 生成的 Client、Server、Data 运行配置，或直接运行下方的 Gradle 命令。

项目使用 Gradle Wrapper，不需要单独安装 Gradle。

常用命令

macOS 与 Linux：

./gradlew build
./gradlew runClient
./gradlew runServer
./gradlew runData

Windows：

.\gradlew.bat build
.\gradlew.bat runClient
.\gradlew.bat runServer
.\gradlew.bat runData

各命令用途：

• build：编译并生成可分发的模组 JAR。
• runClient：启动包含 Gearheaven 的开发客户端。
• runServer：启动开发服务端；首次运行需要在 run/server/eula.txt 中接受 Minecraft EULA。
• runData：运行数据生成器，输出到 src/generated/resources/。

构建产物位于：

build/libs/gearheaven-<版本>.jar

版本与元数据管理

• gradle/libs.versions.toml：集中管理 Gradle、Java、Minecraft、NeoForge、Parchment 和构建插件版本。
• gradle.properties：管理模组 ID、名称、版本、包名、作者、许可证和描述。
• build.gradle.kts：定义 NeoForge 开发环境、运行配置、资源生成和发布配置。
• src/main/templates/META-INF/neoforge.mods.toml：构建时展开的模组元数据模板。

修改 Gradle 文件后，需要在 IntelliJ IDEA 中重新加载 Gradle 项目。

目录结构

.
├── build.gradle.kts
├── settings.gradle.kts
├── gradle.properties
├── gradle/
│   ├── libs.versions.toml
│   └── wrapper/
└── src/main/
    ├── java/xdu/undarubra/gearheaven/
    │   └── Gearheaven.java
    └── templates/META-INF/
        └── neoforge.mods.toml

build/、run/、IDE 配置和 Gradle 本地缓存均由 .gitignore 排除，不应提交到仓库。