create-gl4es-stencil-fix

Quick rating

Community listing page, reviews here may not be monitored by the author.

create-gl4es-stencil-fix

No reviews yet

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

Mod Loaders
Minecraft

About

Description

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.