create-gl4es-stencil-fix

GL4ES Stencil Fix

一个小型 Forge 模组，用于修复在使用 GL4ES 或 Krypton Wrapper 等 OpenGL 封装器的移动版 Minecraft 启动器上运行 Create（机械动力）时发生的崩溃。

问题

在 Android 移动端启动器（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 核心模组（ASM 字节码转换器），在类加载时将 enableStencil()替换为空操作。这样就不会调用模板缓冲区，因此也不会发生崩溃。

如果补丁已成功应用，你会在日志中看到以下内容：
“””
[GL4ESFix] SUCCESS: RenderTarget.enableStencil() replaced with no-op RETURN.
“””

兼容性

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

副作用

Create/Ponder 会在 Ponder教程查看器中使用模板缓冲区来裁剪界面。使用此修复后，该裁剪效果将被禁用，可能导致 Ponder 界面出现轻微的视觉瑕疵（界面元素略微超出边界）。

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

安装

将 jar 文件放入与 Create 同一目录下的 .minecraft/mods/ 文件夹中。无需额外配置。