Changelog
All notable changes are recorded here. The format follows Keep a Changelog and the project uses Semantic Versioning.
Unreleased
Added
MinecraftOptiFine: whether OptiFine is installed, its version, and its Fast Render option, by reflection. Helios’s drawing works with Fast Render on; the harness checks it with-Poptifine=<jar> -PfastRender.
Changed
- The harness runs on the Lazarus 0.4.2 release with the splash screen on.
0.1.0 - 2026-11-19
First release. Requires Minecraft Forge 1.8.9 on LWJGL 3 through lol.trq.lazarus 0.2.0 or newer in core mode
(-Dlazarus.gl=core), Java 17 or newer.
Added
- OpenGL 4.1 core profile only:
GlBackendseam andGl41CoreBackend, which checks the context at start-up. Every shader is#version 410 core; the preprocessor rejects other versions. Seedocs/opengl.md. StreamBuffer: a fenced ring of three vertex buffers rotated byHelios.tick(), withglBufferSubDataby default and unsynchronized mapping behind-Dhelios.stream=map. Program, vertex array, array buffer, matrices and viewport are read from Lazarus’s state tracker when it has them.StateGuard: saves each GL state slot on first touch and restores newest first; cached state goes through aGlStateCache, implemented for the MinecraftGlStateManager. Covers blend, depth, cull, program, framebuffer, viewport, array buffer, vertex array, texture units, scissor, stencil and colour mask.- Shader loader:
#include(relative and root), injected defines,#linemapping so driver errors readfile:line, uniform location cache, reload that keeps the last good program; hot reload from a source directory. FramebufferPoolsized in framebuffer pixels, with resize handling.ShapeBatch: batched signed distance shapes (rounded rects, outlines, circles, arcs, lines, polylines, drop shadows, inner glow, textured images with tint) anti-aliased over exactly one pixel, drawn as indexed triangles from its own vertex array;Paintfor solid, four-corner, linear and radial gradients.- Effects: dual Kawase blur, blur behind a shape, bloom, post-processing chains of custom full-screen passes.
ScissorStackfor nested clipping;StencilMaskto clip drawing to any shape;MinecraftHelios.enableStencil().- MSDF text:
MsdfFont(.hfntatlases),TextRendererwith kerning,§colour and format codes (bold, italic, underline, strikethrough, obfuscated), classic and soft shadows, weight and letter spacing; glyphs share the shape batch. Inter Regular is bundled. fontgen: a Java port of msdfgen’s generator that builds.hfntatlases from TrueType and OpenType fonts at build time.MeshRenderer(Helios.meshes()): 3D drawing throughQuadSink(position and colour),LineSink(lines a given number of pixels wide, anti-aliased, clipped at the near plane) andTexturedSink(position, texture coordinates, normal and tint, with Minecraft 1.8.9’s two-light entity lighting). Sinks transform on the CPU so meshes with different transforms share a draw call;MeshRecorderandStaticMeshupload a mesh once withGL_STATIC_DRAW.PlayerModelandPlayerPose: the 1.8.9 player transform chain withAttachmentanchors at the head, body and back, following body and head yaw, pitch, sneaking, the riding limit and armour.Colors: packed ARGB maths, HSB/HSL, sRGB, linear-light and hue interpolation, rainbow and ping-pong, hex parsing and formatting, readable text colour.Easingcurves,Animationthat reverses mid-flight without jumping, frame-rate independentSmooth,Stopwatch; all driven by an injectableClock.Maths, column-majorMat4, andProjectorfor world-to-screen projection and 2D bounding boxes.- Minecraft wiring by reflection, no Mixin:
MinecraftHelios,MinecraftGlStateCache,MinecraftWorld(partial ticks, camera, interpolated entity positions and boxes) andMinecraftPlayerPose(a live player’s pose). - JMH benchmarks and harness GPU timings; see
BENCHMARKS.md. - Development harness that boots Forge 1.8.9 on LWJGL 3 through the Lazarus release in core mode and checks rendering
in game: every primitive against a software model, blur, bloom, text and stencil against reference images, state
restoration, and any
[lazarus] GL errorfails the run.-Pworldchecks projection, player anchors and mesh drawing in a singleplayer world. Runs in CI under Xvfb with Mesa.