我们在 2025 年 10 月 16 日发布了 HMCL 稳定版 3.7.1。

欢迎大家进行更新，或前往 HMCL 用户群下载。遇到问题可以在 GitHub 或用户群​进行反馈。

本页面展示了自 HMCL 3.6.20 以来的新功能和重要错误修复。

将最低 Java 版本提升至 Java 17 (by Glavo)

从 HMCL 3.7 开始，HMCL 需要 Java 17 或更高版本才能运行。 你可以从用户群中获取到最新版本的 Java。

Java 支持多个版本共存，安装新版本后你依然可以保留旧版本 Java。 HMCL 也将继续支持使用 Java 6~16 启动游戏，所以这不会影响你游玩旧版本 Minecraft。

考虑到部分用户仍在使用 Windows XP 等旧平台，无法使用 Java 17 或更高版本， 未来我们会继续将数据更新和重要错误修复移植到 HMCL 3.6。

在未来 HMCL 3.7 正式发布后， 希望继续使用 HMCL 3.6 的用户需要手动从官网或用户群中下载更新。

Terracotta | 陶瓦联机 (by Burning_TNT)

在该版本中，我们集成了新的 P2P 联机工具：Terracotta | 陶瓦联机。

Terracotta | 陶瓦联机 是一个第三方开源免费联机工具，基于 EasyTier 开源项目开发。我们基于该工具为所有用户免费提供联机功能。

陶瓦联机的入口位于主界面左下角。

关于「Terracotta | 陶瓦联机」的更多介绍请参见该项目作者 Burning_TNT 所写的介绍文章：HMCL x Terracotta | 陶瓦联机全面开放​。

支持导出 Modrinth 整合包 (by Zkitefly)

现在 HMCL 支持导出 Modrinth 整合包了。

支持自动安装 Cleanroom (by 辞庐, zkitefly)

现在 HMCL 支持在启动器内安装 Cleanroom 了。

优化新手用户的使用体验 (by Glavo)

介绍视频：BV1BbYxzNEFE​

现在 HMCL 在没有安装任何版本时，主页右下角的“启动游戏”按钮将被替换为“开始游戏”按钮， 点击该按钮将会自动下载最新正式版 Minecraft，并在下载完成后直接启动游戏。

这项变化旨在让不了解游戏版本之间的区别的新手用户也能轻松开始游戏。

对于对 Minecraft 已经有所了解的进阶用户，这项变化应该没有明显的影响。 如果想选择游戏版本或安装模组加载器，只需要像以往一样进入游戏下载界面并选择游戏版本即可。

支持最大化和全屏模式 (by Glavo)

现在双击 HMCL 标题栏可以使 HMCL 窗口最大化，使用 F11 快捷键可以使 HMCL 进入全屏模式。

HMCL 在最大化或全屏后依然会保留边缘阴影，这是一个已知的问题。 由于该问题没有显著的负面影响，并且解决它比较麻烦，所以我们暂时不会处理该问题。

由于一些问题，该功能在 macOS 上无法使用。 我们未来会尝试解决该问题。

支持通过环境变量控制动画帧率 (by Glavo)

现在用户可以通过设置环境变量 HMCL_ANIMATION_FRAME_RATE 来控制 HMCL 的动画速率。

对于使用高刷屏的用户，可以将环境变量 HMCL_ANIMATION_FRAME_RATE 设置为显示器刷新率 (例如 120) 来提高 HMCL 的动画帧率， 使启动器更流畅。

优化字体抗锯齿策略 (by Glavo)

在这个版本中，我们调整了启动器默认的字体抗锯齿策略。

现在 HMCL 在 HiDPI 屏幕上会默认使用灰度抗锯齿， 应当能够显著改善部分字体的渲染效果。

此外，我们在「设置 > 外观 > 字体」中新增了抗锯齿设置选项。 用户可以自行调整字体的抗锯齿算法。 将其调整为「子像素」可还原旧版本 HMCL 的行为。

更多语言翻译

