A client-only Fabric edition of Lumen by Auron Network. English interface, dark translucent panels and yellow accents. Current Java test build: 1.0.0-beta.4; Java and Bedrock use separate binaries and version numbers.
Download the Java beta · Report an issue · Test coverage and limits · Bedrock edition
- Install Fabric Loader 0.19.5 or newer for Minecraft Java 26.3 and select that profile in your launcher.
- Place
lumen-java-1.0.0-beta.4.jarand Fabric API for 26.3 in that profile'smodsfolder. This build uses Fabric API 0.161.0+26.3. For the standard launcher the default folder is%APPDATA%\.minecraft\mods. - Start the Fabric profile, enter a world and press Insert.
Minecraft 26.3 requires Java 25; the official launcher supplies its game runtime. Install this mod on the client only. No Lumen EXE, DLL, Latite or server mod is required. Remove older Lumen Java JARs from the same profile before updating. Stream mode needs no additional mod: it uses JNA and JNA-platform 5.17.0 already provided by Minecraft, without bundling those libraries in the Lumen JAR.
In Prism Launcher, right-click the instance, choose Folder, and use its
minecraft/mods folder. Close that instance before replacing the Lumen JAR.
In normal mode, the rendering introduced in beta 2 fixes through-wall markers disappearing with Iris shader packs. Ore and chest outlines are drawn after shader composition, with the current world camera projection, and remain below menus and the HUD. No extra compatibility mod or shader setting is required. Turning Through walls off retains normal depth occlusion. F1 hides the through-wall marker overlay together with the HUD.
Beta 4 passed the full client and OBS Game Capture tests with Iris 1.11.6, Sodium 0.9.2, and Complementary Reimagined r5.9.3 on Minecraft 26.3, including shaders off/on and Stream mode off/on. See TESTING.md for the verified scope. Other shader packs and rendering mods need separate testing. Shader packs can provide their own lighting, so Fullbright's lightmap setting may not brighten their rendered scene.
| Default key | Action |
|---|---|
| Insert | Open or close Lumen |
| Escape in Lumen | Close the menu |
| X | Toggle Xray markers |
| Hold C | Zoom; release to restore normal view |
| B | Toggle Fullbright |
Keys are rebindable in Minecraft's Controls / Key Binds / Lumen category. The menu releases the cursor, consumes its own clicks and does not pause the world. The Features, Ore Filters, Chest Filters and Streaming tabs provide:
- Xray with a 4-24 block radius and 32-512 nearest markers.
- Ten ore categories, including deepslate variants, nether gold, quartz and ancient debris.
- Normal chests, trapped chests and ender chests as independent filters.
- Optional visibility through walls. Double chests have two marked block positions.
- 2x-20x hold-to-zoom and local Fullbright.
- No Attack Cooldown: optional full melee attack strength in singleplayer.
- Optional Windows Stream mode for Xray markers with OBS Game Capture.
Fresh settings start with Xray, Fullbright, No Attack Cooldown and Stream mode off,
Zoom enabled, a 16-block radius, 192 markers, 4x zoom, selected valuable ores and
all chest filters off.
Settings are saved in the profile's config/lumen.properties.
Bedrock's INI settings are not automatically imported.
Only already loaded client block data is inspected. The mod does not load extra chunks, send commands, request operator permissions or reveal container contents. Server-hidden or substituted block data cannot be recovered by this mod. Zoom and Fullbright modify the rendered view, without overwriting Minecraft's FOV/brightness options or adding potion effects. Modpack compatibility and additional rendering backends require separate testing.
- Use Windows 10 version 2004 or newer, or Windows 11, with Minecraft in windowed or borderless fullscreen mode. Exclusive fullscreen hides the overlay.
- Open Insert → Streaming → Stream mode and set it to ON. Enable Xray and select the desired ore/chest filters as usual, then close the menu.
- In OBS, add a Game Capture source and select only the Minecraft game window. Check an OBS preview or test recording before streaming.
Stream mode defaults to OFF and is saved in config/lumen.properties,
including across Minecraft restarts. When enabled, Xray marker pixels are drawn
in a separate transparent, click-through Windows overlay. They are never drawn
into Minecraft's captured frame. Only the Xray markers move to this overlay:
the Lumen menu, Zoom and Fullbright remain visible in Game Capture.
The overlay uses Windows SetWindowDisplayAffinity with
WDA_EXCLUDEFROMCAPTURE (0x11) and verifies that setting before showing markers.
If the overlay or capture exclusion fails, markers stay hidden; Lumen does not
fall back to drawing them in the Minecraft frame. Capture exclusion applies to
specific public Windows capture APIs. It is not a guarantee for every recording
method, screen-sharing tool or capture card. The setup described here is OBS
Game Capture selecting the Minecraft window. See TESTING.md for
which runtime and capture checks have actually been completed for this beta.
External markers hide while any menu is open, with F1, when Minecraft is minimized or loses focus (including Alt+Tab), and on disconnect. With Through walls OFF, the external overlay checks block line of sight from the camera; it cannot use Minecraft's world depth buffer, so its occlusion can differ from normal marker rendering.
Stream mode is unavailable on non-Windows systems. Leave it OFF there to use the existing normal marker rendering.
Open Insert → Features → No Attack Cooldown to turn the feature on or off. While enabled in a private singleplayer world, your melee attacks use full recharge strength immediately, including on the integrated server that calculates damage. Item minimum-attack-charge checks also respect the setting. This is a gameplay change, not just a hidden cooldown indicator.
The setting is saved and defaults to OFF, including when upgrading an older configuration. It affects your own player only and is automatically inactive on remote servers and worlds opened to multiplayer/LAN. It cannot remove the attack cooldown enforced by another server.
Turning it off immediately restores vanilla charge calculations. Weapon damage and attack-speed attributes, player timers and world save data are not overwritten. Target damage immunity, the missed-swing click delay, item-use cooldowns and attack animations retain their normal behavior. Rapidly hitting the same target can still be limited by that target's normal damage immunity.
Use a JDK 25 installation and the included Gradle wrapper:
.\gradlew.bat build
.\gradlew.bat runClientGameTestbuild compiles the mod, runs the scanner/settings unit tests and produces the
mod JAR plus source JAR in build/libs. The second command launches a separate
development client and creates a disposable local test world under build/run.
It is not part of the distributed mod. Do not point its run directory at a
personal Minecraft instance. The tests cover scanning, UI controls, saved filters,
zoom restoration, Fullbright, actual singleplayer melee damage and cooldown
restoration, and capture screenshots for visual inspection.
To run the optional Iris compatibility test, supply local Iris/Sodium JARs and a shader ZIP (these are test fixtures, not bundled or downloaded by Lumen):
.\gradlew.bat runClientGameTest "-PshaderTestMods=C:\Fixtures\mods" "-PshaderTestPack=C:\Fixtures\ComplementaryReimagined_r5.9.3.zip"The test copies the shader into its disposable instance. It checks actual marker pixels with the shader active, disabled and re-enabled, and verifies that hidden markers and markers behind the camera disappear.
The build pins Minecraft 26.3, Fabric Loader 0.19.5, Fabric API 0.161.0+26.3, Fabric Loom 1.17.21 and Gradle 9.6.0. The Gradle distribution is SHA-256 checked.
Download Java updates from this repository's Releases page and replace the JAR while Minecraft is closed. There is no in-game automatic updater.
GitHub Actions builds and runs the unit tests on pushes and pull requests. The workflow retains the JAR, complete source ZIP and checksums as build artifacts; public versions are published separately on the Releases page.
License: GPL-3.0-only. See LICENSE and NOTICE.md.