增强对 Vulkan 的支持 by Glavo · Pull Request #5930 · HMCL-dev/HMCL

Glavo · 2026-04-08T13:48:21Z

优化渲染器选项描述；
添加 Vulkan 相关的渲染器选项。

…guages

… support

…nt setup

…mation

… methods

HMCL/src/main/resources/assets/lang/I18N_zh.properties

…uncher.java

…java

Co-authored-by: 3gf8jv4dv <3gf8jv4dv@gmail.com>

…r logic in AdvancedVersionSettingPage.java

…e related logic

Copilot

Pull request overview

该 PR 旨在增强启动器对 Vulkan 相关渲染路径的支持，并改进“渲染器”选项的展示文案与可选项，以适配较新的 Minecraft 版本（26.2 snapshot 系列）及 Mesa Loader 相关能力。

Changes:

扩展 Renderer 枚举，引入 Vulkan/OpenGL API 维度与 Vulkan 相关渲染器（如 Lavapipe）。
启动参数与环境变量层面增加 Vulkan/Mesa Loader 支持（--graphicsBackend、Mesa Loader nativeDir、VK_* 环境变量等）。
更新 Windows 平台 mesa-loader 依赖版本，并调整多语言渲染器描述文案/条目。

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 9 comments.

Show a summary per file

File	Description
HMCLCore/src/main/java/org/jackhuang/hmcl/launch/DefaultLauncher.java	生成启动命令与环境变量时加入 Vulkan/Mesa Loader 相关参数与变量
HMCLCore/src/main/java/org/jackhuang/hmcl/game/Renderer.java	重构渲染器枚举：引入 API 概念、Vulkan/OpenGL 条目与 Mesa 相关元数据
HMCL/src/main/resources/assets/natives.json	升级 Windows mesa-loader 依赖版本与校验信息
HMCL/src/main/resources/assets/lang/I18N.properties	英文：更新渲染器描述并新增 Vulkan/Lavapipe/OpenGL 等条目文案
HMCL/src/main/resources/assets/lang/I18N_zh.properties	繁中：更新/新增渲染器条目文案
HMCL/src/main/resources/assets/lang/I18N_zh_CN.properties	简中：更新/新增渲染器条目文案
HMCL/src/main/resources/assets/lang/I18N_uk.properties	删除既有渲染器 desc 翻译行
HMCL/src/main/resources/assets/lang/I18N_ru.properties	删除既有渲染器 desc 翻译行
HMCL/src/main/resources/assets/lang/I18N_lzh.properties	删除既有渲染器 desc 翻译行
HMCL/src/main/resources/assets/lang/I18N_ja.properties	删除既有渲染器 desc 翻译行
HMCL/src/main/resources/assets/lang/I18N_es.properties	删除既有渲染器 desc 翻译行
HMCL/src/main/resources/assets/lang/I18N_ar.properties	删除既有渲染器 desc 翻译行
HMCL/src/main/java/org/jackhuang/hmcl/util/NativePatcher.java	调整 Mesa Loader 获取方法的参数命名与引用一致性
HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/AdvancedVersionSettingPage.java	按游戏版本控制渲染器下拉可选项（>= 26.2 snapshot 显示更多选项）
HMCL/src/main/java/org/jackhuang/hmcl/game/LauncherHelper.java	Windows 下为 Mesa 渲染器注入 javaagent 参数时改用 Mesa driverName

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

HMCLCore/src/main/java/org/jackhuang/hmcl/launch/DefaultLauncher.java

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/AdvancedVersionSettingPage.java

HMCL/src/main/resources/assets/lang/I18N_ru.properties

Copilot · 2026-04-10T09:13:56Z

HMCL/src/main/resources/assets/lang/I18N_uk.properties

 settings.advanced.renderer=Рендерер
 settings.advanced.renderer.default=По умолчанию
-settings.advanced.renderer.default.desc=OpenGL
 settings.advanced.renderer.d3d12=Mesa D3D12
-settings.advanced.renderer.d3d12.desc=DirectX 12 (Погана продуктивність та сумісність)
 settings.advanced.renderer.llvmpipe=Mesa LLVMpipe
-settings.advanced.renderer.llvmpipe.desc=Програмний (Погана продуктивність, найкраща сумісність)
 settings.advanced.renderer.zink=Mesa Zink


This change removes existing localized renderer description keys. As a result, this locale will fall back to English for these descriptions (or show them missing depending on bundle fallback), which is a regression for non-English users. Please keep the previous translations or update them to match the new wording instead of deleting.

