NeoLoading-Vulkan-Fix

NeoLoading-Vulkan-Fix

修复了在Minecraft 26.2+中与NeoForge的Vulkan不兼容问题,通过跳过早期加载屏幕。仅客户端。

Bug修复

NeoLoading-Vulkan-Fix 是一个轻量级客户端模组,用于修复 Minecraft 在使用 Vulkan 图形后端时,因 NeoForge 的早期加载界面(Early Loading Screen)导致的崩溃和卡死问题。

问题描述

当您通过 GpuBackend 将 Minecraft 切换为 Vulkan 渲染后端时,NeoForge 的早期加载界面会与 Vulkan 的窗口创建流程产生冲突,导致游戏在启动阶段卡死或崩溃。

解决方案

此模组使用 Mixin 注入,在两个关键节点解决问题:

  1. 检测 Vulkan — 挂钩 Window.createGlfwWindow 以检测当前使用的后端是否为 Vulkan
  2. 跳过冲突加载界面 — 检测到 Vulkan 时,跳过 EarlyLoadingScreenController 的初始化
  3. 安全清理 — 在 ClientModLoader.finish 中,使用 GLFW 原生 API 正确销毁 DisplayWindow,而不是调用原始的 close() 方法

兼容性

  • 仅限客户端 — 无需在服务器端安装。
  • 不影响游戏玩法 — 纯技术性修复。
  • 如使用 暮色森林:Re26 则无需安装 — 该模组已包含相同的 Vulkan 修复。请移除本模组以避免冲突。

如果您在 NeoForge 下使用 Vulkan 并遇到启动崩溃问题,此模组应能为您解决。