create-gl4es-stencil-fix

Minecraft 版本： 1.21.1

平台： neoforge

GL4ES Stencil Fix

A tiny Forge mod that fixes a crash affecting Create (机械动力) on mobile Minecraft launchers that use OpenGL wrappers like GL4ES or Krypton Wrapper.

The Problem

On mobile Android launchers (ZalithLauncher, PojavLauncher, FCL, etc.), the game crashes during loading with:

• GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT (GL4ES / GLES 2.0)
• GL_FRAMEBUFFER_UNSUPPORTED (Krypton Wrapper / GLES 3.x)

The crash happens because Create/Ponder calls RenderTarget.enableStencil(), which tries to attach a stencil buffer to an existing FBO. Mobile OpenGL wrappers can't handle this operation, causing Forge to throw a fatal RuntimeException.

The Fix

This mod uses a Forge Coremod (ASM bytecode transformer) that runs at class-load time to replace enableStencil() with a no-op. The stencil buffer call is never made, so the crash never occurs.

If the patch is applied successfully, you'll see this line in the log:
"""
[GL4ESFix] SUCCESS: RenderTarget.enableStencil() replaced with no-op RETURN.
"""

Compatibility

• Minecraft: 1.20.1
• Forge: 47.x
• Create: 0.5.x and 6.0.x (all 1.20.1 versions)
• Launchers: ZalithLauncher, PojavLauncher, FCL, and any GL4ES-based launcher
• Client-side only — does not need to be installed on servers

Side Effects

The stencil buffer is used by Create/Ponder for UI clipping in the Ponder tutorial viewer. With this fix, that clipping effect is disabled, which may cause minor visual artifacts (UI elements slightly overflowing their bounds) in the Ponder screen.

Normal gameplay, machines, contraptions, and all other features are completely unaffected.

Installation

Place the jar in your .minecraft/mods/ folder alongside Create. No additional configuration required.