Copilot · 2026-04-10T09:13:56Z

HMCL/src/main/resources/assets/lang/I18N_lzh.properties

 settings.advanced.renderer=繪器
 settings.advanced.renderer.default=本
-settings.advanced.renderer.default.desc=開圖庫
 settings.advanced.renderer.d3d12=Mesa D3D12
-settings.advanced.renderer.d3d12.desc=DirectX 12 (效與所適皆差，勘誤之用)
 settings.advanced.renderer.llvmpipe=Mesa LLVMpipe
-settings.advanced.renderer.llvmpipe.desc=軟繪器 (效差，所適至)
 settings.advanced.renderer.zink=Mesa Zink


This change removes existing localized renderer description keys. As a result, this locale will fall back to English for these descriptions (or show them missing depending on bundle fallback), which is a regression for non-English users. Please keep the previous translations or update them to match the new wording instead of deleting.

Copilot · 2026-04-10T09:13:57Z

HMCL/src/main/resources/assets/lang/I18N_ja.properties

 settings.advanced.renderer=レンダラー
 settings.advanced.renderer.default=デフォルト
-settings.advanced.renderer.default.desc=OpenGL
 settings.advanced.renderer.d3d12=Mesa D3D12
-settings.advanced.renderer.d3d12.desc=DirectX 12 (低パフォーマンス、低互換性)
 settings.advanced.renderer.llvmpipe=Mesa LLVMpipe
-settings.advanced.renderer.llvmpipe.desc=ソフトウェア (低速だが、互換性は最高)
 settings.advanced.renderer.zink=Mesa Zink


This change removes existing localized renderer description keys. As a result, this locale will fall back to English for these descriptions (or show them missing depending on bundle fallback), which is a regression for non-English users. Please keep the previous translations or update them to match the new wording instead of deleting.

Copilot · 2026-04-10T09:13:57Z

HMCL/src/main/resources/assets/lang/I18N_es.properties

 settings.advanced.renderer=Renderizador
 settings.advanced.renderer.default=Por defecto
-settings.advanced.renderer.default.desc=OpenGL
 settings.advanced.renderer.d3d12=Mesa D3D12
-settings.advanced.renderer.d3d12.desc=DirectX 12 (Rendimiento y compatibilidad deficientes)
 settings.advanced.renderer.llvmpipe=Mesa LLVMpipe
-settings.advanced.renderer.llvmpipe.desc=Software (Bajo rendimiento, máxima compatibilidad)
 settings.advanced.renderer.zink=Mesa Zink


This change removes existing localized renderer description keys. As a result, this locale will fall back to English for these descriptions (or show them missing depending on bundle fallback), which is a regression for non-English users. Please keep the previous translations or update them to match the new wording instead of deleting.

Copilot · 2026-04-10T09:13:57Z

HMCL/src/main/resources/assets/lang/I18N_ar.properties

 settings.advanced.renderer=المُصيِّر
 settings.advanced.renderer.default=افتراضي
-settings.advanced.renderer.default.desc=OpenGL
 settings.advanced.renderer.d3d12=Mesa D3D12
-settings.advanced.renderer.d3d12.desc=DirectX 12 (أداء وتوافق ضعيفان)
 settings.advanced.renderer.llvmpipe=Mesa LLVMpipe
-settings.advanced.renderer.llvmpipe.desc=برمجي (أداء ضعيف، توافق أفضل)
 settings.advanced.renderer.zink=Mesa Zink


This change removes existing localized renderer description keys. As a result, this locale will fall back to English for these descriptions (or show them missing depending on bundle fallback), which is a regression for non-English users. Please keep the previous translations or update them to match the new wording instead of deleting.

…er.java

Glavo · 2026-04-10T09:20:16Z

@codex review

Glavo · 2026-04-10T09:45:43Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3cccec02b8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-04-10T09:52:18Z

HMCLCore/src/main/java/org/jackhuang/hmcl/launch/DefaultLauncher.java

