A lightweight Windows client for Minecraft Bedrock 26.51 with ore/chest Xray, Zoom, Fullbright and an Auron-styled in-game menu. Lumen runs independently of Latite.
Current releases target Windows package 1.26.5101.0 (executable 1.26.51.1). See the 26.51 audit and acceptance status.
Download the installer ZIP · Releases and source
- Download and extract Lumen-Installer.zip.
- Run Lumen-Setup.exe. Installation is per user; no administrator rights
are required. The default location is
%LOCALAPPDATA%\Programs\Lumen. - Save and restart Minecraft if Lumen, Xray Light or Latite is already loaded.
- Open Lumen from the Start menu and select Launch Lumen.
- Enter a world and press Insert.
The installer includes Lumen.exe, Lumen.dll, the required Geist fonts, licenses and a source-download link. It provides an uninstaller; uninstalling preserves your Lumen settings. The installer is not Authenticode-signed, so Windows may show an unknown-publisher or SmartScreen warning. SHA-256 hashes are included with each release.
| Key | Action |
|---|---|
| Insert | Open or close the in-game Lumen menu |
| Escape while the menu is open | Return to gameplay |
| X | Toggle Xray |
| Hold C | Zoom; release to restore the normal view |
| B | Toggle Fullbright |
The menu supports ore and chest filters, a 4–24 block radius, 32–512 markers and 2×–20× zoom. Settings save automatically. The menu does not pause the world.
The 1.6 series adds Chest Filters below the ore filters: Chests, Trapped Chests and Ender Chests. Enable Xray with X and select the types you want to mark; Show through walls controls visibility through blocks. Chest markers use amber, coral and lavender outlines respectively, sharing the radius and nearest-first marker limit with ores. A double chest occupies two marked block positions. Only chest locations are displayed, not their contents. Existing ore selections are preserved; chest filters start off and save when changed. See chest Xray validation for current test status.
All three features work on the client; no OP permission or chat command is needed. Xray can only inspect block data the server actually sends. It cannot recover ores hidden or substituted by a server. Follow the rules of servers you join.
Installed copies check this repository's latest published release whenever the launcher opens. A newer installer is downloaded over HTTPS and verified against the size and SHA-256 digest in GitHub's release metadata before it runs.
Updates wait until Minecraft is closed. Lumen never closes Minecraft for you. The installer waits for the launcher to exit, checks for locked files, updates the same installation and reopens the launcher. Settings are preserved. If GitHub is unavailable, you can still launch the installed version.
Updates run when the starter opens; there is no always-running update service.
Portable development copies without lumen-install.ini do not auto-install.
To opt out, create %LOCALAPPDATA%\Lumen\updates.ini containing:
[Updates]
Enabled=0Every push to main builds and tests on Windows. A successful current build
publishes a release numbered 1.6.<workflow run number>. Pull requests build
and test without publishing. Incomplete uploads remain drafts and are not
eligible for automatic updates. Older queued commits cannot replace a newer
main build as the latest release.
See BUILD.md for local builds and packaging, and TESTING.md for validation and runtime acceptance limits.
- Settings:
%LOCALAPPDATA%\Lumen\settings.ini - Game log:
%LOCALAPPDATA%\Lumen\lumen.log - Updater log:
%LOCALAPPDATA%\Lumen\Updates\updater.log - Automatic installer log:
%LOCALAPPDATA%\Lumen\Updates\setup.log - Closing the launcher after loading leaves Lumen running inside Minecraft.
Lumen is distributed under GPL-3.0-only. Each release includes the complete corresponding source in Lumen-Source.zip, including build scripts and bundled dependencies. Windows and Visual Studio provide the platform toolchain.
Lumen adapts Minecraft integration, rendering and input techniques from Latite Client. See LATITE-ATTRIBUTION.md, NOTICE.md and LICENSE. MinHook, Geist and nlohmann/json retain their own licenses.