lazarus

A runtime for Minecraft Forge 1.8.9 on modern Java, with optional LWJGL 3 and security patches.

Core renderer

Minecraft 1.8.9 was written for legacy OpenGL: immediate mode, display lists, matrix stacks, fixed-function fog and lighting, and GLSL 1.20. The core renderer runs it on an OpenGL 4.1 core profile instead, the modern OpenGL every current driver supports.

On macOS this matters most. Apple gives legacy programs OpenGL 2.1 and GLSL 1.20, and nothing newer, so the game and its shader packs are stuck there. On the core renderer they get OpenGL 4.1: OptiFine runs more than twice as fast on an Apple M2, and shader packs compile in full, including ones the legacy path cannot load at all. On Windows and Linux it works the same way, so one renderer covers every platform.

Using it

The core renderer is the default on the LWJGL 3 profile (see LWJGL 3); Minecraft, Forge, OptiFine and mods run on it as they are. To use the legacy renderer instead, add this to the profile’s JVM arguments:

-Dlazarus.gl=compat

The LWJGL 2 profile always uses the legacy renderer.

Shader packs

OptiFine shader packs work on the core renderer. Turn off Fast Render and Antialiasing in OptiFine’s video settings, as OptiFine requires for shaders.

Supported packs:

Other packs usually work too; if one doesn’t, open an issue with the pack’s name and version and the output of a run with -Dlazarus.gl.debug=true.

Pack Apple M2, core Apple M2, legacy OpenGL 2.1
BSL 10.1.8 all programs, with shadows shadow program does not compile
Sildur’s Vibrant 2.02 Medium all programs one composite pass does not compile
Complementary Reimagined r5.10 all programs does not load

BSL is also verified on Windows. Frame rates are in benchmarks.

How it works

Options

Property Effect
lazarus.gl=compat Uses the legacy renderer on the LWJGL 3 profile instead of the core renderer
lazarus.gl.debug=true Requests a debug context and prints every driver-reported GL error with the Java call site, names fixed-function calls the emulator does not implement, and writes shaders that fail to compile to lazarus-shaders/
lazarus.gl.stream=subdata\|map How per-draw vertex data is uploaded. The default is map on Apple drivers and subdata elsewhere

For render libraries

Libraries that draw with their own shaders alongside the game should:

Limitations