lazarus

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

LWJGL 3

Minecraft 1.8.9 is written against LWJGL 2.9.4. Lazarus can run it on LWJGL 3 instead, for native Apple silicon support, GLFW windowing and input, and correct high-DPI scaling. It is optional: the default install keeps LWJGL 2.

On LWJGL 3 the game renders through the core renderer, an OpenGL 4.1 core profile, by default.

Why not just swap the jars

LWJGL 2 and LWJGL 3 share the org.lwjgl package and the JNI symbol names of their native libraries, so they cannot run side by side, and LWJGL 3 cannot be relocated. LWJGL 3 also dropped or reshaped much of the API the game uses. The switch has to cover the whole game: Minecraft, Forge, OptiFine and every mod see the same org.lwjgl.

What Lazarus provides

The LWJGL 2 API surface used by Minecraft 1.8.9, Forge 11.15.1.2318, OptiFine HD U M5 and paulscode’s OpenAL library was measured class by class against LWJGL 3.4.3:

  References
Unchanged in LWJGL 3 183
Renamed or reshaped methods (for example glGetFloat → glGetFloatv) 41
In 19 classes LWJGL 3 does not have about 234

Behaviour kept from LWJGL 2

Launch requirements

The bootstrap handles these when it finds the compatibility jar on the class path:

LWJGL 3 extracts its own natives from its natives jars; LWJGL 2’s natives on java.library.path do not interfere.

Tested

  Java 17 Java 21 Java 25
Windows: menu, Mixin 0.7 mod ✔ ✔ ✔
Windows: OptiFine, world, splash screen     ✔
Windows: installed launcher profile, stock class path, no agent   ✔ ✔
Linux CI (Xvfb, software OpenGL): menu, Mixin 0.7 mod, world ✔ ✔ ✔
macOS 26.5, Apple M2: menu, Mixin 0.7 mod ✔ ✔ ✔
macOS: world, Retina screenshot, stock class path with no agent     ✔

Played by hand on Windows (typing, menus, inventory, mouse look) and on macOS with a trackpad (typing, copy and paste, menus, mouse look, Cmd-Tab). macOS is tested by hand because GitHub’s hosted macOS runners have no usable OpenGL. LWJGL 2 does not start on Apple silicon (liblwjgl.dylib has no arm64 build), which is what the LWJGL 3 install is for.