在此版本中，我们新增了文言、乌克兰语和颠倒的英语翻译。

完整更新日志

• 启动器

  • GP-4452: 将最低 Java 版本提升至 Java 17 (by Glavo)

  • GP-4454: 将默认 JavaFX 版本更新至 21.0.8/25 (by Glavo)

  • GP-4439: 更新模组和整合包数据 (by Glavo)

  • GP-4064: 优化主页公告关闭按钮 (by 辞庐)

  • GP-4145: 在 Windows 平台优先使用注册表探测 GPU (by Glavo)

  • GP-4163: 通过主页右下角弹出菜单切换版本后隐藏菜单 (by Glavo)

  • GP-4142: 忽略 %ProgramFiles%\Common Files\Oracle\Java 中的 Java (by Glavo)

  • GP-4180: 支持搜索不包含 release 文件的 Java (by Glavo)

  • GP-4201: 为弹窗文本添加平滑滚动 (by 辞庐)

  • GP-4203: 优化弹出菜单的默认弹出位置 (by ENC_Euphony)

  • GP-4051: 导出日志时附带最近日志 (by Zkitefly)

  • GP-4179: 支持搜索 ./.hmcl/java 目录中的 Java (by Glavo)

  • GP-4248: 在未安装游戏版本时支持一键下载启动游戏 (by Glavo) (BV1BbYxzNEFE​)

  • GP-4246: 将 authlib-injector 嵌入启动器 (by Glavo)

  • GP-4260: 支持最大化和全屏模式 (by Glavo)

  • GP-4276: 优化版本号排序规则 (by Glavo)

  • GP-4282: 优化对 Indev 版本的支持 (by Glavo)

  • GP-4292, GP-4306: 优化显示进度对话框 (by Glavo)

  • GP-4294: 游戏崩溃窗口中增加对拍照的提醒 (by YuChuXi)

  • GP-4341: 更严格地检测文件名合法性 (by Glavo)

  • GP-4362: 优化语言设置选项中语言名称的显示方式 (by Glavo)

  • GP-4353: 优化自动切换游戏语言功能 (by Glavo)

  • GP-4414: 检测到配置文件由高版本启动器创建时禁止保存配置文件 (by Glavo)

  • GP-4487: 在未启用 JIT 或硬件渲染加速的环境中启动时弹出提示 (by Glavo)

  • GP-4506: 使用 Java 25 启动游戏时默认开启 Compact Object Headers (by Glavo)

• 游戏设置

  • GP-4234: 优化游戏窗口大小选择功能 (by Glavo)

  • GP-4275: 基于实际屏幕分辨率添加游戏窗口分辨率选项 (by Wulian233)

  • GP-4507: 游戏设置中添加「不自动添加 Java 虚拟机优化参数」选项 (by Glavo)

  • GP-4515: 优化 Java 自动选择规则 (by Glavo)

• 实例管理

  • GP-4222: 在实例名称中包含非字母、数字、减号和下划线字符时弹出警告 (by Glavo)

  • GP-4509: 支持在主界面「实例管理」按钮上通过滚动滚轮切换游戏实例 (by Glavo)

• 模组管理

  • GP-3230: 支持根据更多信息搜索模组 (by Zkitefly)

  • GP-3231: 优化模组中文译名匹配机制 (by Zkitefly)

  • GP-3229, GP-4621: 优化模组管理页面布局 (by Zkitefly, Glavo)

  • GP-4622, GP-4648: 优化模组加载器检测机制 (by Glavo)

  • GP-4641, GP-4652, GP-4654, GP-4658: 支持识别更多模组的元数据 (by Glavo)

• 世界管理

  • GP-4263: 支持删除世界 (by Wulian233)

• 整合包

  • GP-3716: 支持导出 Modrinth 整合包 (by Zkitefly)

• 账户

