HMCL 启动器安装与使用教程
1. 项目目录结构及介绍
在HMCL(Hello Minecraft Launcher)项目中,目录结构如下:
HMCL
: 这是HMCL启动器的主要代码库。HMCLCore
: 包含HMCL的核心功能组件。HMCLauncher
: 存放启动器的实现代码。config/checkstyle
: 配置了代码风格检查的相关规则。gradle/wrapper
: Gradle构建工具的相关配置。lib
: 用于存放外部依赖的库文件。minecraft/libraries
: 这里包含了游戏相关的库文件。editorconfig
: 提供了统一的编码风格配置。.gitignore
: 定义了Git忽略的文件列表。LICENSE
: 开源许可证,这里是GPLv3。PLATFORM.md
: 平台兼容性指南。PLATFORM_cn.md
: 平台兼容性的中文版指南。README.md
: 主要介绍了HMCL的功能、特点以及下载地址。README_cn.md
: README的中文版本。build.gradle.kts
: 项目的构建脚本,Kotlin DSL语法。config-jenkins.sh
: Jenkins自动化构建配置文件。gradlew
和gradlew.bat
: Gradle wrapper的可执行脚本,分别适用于Unix和Windows系统。javafx.gradle.kts
: 关于JavaFX的构建配置。settings.gradle.kts
: 项目的Gradle设置文件。
2. 项目启动文件介绍
HMCL的启动主要通过以下文件完成:
gradlew
或gradlew.bat
: 根据你的操作系统,运行这个脚本来执行Gradle构建任务。这会编译项目并创建可执行的HMCL启动器。build.gradle.kts
: 在此脚本中,可以找到构建过程的定义,包括如何打包和生成最终的启动器文件。
一旦完成构建,HMCL的可执行文件通常会位于项目输出路径下的某个位置,如build/install/HMCL-launcher/bin
,具体的路径可能取决于你的构建配置。
3. 项目的配置文件介绍
HMCL的配置文件主要用于自定义启动器的行为和游戏的参数。虽然源代码仓库中没有直接显示这些配置文件,但在实际使用时,用户会在本地生成或修改以下配置文件:
HMCL
的配置通常保存在用户的个人文件夹内,如~/.hmcl/config.json
(Linux/MacOS)或%APPDATA%\HMCL\config.json
(Windows)。这个文件包含了登录凭据、游戏版本选择、启动参数等信息。- 游戏的特定配置文件,如
saves
目录中的level.dat
,存储了游戏世界的详细信息。 - 如果使用了Mod管理,如Forge或Fabric,还会有关于模组的配置文件位于游戏安装目录下。
请注意,用户配置文件不在项目源码中,而是由HMCL根据用户操作生成或更新的。如果你需要更改配置,应通过启动器提供的界面进行,或者直接编辑上述提及的JSON配置文件。但是不建议非专业人士直接修改配置文件,以免出现问题。