+                    if (renderer.getApi() == Renderer.API.VULKAN) {
+                        String icdFile = FileUtils.getAbsolutePath(nativeFolder.resolve("mesa-loader/" + renderer.getIcdFileName()));
+
+                        env.put("VK_ICD_FILENAMES", icdFile);
+                        env.put("VK_DRIVER_FILES", icdFile);


Guard Vulkan ICD env vars by available Windows loader

This path unconditionally sets VK_ICD_FILENAMES/VK_DRIVER_FILES for Vulkan Mesa renderers on Windows, but the loader agent is only attached when NativePatcher.getWindowsMesaLoader(...) returns a library; on Windows 7/8 it returns null for non-LLVMPIPE. In that case (e.g., LAVAPIPE), the process is forced to use an ICD file under mesa-loader that was never extracted, so Vulkan startup fails. Please gate these env vars by Windows version/loader availability (or block unsupported renderer selection earlier).

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-04-10T09:52:18Z

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/AdvancedVersionSettingPage.java

+            if (gameVersion == null || gameVersion.compareTo("26.2-snapshot-1") >= 0) {
+                rendererPane.setItems(Renderer.ALL);


Align renderer availability gate with backend flag support

The UI enables Renderer.ALL starting at 26.2-snapshot-1, but launch argument generation only applies --graphicsBackend from 26.2-snapshot-2 onward (DefaultLauncher lines 404-407). For 26.2-snapshot-1, selecting OPENGL/VULKAN has no effective launch-time change (no Mesa driver/env path), so users can choose options that silently do nothing. The version gate should match the backend-flag support threshold.

Useful? React with 👍 / 👎.

…logic

… update UI bindings

….java

…upport

…escriptions

Glavo · 2026-04-10T13:43:34Z

/gemini review

gemini-code-assist

Code Review

This pull request introduces support for selecting the Graphics API (OpenGL or Vulkan) in the game settings, specifically targeting Minecraft 26.2 and later. Key changes include updating the Mesa loader to version 26.0.4, refactoring the Renderer enum to associate specific renderers with their respective APIs, and adding UI components for backend selection. The launch logic has been updated to handle the new --graphicsBackend argument and configure environment variables for various rendering backends on both Windows and Linux. Review feedback identifies a type mismatch during UI initialization, a typo in a code comment, and a missing environment variable configuration for the D3D12 renderer on Linux.

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/AdvancedVersionSettingPage.java

HMCLCore/src/main/java/org/jackhuang/hmcl/game/Renderer.java

HMCLCore/src/main/java/org/jackhuang/hmcl/launch/DefaultLauncher.java

Copilot

Pull request overview

Copilot reviewed 20 out of 20 changed files in this pull request and generated 4 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

HMCLCore/src/main/java/org/jackhuang/hmcl/launch/DefaultLauncher.java

HMCLCore/src/main/java/org/jackhuang/hmcl/game/Renderer.java

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/AdvancedVersionSettingPage.java

HMCL/src/main/resources/assets/lang/I18N.properties

…om language files

Glavo · 2026-04-10T14:06:22Z

@codex review

chatgpt-codex-connector · 2026-04-10T14:15:12Z

Codex Review: Didn't find any major issues. Keep it up!

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Glavo added 4 commits April 8, 2026 21:06

Update translations: refine renderer descriptions across multiple lan…

6989885

…guages

feat: add Mesa Lavapipe renderer support and update translations

1299402

feat: enhance renderer selection based on game version and add Vulkan…

7e0f954

… support

feat: add support for Lavapipe and Zink renderers in Vulkan environme…

1b7f360

…nt setup

Glavo marked this pull request as draft April 8, 2026 13:48

Glavo added 9 commits April 8, 2026 23:53

Fix Lavapipe renderer architecture detection using Java runtime infor…

582856f

…mation

refactor: remove unused import for StreamSupport in Renderer.java

9c59bda

feat: add Vulkan-based renderer list in Renderer.java

18d71e4

feat: add Mesa Dozen renderer support and update translations

5d136d2

feat: add Mesa Dozen renderer support and update translations

7417630

refactor: extract Vulkan descriptor file lookup into a helper method

1e700e9

feat: add environment variable methods to LaunchOptions Builder

fd5b0e5

refactor: update renderer condition checks in LauncherHelper

509e2f4

feat: add VK_DRIVER_FILES environment variable and update Mesa loader…

4a4ca5e

… methods

3gf8jv4dv reviewed Apr 8, 2026

View reviewed changes

Glavo and others added 13 commits April 10, 2026 14:58

refactor: simplify Windows Mesa loader method and update Renderer enum

54945ac

feat: add Vulkan-based renderer list in Renderer.java

32a102e

refactor: pass nativeFolder to getEnvVars and update Vulkan ICD handling

a5fb944

refactor: remove unused JavaRuntime import in DefaultLauncher.java

4ea9843

Update Mesa loader to version 26.0.4 for Windows platforms

cfb6029

feat: add nativeDir configuration for Mesa loader on Windows

78f2d01

refactor: update nativeDir configuration for Mesa loader in DefaultLa…

fd99713

…uncher.java

refactor: remove unused Version import in AdvancedVersionSettingPage.…

5214e65

…java

Update HMCL/src/main/resources/assets/lang/I18N_zh.properties

4f960d9

Co-authored-by: 3gf8jv4dv <3gf8jv4dv@gmail.com>

Update HMCL/src/main/resources/assets/lang/I18N_zh.properties

5e88091

Co-authored-by: 3gf8jv4dv <3gf8jv4dv@gmail.com>

Update HMCL/src/main/resources/assets/lang/I18N_zh.properties

67104c5

Co-authored-by: 3gf8jv4dv <3gf8jv4dv@gmail.com>

Update HMCL/src/main/resources/assets/lang/I18N_zh.properties

02d776c

Co-authored-by: 3gf8jv4dv <3gf8jv4dv@gmail.com>

Update HMCL/src/main/resources/assets/lang/I18N_zh.properties

899df6f

Co-authored-by: 3gf8jv4dv <3gf8jv4dv@gmail.com>

Glavo marked this pull request as ready for review April 10, 2026 07:29

refactor: remove unused GameVersionNumber import and simplify rendere…

a946079

…r logic in AdvancedVersionSettingPage.java

Glavo added 2 commits April 10, 2026 16:51

Reorder OPENGL renderer in Renderer.java

f555606

refactor: rename getMesaLoaderName to getMesaDriverName and updat…

aca0ef6

…e related logic

Glavo requested a review from Copilot April 10, 2026 09:07

Copilot started reviewing on behalf of Glavo April 10, 2026 09:08 View session

Copilot AI reviewed Apr 10, 2026

View reviewed changes

Glavo added 2 commits April 10, 2026 17:17

Fix Vulkan descriptor file path list formatting in DefaultLauncher.java

66399db

Use GameVersionNumber.compare for version comparison in DefaultLaunch…

3cccec0

…er.java

chatgpt-codex-connector bot reviewed Apr 10, 2026

View reviewed changes

Glavo added 10 commits April 10, 2026 19:52

refactor: replace API enum with GraphicsAPI in renderer and launcher …

060f66b

…logic

feat: add graphics backend setting in VersionSetting.java

5926f95

feat: integrate graphics backend selection with renderer settings and…

c9d18f5

… update UI bindings

refactor: remove outdated documentation for getApi method in Renderer…

f27c48b

….java

fix: set default renderer items in AdvancedVersionSettingPage

5e09e22

fix: maintain reference to popup items in LineSelectButton

17d1d49

feat: update graphics backend handling in launcher and settings

2c668b1

feat: enhance graphics backend descriptions and handling for Vulkan s…

eb55079

…upport

feat: update Dozen renderer handling and mark as experimental in UI d…

21f0110

…escriptions

fix: update Vulkan rendering descriptions for clarity and consistency

a68ca57

gemini-code-assist bot reviewed Apr 10, 2026

View reviewed changes

HMCL/src/main/java/org/jackhuang/hmcl/ui/versions/AdvancedVersionSettingPage.java Show resolved Hide resolved

HMCLCore/src/main/java/org/jackhuang/hmcl/game/Renderer.java Show resolved Hide resolved

HMCLCore/src/main/java/org/jackhuang/hmcl/launch/DefaultLauncher.java Show resolved Hide resolved

Glavo requested a review from Copilot April 10, 2026 13:53

Copilot started reviewing on behalf of Glavo April 10, 2026 13:54 View session

Copilot AI reviewed Apr 10, 2026

View reviewed changes

refactor: remove system default OpenGL and Vulkan renderer options fr…

e66ee2c

…om language files

Glavo merged commit 30c3acf into HMCL-dev:main Apr 10, 2026
2 checks passed

Glavo deleted the vulkan branch April 10, 2026 14:19

		if (gameVersion == null \|\| gameVersion.compareTo("26.2-snapshot-1") >= 0) {
		rendererPane.setItems(Renderer.ALL);

Conversation

Glavo commented Apr 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Glavo commented Apr 10, 2026

Uh oh!

Glavo commented Apr 10, 2026

Uh oh!

chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector bot Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector bot Apr 10, 2026

Choose a reason for hiding this comment

Uh oh!

Glavo commented Apr 10, 2026

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Glavo commented Apr 10, 2026

Uh oh!

chatgpt-codex-connector bot commented Apr 10, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Glavo commented Apr 8, 2026 •

edited

Loading