• 下载

  • GP-4272: 支持自动安装 Cleanroom (by 辞庐, zkitefly)

  • GP-4141: 优化游戏下载页版本分类功能 (by Glavo)

  • GP-4249: 游戏下载页面中使用史莱姆块作为愚人节版本的图标 (by Wulian233)

  • GP-4471: 在游戏下载界面中显示当前平台对每个版本的支持状态 (by Glavo)

  • GP-4268: 在 NeoForge 下载页面中添加正式版/快照分类 (by Wulian233)

  • GP-4167, GP-4169, GP-4462: 优化下载缓存功能 (by Glavo)

  • GP-4219: 下载文件时启用透明 GZip 压缩 (by Glavo)

  • GP-4546: 支持通过 HTTP/2 协议下载文件 (by Glavo)

• 外观

  • GP-4118: 添加字体抗锯齿算法设置选项 (by Glavo)

  • GP-4148: 在系统设置中禁用动画效果时，默认禁用启动器动画 (by Glavo)

  • GP-4510: 在未启用 JIT 或硬件渲染加速的环境中默认启动器禁用动画 (by Glavo)

  • GP-4164: 支持通过环境变量强制使用 GPU 渲染和控制动画帧率 (by Glavo)

  • GP-4184: 支持设置纯色背景 (by Glavo)

  • GP-3205: 支持修改背景的不透明度 (by 吞云)

  • GP-4205: 支持 APNG 动画图片 (by Glavo)

  • GP-4323: HintPane 使用新版 Bootstrap 调色盘 (by 辞庐)

  • GP-4521: 支持通过环境变量控制 UI 缩放比例 (by Glavo)

• 联机

  • GP-4215: 在启动器中内置 Terracotta | 陶瓦联机 (by Burning_TNT)

• 本地化

  • GP-4348: 添加文言翻译 (by Glavo, Andypsl8, Wulian233, dovisutu, 物灵, Bei Dou, 繁繁芙芙, Kaohaaa, 365KW, Andypsl8, Au0727, threwd, vinds476283)

  • GP-4346: 添加乌克兰语翻译 (by BANSAFAn)

  • GP-4527: 添加颠倒的英语翻译 (by Glavo)

• 错误修复

  • GP-3976: 修复 Minecraft 1.5.2 安装 Forge 后无法正常启动的问题 (by Zkitefly)

  • GP-3956: 修复启动时会尝试补全服务端自动更新整合包中已禁用的 mod 的问题 (by Zkitefly)

  • GP-4239: 修复部分版本 wiki 链接不正确的问题 (by ENC_Euphony)

  • GP-4321: 修复世界管理页面不支持极限模式的问题 (by Wulian233)

  • GP-4350: 修复在部分简体中文环境中默认显示繁体中文的问题 (by Glavo)

  • GP-4386: 修复离线账户换肤功能使用无效 CSL API 会导致启动失败的问题 (by Glavo)

  • GP-4492: 修复 Windows 平台上 %APPDATA%\.hmcl 目录为跨驱动器符号链接时无法卸载 Java 的问题 (by Glavo)

  • GP-4514: 修复 AdvancedListBox 在非必要的情况下显示滚动条的问题 (by rootwhois)

  • GP-4517: 修复日志页面选中条目时 hover 背景闪烁两次的问题 (by rootwhois)

  • GP-4296: 修复切换下载源后需要重启启动器才会生效的问题 (by Glavo)

  • GP-4568: 修复在短时间内连续点击 OptionToggleButton 只会更改一次状态的问题 (by 辞庐)

  • GP-4585: 修复部分按钮点击后始终保持焦点状态的问题 (by Wulian233)

  • GP-4646: 修复 Minecraft 1.21.9+ 安装了 NeoForge 的实例未使用 NeoForge 图标作为实例图标的问题 (by 3gf8jv4dv)

  • GP-4624: 修复导出游戏崩溃信息后弹窗没有正常弹出的问题 (by 辞庐)

  • GP-4660: 修复模组下载页面图标模糊的问题 (by Glavo)

欢迎大家尝试新功能，遇到问题可以在 GitHub 或用户群​进行反馈。