Lodestone 项目启动与配置教程

1. 项目目录结构及介绍

Lodestone 是一个由 Lodestar 团队开发的开源库，主要用于其所有模组（mods）的后端代码，特别是渲染相关的内容。以下是项目的目录结构及其简要介绍：

Lodestone/
├── gradle/
│   ├── wrapper/
│   └── ...
├── src/
│   └── ...
├── .gitattributes
├── .gitignore
├── Jenkinsfile
├── LICENSE.txt
├── README.md
├── build.gradle.kts
├── gradle.properties
├── gradlew
├── gradlew.bat
└── settings.gradle.kts

• gradle/: 存放项目的构建脚本和相关配置文件。
• src/: 源代码目录，包含所有 Java 和 GLSL 文件。
• .gitattributes: 定义 Git 仓库中特定文件的设置。
• .gitignore: 定义 Git 应该忽略的文件和目录。
• Jenkinsfile: Jenkins 持续集成（CI）的配置文件。
• LICENSE.txt: 项目使用的许可证文件（LGPL-3.0）。
• README.md: 项目的自述文件，包含项目描述、使用说明等。
• build.gradle.kts: Kotlin 编写的 Gradle 构建脚本。
• gradle.properties: Gradle 的属性配置文件。
• gradlew 和 gradlew.bat: Gradle 的命令行包装器，用于执行构建任务。
• settings.gradle.kts: Gradle 的设置文件。

2. 项目的启动文件介绍

Lodestone 项目的启动通常是通过 Gradle 来执行的。主要的启动文件是 build.gradle.kts，它定义了项目的构建逻辑和依赖。

在 build.gradle.kts 文件中，你可以找到以下关键部分：

• plugins: 应用的 Gradle 插件。
• repositories: 定义项目依赖的仓库。
• dependencies: 定义项目依赖的其他库或模块。

要启动项目，你可以在命令行中执行以下命令：

./gradlew run

这会编译项目并运行主应用程序。

3. 项目的配置文件介绍

项目的配置主要通过 gradle.properties 文件进行。以下是可能需要配置的一些属性：

• kotlin_version: 指定 Kotlin 编程语言的版本。
• minecraft_version: 指定支持的 Minecraft 版本。
• mod_name: 定义模组的名称。
• mod_version: 定义模组的版本。

你可以根据需要修改这些属性来适应你的项目需求。例如：

kotlin_version=1.5.31
minecraft_version=1.20.1
mod_name=Lodestone
mod_version=1.4.45

确保在修改配置后重新运行 Gradle 任务以确保配置生效。