HMCL 缩放问题解决方案汇总

[burningtnt]

HMCL 基于的 JavaFX 在部分版本上无法自动跟随系统缩放。本 Discussion 收集了一些解决方案，供大家参考。
您也可在下方留言提出新的建议等。

Windows

• 使用 Java 11 以上版本启动 HMCL
• 添加命令行参数 -Dglass.gtk.uiScale=1.5

Linux, Mac

待补充

[KSSJW]

实测Linux方法与Windows类似(即添加命令行参数)
命令如下：
java -Dglass.gtk.uiScale=1.5 -jar /.../HMCL-XX.jar
（也可以给HMCL创建并编辑.desktop文件，再添加参数，方法因不同桌面环境而异）

测试环境：
Linux：Arch Linux x86_64 6.12.8
DE：Plasma 6.2.5
Java：21.0.5
HMCL：3.6.11

[AstroAbyss]

请问该命令行参数应该在哪里添加？
HMCL：3.6.12.279

[burningtnt]

如果你是 Windows 系统，可以将参数加入 HMCL_JAVA_OPTS 环境变量，HMCLauncher For Windows 会自动读取这一环境变量

[AstroAbyss]

是的，我是Windows 10，忘记说了

[KSSJW]

是的，我是Windows 10，忘记说了
我用Linux久了，看什么都像Linux哈哈😂

[AstroAbyss]

如果你是 Windows 系统，可以将参数加入 HMCL_JAVA_OPTS 环境变量，HMCLauncher For Windows 会自动读取这一环境变量

好吧我还是没搞懂具体要怎么做，是系统的环境变量吗？

[zkitefly]

如果你是 Windows 系统，可以将参数加入 HMCL_JAVA_OPTS 环境变量，HMCLauncher For Windows 会自动读取这一环境变量

好吧我还是没搞懂具体要怎么做，是系统的环境变量吗？

参考 https://docs.hmcl.net/launcher/jvm-options-and-env.html#windows-%E8%AE%BE%E7%BD%AE%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F

[AstroAbyss]

研究出来了，对于Windows系统（个人环境：JDK 24），应使用以下参数：
进入系统环境变量-用户/系统变量
设置 HMCL_JAVA_OPTS 参数为 -Dglass.win.uiScale=1.0
即可恢复正常缩放效果

应该是因为我笔记本设置了缩放比率导致

[AstroAbyss]

不过我不是很清楚这个参数是不是只会影响到HMCL启动器，其他Java程序应该不会被影响到吧

[zkitefly]

不过我不是很清楚这个参数是不是只会影响到HMCL启动器，其他Java程序应该不会被影响到吧

HMCL_JAVA_OPTS 是只用于 hmcl 的，所以不会影响其他 Java 程序

[guankaiqi]

对于Linux系统同理，同样添加环境变量即可：

export HMCL_JAVA_OPTS="-Dglass.gtk.uiScale=1.5"

[zhdbk3]

在 Linux 上，更新到 3.10.2 版本之后，-Dglass.gtk.uiScale=1.25 参数不再起作用，在 3.9.2 版本是正常的

[guankaiqi]

但是在我的机器上这个参数依然有效，启动命令为

export HMCL_JAVA_OPTS="-Dglass.gtk.uiScale=1.25"
bash HMCL-3.10.2.sh

我的系统与桌面环境如下：
OS: Debian GNU/Linux 13 (trixie) x86_64
Kernel: Linux 6.12.48+deb13-amd64
Shell: bash 5.2.37
DE: KDE Plasma 6.3.6
WM: KWin (Wayland)

[zhdbk3]

OS: Arch Linux x86_64
Kernel: Linux 6.18.7-arch1-1
Shell: zsh 5.9
DE: KDE Plasma 6.5.5
WM: KWin (Wayland)

我是从 AUR 安装的 hmcl-bin 软件包。

---

原来我的命令是 hmcl -Dglass.gtk.uiScale=1.25，可以缩放。更新到 3.10.2 后启动脚本名从 hmcl 变为 hmcl-bin，但此时 hmcl-bin -Dglass.gtk.uiScale=1.25 不再起作用。

我发现问题原因是，在 3.9.2 中，hmcl 脚本中的启动命令为：

exec /usr/bin/java "$@" -jar "/usr/share/java/hmcl/hmcl.jar"

而在 3.10.2 中，hmcl-bin 中的启动命令变为：

exec /usr/bin/java -jar '/usr/share/java/hmcl-bin/hmcl-bin.jar' "$@"

"$@"（这里即我传入的 -Dglass.gtk.uiScale=1.25）的位置从前面挪到了后面，从 JVM 参数变成了 JAR 参数，然后就缩放了个寂寞。不知道开发人员这样调整的用意是？

当前，我可以通过

java -Dglass.gtk.uiScale=1.25 -jar '/usr/share/java/hmcl-bin/hmcl-bin.jar'

来带缩放地启动 HMCL。

---

此外，我这环境变量似乎从来都不起作用，不知道出了什么问题……

[zkitefly]

我是从 AUR 安装的 hmcl-bin 软件包。

这个包似乎不是由官方维护

[storm-1614]

可以用 archlinuxcn/hmcl 这个包，版本和 aur 的 hmcl-bin 版本一致

[Glavo]

此外，我这环境变量似乎从来都不起作用，不知道出了什么问题……

HMCL_JAVA_OPTS 仅在使用 .sh/.exe 的 HMCL 时才会生效，直接用 java -jar HMCL.jar 启动 HMCL 的时候，HMCL 是无法控制 Java 虚拟机参数的。

如果你需要通过环境变量调整 UI 缩放，那么可以通过 HMCL_UI_SCALE 环境变量来指定。