HMCL启动器命令行参数：高级用户指南
项目地址: https://gitcode.com/gh_mirrors/hmc/HMCL HMCL启动器（Launcher.java）作为一款多功能跨平台的Minecraft启动器，提供了丰富的命令行参数支持，满足高级用户的自动化和定制化需求。本文将系统介绍这些参数的使用方法与应用场景，帮助用户通过命令行实现启动器的精细化控制。
参数解析机制
HMCL的命令行参数处理逻辑主要分布在两个核心类中：
- 启动入口：Launcher.java的
main方法负责初始化应用并分发参数 - 更新处理：UpdateHandler.java的
processArguments方法专门处理更新相关参数
参数解析流程采用了优先级机制，更新相关参数（如--apply-to）会被优先处理，处理成功后将直接退出当前进程。
核心命令行参数
更新管理参数
| 参数格式 | 功能描述 | 使用场景 |
|---|---|---|
--apply-to <path> | 将下载的更新包应用到指定路径的HMCL主程序 | 自动更新流程中的核心参数 |
| 无显式参数 | 嵌套应用检测与旧版本迁移 | 版本升级后的首次启动 |
示例：手动触发更新应用
java -jar HMCL.jar --apply-to /path/to/old/HMCL.jar
系统属性参数
HMCL支持通过Java系统属性（-D参数）进行高级配置，常用属性包括：
| 属性名 | 取值范围 | 功能说明 |
|---|---|---|
hmcl.directory | 目录路径 | 自定义HMCL配置目录位置 |
java.net.useSystemProxies | true/false | 是否使用系统代理设置 |
http.agent | 字符串 | 自定义HTTP请求头标识 |
示例：指定自定义配置目录并启用系统代理
java -Dhmcl.directory=/custom/config -Djava.net.useSystemProxies=true -jar HMCL.jar
高级应用场景
自动化更新脚本
结合--apply-to参数，可实现HMCL的无人值守更新：
#!/bin/bash
# 下载最新版本
wget -O HMCL-new.jar https://example.com/latest.jar
# 应用更新
java -jar HMCL-new.jar --apply-to /opt/HMCL/HMCL.jar
# 重启启动器
nohup java -jar /opt/HMCL/HMCL.jar &
多实例隔离运行
通过hmcl.directory参数可实现多个独立的HMCL工作环境：
# 启动纯净版环境
java -Dhmcl.directory=~/.hmcl-vanilla -jar HMCL.jar &
# 启动模组开发环境
java -Dhmcl.directory=~/.hmcl-dev -jar HMCL.jar &
诊断与调试
当启动器出现异常时，可通过系统属性启用详细日志：
java -Dhmcl.debug=true -jar HMCL.jar
日志文件将生成在Metadata.HMCL_DIRECTORY指定的目录下，默认路径为~/.hmcl/logs。
参数处理流程图
注意事项
- 参数优先级：命令行显式参数 > 系统属性 > 配置文件设置
- 路径规范：所有路径参数应使用绝对路径，避免相对路径导致的不可预期行为
- 权限要求：
--apply-to参数需要对目标文件具有写入权限 - 版本兼容性：部分高级参数可能随版本变化，建议通过Main.java查看最新实现
问题排查
参数无效问题
若命令行参数未生效，可按以下步骤排查：
- 检查参数拼写与位置，确保所有
-D参数位于-jar之前 - 查看启动日志，确认参数是否被正确解析：
grep "HMCL Directory" ~/.hmcl/logs/latest.log - 验证目标文件权限，特别是使用
--apply-to参数时
更新失败处理
当使用--apply-to参数更新失败时：
- 检查源文件完整性：IntegrityChecker.java
- 手动验证文件哈希：
sha256sum HMCL.jar - 清理临时文件后重试：
rm -rf ~/.hmcl/temp/*
扩展阅读
-
源码参考：
- 参数处理核心逻辑：UpdateHandler.java
- 启动配置初始化：Main.java
-
相关模块：
- 配置系统：ConfigHolder.java
- 日志系统：Metadata.java中的日志目录定义
通过灵活运用这些命令行参数，用户可以构建高效的HMCL自动化工作流，实现从版本更新到多环境管理的全流程控制。对于企业级部署或服务器管理场景，这些参数尤为重要。
图示：HMCL命令行参数处理流程示意图，展示了从参数解析到应用启动的完整路径
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
