An unofficial fork of Modern UI that makes it run on VulkanMod.
⚠️ This is not an official build. Please do not report bugs, crashes or feature requests to BloCamLimb, the original author — send them to this fork's issue tracker instead.
What is this?
Modern UI is a modern UI and text rendering framework for Minecraft, and its rendering backend is OpenGL. VulkanMod replaces Minecraft's OpenGL renderer entirely, so under VulkanMod, upstream Modern UI cannot draw its interface at all.
This fork re-routes Modern UI's UI rendering onto Vulkan and fixes the breakage that shows up on that backend. Everything else — the widgets, fonts, text engine and API — is left exactly as upstream ships it.
Do you need it?
- An older game version + VulkanMod → use this fork
- A setup that isn't bothered by VulkanMod compatibility → upstream may be the better choice.
Requirements
- Minecraft 1.21.1 (Fabric)
- Fabric Loader 0.15.0 or newer
- Java 21 or newer
- Fabric API 0.90.7 or newer
- Forge Config API Port 21.0.5 or newer
- VulkanMod — tested with 0.6.7, and it is the whole reason this fork exists
Client-side only — nothing is needed on the server.
Declared as incompatible: blur, tipTheScales.
What this fork changes
- Re-routes UI rendering from OpenGL onto Vulkan, so the interface works under VulkanMod
- Bundles HarmonyOS Sans SC and sets it as the default preferred font
- Adds a second font family option
- Reworked the home screen cards: the changelog that needed a network connection is gone, replaced by notes specific to this fork
Known limitations
- Under Vulkan a few things are still missing — for example **UI screenshots do not work yet**.
- Some settings, such as the font list, need a game **restart** to take effect.
Technical notes
- VulkanMod owns the `VkDevice`, so Arc3D's Vulkan backend cannot create one of its own — this fork makes it borrow VulkanMod's device, queue and memory allocator.
- Arc3D images are not OpenGL textures. They are wrapped into VulkanMod's texture handles, so vanilla code and other mods can still bind them normally.
- The compatibility layer is loaded lazily: without VulkanMod, none of that code is ever touched.
- Pure-OpenGL paths (sampler binding, shader pipelines) are guarded, so they fall back to the vanilla code path when no Vulkan pipeline exists.
Credits and licence
- Modern UI © BloCamLimb — [upstream repository](https://github.com/BloCamLimb/ModernUI-MC), licensed LGPL-3.0-or-later. All original copyright and licence notices are kept unchanged.
- Modifications in this fork © 2026 Shao_Zhige, released under the same licence (LGPL-3.0-or-later).
- Bundles HarmonyOS Sans SC (HarmonyOS Sans Fonts License Agreement, included in the jar).
- Some code comes from The Android Open Source Project.
---
中文
Modern UI 的非官方分支，让它在 VulkanMod 环境下跑起来。
⚠️ 这不是官方构建。请不要向原作者 BloCamLimb 反馈本版本的问题、崩溃或功能请求 —— 请提交到 [本分支的 issue 区]。
这是什么
Modern UI 是 Minecraft 的现代界面与文本渲染框架，渲染后端基于 OpenGL。而 VulkanMod 会把 Minecraft 的 OpenGL 渲染器整个替换掉，所以在 VulkanMod 环境下，上游 Modern UI 根本画不出界面。
本分支把 Modern UI 的界面渲染改接到 Vulkan 上，并修复了在该后端下出现的异常。除此之外 —— 控件、字体、文本引擎、API —— 一律与上游保持一致。
你需要它吗？
- 一些落后的版本 + VulkanMod → 用本分支
- 不被 VulkanMod 兼容性困扰的环境 → 使用原版模组或许会更好。
前置要求
- Minecraft 1.21.1（Fabric）
- Fabric Loader 0.15.0 或更高
- Java 21 或更高
- Fabric API 0.90.7 或更高
- Forge Config API Port 21.0.5 或更高
- VulkanMod —— 实测版本 0.6.7，它也正是本分支存在的理由
纯客户端模组，服务端无需安装。
已声明不兼容：blur、tipTheScales。
改动
- 把界面渲染从 OpenGL 改接到 Vulkan，使界面在 VulkanMod 下可用
- 内置 HarmonyOS Sans SC，并设为默认首选字体
- 新增第二字体选项
- 重做了主页卡片，删除需要联网的更新日志，加入本分支的说明
已知限制
- Vulkan 下少数功能仍缺失，例如界面截图尚不可用。
- 部分设置（例如字体列表）需要重启游戏才生效。
技术说明
- VulkanMod 独占 `VkDevice`，Arc3D 的 Vulkan 后端无法自建设备 —— 本分支让它借用 VulkanMod 的设备、队列与内存分配器。
- Arc3D 的图像不是 OpenGL 纹理，会被包装成 VulkanMod 的纹理句柄，这样原版代码和其他模组的渲染代码仍能正常绑定。
- 兼容层是惰性加载的：没装 VulkanMod 时，相关代码一行都不会被触发。
- 纯 OpenGL 的路径（sampler 绑定、shader 管线）都加了守卫，在 Vulkan 下没有管线时回落到原版代码路径。
致谢与许可
- Modern UI © BloCamLimb —— [上游仓库](https://github.com/BloCamLimb/ModernUI-MC)，以 LGPL-3.0-or-later 授权。原有版权与许可声明全部保留、未作改动。
- 本分支的修改 © 2026 Shao_Zhige，以**同一许可证（LGPL-3.0-or-later）发布。
- 内置 HarmonyOS Sans SC（HarmonyOS Sans 字体许可协议，随 jar 附带）。
- 部分代码来自 The Android Open Source Project。
modernui-v Team
