JVM 选项与环境变量

JVM 选项

HMCL 提供了一些 JVM 选项用于调试目的。你可以通过在启动 HMCL 时添加这些参数来使用这些功能。

参数	描述
`-Dhmcl.home=<path>`	覆盖 HMCL 全局数据文件夹路径
`-Dhmcl.dir=<path>`	覆盖 HMCL 工作路径下的 .hmcl 文件夹路径
`-Dhmcl.self_integrity_check.disable=true`	禁用启动器更新时的本体完整性检查
`-Dhmcl.bmclapi.override=<url>`	自定义 BMCLAPI 的 API Root 地址（默认为 `https://bmclapi2.bangbang93.com`）
`-Dhmcl.font.override=<font family>`	指定启动器使用的字族
`-Dhmcl.version.override=<version>`	手动指定启动器版本号
`-Dhmcl.update_source.override=<url>`	自定义 HMCL 更新源地址
`-Dhmcl.authlibinjector.location=<path>`	指定本地 authlib-injector 路径，不从网络下载
`-Dhmcl.openjfx.repo=<maven repository url>`	添加用于下载 OpenJFX 的自定义 Maven 仓库地址（默认为 `https://repo1.maven.org/maven2`）
`-Dhmcl.native.encoding=<encoding>`	指定系统原生编码
`-Dhmcl.microsoft.auth.id=<App ID>`	自定义 Microsoft OAuth 应用程序 ID
`-Dhmcl.microsoft.auth.secret=<App Secret>`	自定义 Microsoft OAuth 应用程序密钥
`-Dhmcl.curseforge.apikey=<key>`	自定义 CurseForge API 密钥
`-Dhmcl.discoapi.override=<url>`	自定义 DiscoAPI 的 API Root 地址（默认为 `https://api.foojay.io/disco/v3.0`）
`-Dhmcl.native.backend=<auto/jna/none>`	指定 HMCL 的本地后端类型。可选值： - `auto`：自动选择（Windows 7+ 使用 JNA，其他系统不使用） - `jna`：强制使用 JNA（如果 JNA 不可用会抛出异常） - `none`：禁用 JNA 默认值：`auto`
`-Dhmcl.hardware.fastfetch=<true/false>`	是否使用 fastfetch 获取设备信息。默认值：`true`

环境变量

HMCL/HMCLauncher 也支持一些环境变量来配置启动器的行为。你可以在系统环境变量中添加这些变量。

参数	描述
`HMCL_JAVA_OPTS`	自定义 HMCLauncher 所使用的 JVM 启动参数（默认为 `-XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=15` 或 `-Xmx1G -XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=15`）
`HMCL_JAVA_HOME`	自定义 HMCLauncher 所使用的 Java 路径
`HMCL_FONT`	指定启动器使用的字族
`HMCL_JRES`	添加 HMCL 所使用的 Java 路径，支持写入多个路径

如何使用 JVM 选项

你可以通过以下几种方式使用这些 JVM 选项。

直接在命令行中添加

在启动 HMCL 时通过命令行添加参数，例如：

java -Dhmcl.home="D:/Games/HMCL" -jar HMCL.jar

创建启动脚本

Windows 用户可以创建 .cmd 文件：

@echo off
java -Dhmcl.font.override="Microsoft YaHei" -jar HMCL.jar
pause

Linux/macOS 用户可以创建 .sh 文件：

#!/bin/bash
java -Dhmcl.font.override="Noto Sans CJK SC" -jar HMCL.jar

如何使用环境变量

Windows 设置环境变量

右键点击“此电脑”/“这台电脑”/“我的电脑”，选择“属性”
点击“高级系统设置”
点击“环境变量”
在“用户变量”或“系统变量”中点击“新建”
输入变量名（如 HMCL_JAVA_HOME）和变量值
点击“确定”保存

示例值：

变量名: HMCL_JAVA_HOME
变量值: C:\Program Files\Java\jdk-17

Linux/macOS 设置环境变量

编辑你的 Shell 配置文件（比如 ~/.bashrc、~/.zshrc 等）

添加 export 语句：

export HMCL_JAVA_HOME="/usr/lib/jvm/java-17-openjdk"
export HMCL_JAVA_OPTS="-XX:MinHeapFreeRatio=5 -XX:MaxHeapFreeRatio=15"

保存文件并重新加载配置：

source ~/.bashrc  # 或 `source ~/.zshrc`