LumaClear

LumaClear

LumaClear is a client-side Fabric mod for fullbright lighting, customizable fog clearing, and a clearer view of Minecraft. Version 1.0.1 targets Minecraft 26.3 and Java 25. It works with vanilla textures and biome tinting, preserves ambient occlusion, and does not require Iris or a shaderpack.

Installation

1. Install Fabric Loader 0.19.3 or newer for Minecraft 26.3.
2. Install Fabric API 0.166.0 or newer for Minecraft 26.3.
3. Copy the LumaClear .jar into your instance's mods folder.
4. Sodium is optional and recommended. Mod Menu is optional for opening settings through the mod list.

Install LumaClear on the client only. Version 1.0.1 is for Minecraft 26.3; use the older release for Minecraft 26.2.

Settings

Press F7 or use Mod Menu to open settings. Changes apply immediately and are saved to config/lumaclear.json. Presets support mouse and keyboard controls: Enter or Space cycles forward, and Shift cycles backward.

Fog controls cover distance, darkness, underwater, lava, powder snow, Nether and weather fog. Directional shading can be disabled separately while keeping ambient occlusion—the corner shading that helps distinguish shapes.

What's new in 1.0.1

• Minecraft 26.3 support with updated Fabric compatibility.
• Skip terrain block/sky-light sampling that fullbright does not use, while preserving ambient occlusion and geometry shading.
• Avoid terrain rebuilds caused only by lighting changes that cannot affect the fullbright image. Ordinary block/geometry updates and fullbright-toggle rebuilds remain active, and world/server lighting stays intact.
• Fix Sodium's fullbright shader integration and reuse shader pipeline variants across settings changes.
• Correct directional-shading integration for vanilla blocks and fluids, Fabric Indigo and Sodium.
• Keep fog switches independent and avoid geometry rebuilds for fog-only settings changes.
• Fix keyboard preset selection and focus handling.

The new sampling and light-only rebuild shortcuts conservatively use normal behavior when Iris is installed because shaderpacks may consume light data independently of brightness.

Performance

LumaClear uses existing rendering paths without adding a shaderpack or extra fullscreen effects. The lighting shortcuts target unnecessary lighting work and terrain rebuilds; they do not guarantee a large steady-FPS increase or a win over Sodium in every scene.

The updated 1.0.1 build completed a six-configuration MineBench Suite 1 standard run on a Qualcomm Oryon / Adreno X1-85 laptop: Minecraft 26.3, Sodium 0.9.2, Java 25 ARM64, actual framebuffer 1840×1150, view distance 12, simulation distance 8, AO enabled, VSync off and unlimited FPS. Each configuration ran five iterations of each of five scenes.

Values are arithmetic means of scene-level median FPS, not universal FPS expectations. All 150 iterations passed with zero MineBench warnings, and all 2,881,650 raw frame intervals were independently verified. Sodium stability controls spanned 3.58%, so small gains or regressions are not established by this sequential campaign.

Clearing Nether and distance fog exposes more terrain and changes the visible workload. LumaClear Clarity measured 272.7 FPS in the Nether route versus Sodium's 615.7; the separate all-scenes and excluding-Nether results retain that tradeoff. Older desktop measurements use different hardware, settings and an earlier artifact and do not measure a code-only improvement for this build.

Compatibility and validation

Sodium is optional. Build, 27 unit tests, four real mixin smoke configurations (without Sodium, Sodium 0.9.2, 0.9.3-beta.1 and 0.9.3-beta.4), and eight offline shader combinations passed. These checks do not establish compatibility with every mod, shaderpack or graphics driver.

Support

Report bugs and feature requests on the LumaClear issue tracker. Source code is available on GitHub.