create-gl4es-stencil-fix

create-gl4es-stencil-fix

Fixes Create mod crash on mobile (GL4ES/Krypton) create模组的手机端修复

GL4ES 模板修复

一个轻量级的 Forge 模组，修复了使用 GL4ES 或 Krypton Wrapper 等 OpenGL 包装器的移动端我的世界启动器上，因 Create（机械动力） 导致的崩溃问题。

问题描述

在移动端安卓启动器（ZalithLauncher、PojavLauncher、FCL 等）上，游戏加载过程中会因以下错误崩溃：

  • GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT（GL4ES / GLES 2.0）
  • GL_FRAMEBUFFER_UNSUPPORTED（Krypton Wrapper / GLES 3.x）

崩溃的原因是 Create/Ponder 调用了 RenderTarget.enableStencil()，尝试为现有 FBO 附加模板缓冲区。移动端 OpenGL 包装器无法处理此操作，导致 Forge 抛出致命的 RuntimeException。

解决方案

本模组使用 Forge Coremod（ASM 字节码转换器），在类加载时将 enableStencil() 替换为空操作。模板缓冲区的调用永远不会执行，因此崩溃不再发生。

如果补丁成功应用，你会看到以下日志行： """ [GL4ESFix] 成功：RenderTarget.enableStencil() 已被替换为空返回。 """

兼容性

  • 我的世界： 1.20.1
  • Forge： 47.x
  • Create： 0.5.x 和 6.0.x（所有 1.20.1 版本）
  • 启动器： ZalithLauncher、PojavLauncher、FCL 以及任何基于 GL4ES 的启动器
  • 仅客户端 — 无需安装在服务器上

副作用

模板缓冲区被 Create/Ponder 用于 Ponder 教程查看器中的 UI 裁剪。使用本修复后，该裁剪效果将被禁用，这可能会导致 Ponder 屏幕出现轻微的视觉异常（UI 元素略微超出其边界）。

正常游戏、机械、装置以及所有其他功能完全不受影响。

安装

将 jar 文件放入你的 .minecraft/mods/ 文件夹中，与 Create 模组放在一起。无需额外配置。