Repository navigation
Releases
Lumen Java 1.0.0-beta.4 - OBS Stream mode (Minecraft 26.2)
Lumen Java 1.0.0-beta.4-mc26.2 for Minecraft 26.2 adds optional Stream mode for OBS Game Capture on Windows.
Enable Stream mode
- Use Windows 10 version 2004+ or Windows 11 and run Minecraft in windowed or borderless mode. Exclusive fullscreen is unsupported.
- Press Insert → Streaming → Stream mode ON. Enable Xray and select your filters, then close the menu.
- In OBS, use Game Capture selecting the Minecraft game window. Check your complete scene in the preview or a local test recording before going live.
Xray markers are displayed in a separate transparent, click-through Windows overlay. They stay out of Minecraft's recorded game frame. If the overlay cannot verify Windows capture exclusion, markers remain hidden instead of falling back into the game frame.
The Lumen menu, Zoom and Fullbright remain visible in the recording. Other capture methods and capture cards require separate testing. Stream mode defaults OFF and saves your choice.
Install
Close Minecraft and replace the old Lumen JAR in your instance's mods folder with lumen-java-1.0.0-beta.4-mc26.2.jar. Keep only one Lumen JAR in that instance. Requires Fabric Loader 0.19.5+, Fabric API 0.161.0+26.2, and Java 25. No extra EXE/DLL or additional mod is needed for Stream mode.
Validation
- All 12 unit tests passed.
- Full tests passed in an actual Minecraft 26.2 client, without shaders and with Iris/Sodium plus Complementary Reimagined r5.9.3.
- Real OBS Studio 32.2.2 Game Capture screenshots show all four test marker colors normally, exactly zero with Stream mode enabled, and all four after disabling it. The native overlay surface still contains all four colors with Windows capture affinity 0x11.
- Existing filters, menus/mouse/slider, zoom and brightness restoration, singleplayer combat damage, persistence and world lifecycle checks passed.
This is a beta. The capture tests used Windows/OpenGL and OBS Game Capture; a live Twitch broadcast was not started. See the included TESTING.md for details and limits.
The source ZIP and SHA-256 checksums are provided alongside the installable JAR. Choose the JAR matching your Minecraft version.
Lumen Java 1.0.0-beta.4 - OBS Stream mode (Minecraft 26.3)
Lumen Java 1.0.0-beta.4 for Minecraft 26.3 adds optional Stream mode for OBS Game Capture on Windows.
Enable Stream mode
- Use Windows 10 version 2004+ or Windows 11 and run Minecraft in windowed or borderless mode. Exclusive fullscreen is unsupported.
- Press Insert → Streaming → Stream mode ON. Enable Xray and select your filters, then close the menu.
- In OBS, use Game Capture selecting the Minecraft game window. Check your complete scene in the preview or a local test recording before going live.
Xray markers are displayed in a separate transparent, click-through Windows overlay. They stay out of Minecraft's recorded game frame. If the overlay cannot verify Windows capture exclusion, markers remain hidden instead of falling back into the game frame.
The Lumen menu, Zoom and Fullbright remain visible in the recording. Other capture methods and capture cards require separate testing. Stream mode defaults OFF and saves your choice.
Install
Close Minecraft and replace the old Lumen JAR in your instance's mods folder with lumen-java-1.0.0-beta.4.jar. Keep only one Lumen JAR in that instance. Requires Fabric Loader 0.19.5+, Fabric API 0.161.0+26.3, and Java 25. No extra EXE/DLL or additional mod is needed for Stream mode.
Validation
- All 12 unit tests passed.
- Full tests passed in an actual Minecraft 26.3 client, without shaders and with Iris/Sodium plus Complementary Reimagined r5.9.3.
- Real OBS Studio 32.2.2 Game Capture screenshots show all four test marker colors normally, exactly zero with Stream mode enabled, and all four after disabling it. The native overlay surface still contains all four colors with Windows capture affinity 0x11.
- Existing filters, menus/mouse/slider, zoom and brightness restoration, singleplayer combat damage, persistence and world lifecycle checks passed.
This is a beta. The capture tests used Windows/OpenGL and OBS Game Capture; a live Twitch broadcast was not started. See the included TESTING.md for details and limits.
The source ZIP and SHA-256 checksums are provided alongside the installable JAR. Choose the JAR matching your Minecraft version.
Lumen Java 1.0.0-beta.3 for Minecraft 26.2
Lumen Java 1.0.0-beta.3-mc26.2 is the separate Fabric build for Minecraft 26.2.
It includes the current Lumen features: ore and chest Xray filters, shader-compatible through-wall outlines, hold-to-zoom, Fullbright, the Insert menu, and toggleable No Attack Cooldown for private singleplayer worlds.
Install in Prism Launcher
- Close the Minecraft instance.
- Use a Minecraft 26.2 instance with Fabric Loader 0.19.5+, Java 25, and Fabric API 0.161.0+26.2.
- Replace the old Lumen JAR in that instance's
minecraft/modsfolder withlumen-java-1.0.0-beta.3-mc26.2.jar. Keep only one Lumen JAR in the instance. - Start the game and press Insert.
Controls: X toggles Xray, hold C to zoom, B toggles Fullbright. No Attack Cooldown is available under Insert → Features, defaults OFF, and affects full melee recharge strength only in your private singleplayer world. Target damage immunity still applies.
Validation
- All 11 unit tests passed.
- Full automated tests in an actual Minecraft 26.2 client passed, covering marker rendering, filtering, menus/mouse controls, zoom and brightness restoration, settings persistence, and leaving/reopening the test world.
- Actual integrated-server attack damage was verified: full-strength attacks with the combat toggle ON and normal recharge restored with it OFF.
- The full game test also passed with Iris 1.11.4, Sodium 0.9.2, and Complementary Reimagined r5.9.3, including shaders OFF/ON during play.
This remains a beta. Tests used Windows/OpenGL; Vulkan, other shader packs and complete modpacks require separate testing. A shader pack's own lighting can override the Fullbright effect. Personal Minecraft profiles and worlds were not changed during testing.
The Minecraft 26.3 beta 3 remains a separate download. The 26.2 source is maintained on support/mc-26.2. See TESTING.md for details.
Assets include the installable JAR, complete buildable source ZIP, and SHA-256 checksums. The source ZIP is for developers; do not install it as a mod.
Lumen Java 1.0.0-beta.3 - No Attack Cooldown
Adds No Attack Cooldown to Insert → Features, with an ON/OFF toggle and saved settings. It defaults to OFF, including when upgrading an existing configuration.
In private singleplayer worlds, enabling it gives your melee attacks full recharge strength immediately. The integrated server uses that strength for actual damage; this does not merely hide the attack indicator. Turning it off immediately restores normal charge calculations. Only your own player is affected.
Singleplayer only: inactive on remote servers and multiplayer/LAN worlds. Target damage immunity, missed-swing delays, item-use cooldowns and attack animations retain their normal behavior. Weapon damage/attack-speed attributes and persisted world data are not overwritten.
Validated in isolated Minecraft 26.3 game tests, both with and without Iris/Complementary Reimagined. An unenchanted iron axe dealt 9.0 damage fully charged, about 1.8 on an uncharged vanilla attack, 9.0 on consecutive attacks against fresh targets with the option enabled, and about 1.8 again after disabling. UI, persistence, world re-entry, other-player scope and existing Xray/Zoom/Fullbright regression checks passed. All eleven unit tests passed. Detailed verification.
Update: close Minecraft and replace the old Lumen JAR in your Prism instance's minecraft/mods folder with lumen-java-1.0.0-beta.3.jar. Keep Fabric API installed. Existing settings are retained.
Requires Minecraft 26.3, Java 25, Fabric Loader 0.19.5+ and Fabric API 0.161.0+26.3. Install on the client only. No in-game automatic updater. The source ZIP is for development; install only the mod JAR.
Lumen Java 1.0.0-beta.2 - Iris shader fix
Fixes Xray ore and chest outlines disappearing behind terrain when an Iris shader pack is enabled on Minecraft Java 26.3.
Through-wall outlines now render after shader composition, using the current world camera projection. Zoom, filters and the Insert menu remain available. Turning through-wall rendering off still hides occluded outlines.
Tested in separate development instances with and without Iris. The shader run used Iris 1.11.6, Sodium 0.9.3-alpha.1 and Complementary Reimagined r5.9.3, including switching shaders off/on during play. Ten unit tests and the client game tests passed; captured image pixels verify that all four test ore/chest outlines are visible through the wall. Shader lighting may ignore Fullbright. Other shader packs and complete modpacks need separate testing.
Update in Prism Launcher: close Minecraft, open the instance folder, remove the previous Lumen Java JAR from minecraft/mods, and put lumen-java-1.0.0-beta.2.jar there. Keep Fabric API installed. Existing Lumen settings are retained.
Requires Minecraft 26.3, Java 25, Fabric Loader 0.19.5+, and Fabric API 0.161.0+26.3. Iris is optional. Client only; no EXE, DLL or in-game updater.
Download the mod JAR for installation. The source ZIP is for development; checksums are provided in SHA256SUMS.txt. Full test coverage and limitations.
Lumen Java 1.0.0-beta.1 - Minecraft 26.3
First public Fabric beta of Lumen for Minecraft Java 26.3.
Features
- Ore Xray with ten ore categories and independent filters for normal, trapped and ender chests.
- Optional through-wall markers, a 4-24 block radius and 32-512 nearest markers.
- Hold-to-zoom (2x-20x), Fullbright and an English in-game menu in Auron colors.
- Saved settings and rebindable keys. Defaults: Insert menu, X Xray, hold C Zoom, B Fullbright.
Install
- Install Fabric Loader 0.19.5 or newer for Minecraft Java 26.3.
- Put lumen-java-1.0.0-beta.1.jar and Fabric API 0.161.0+26.3 in that profile's
modsfolder. - Start the Fabric profile, enter a world and press Insert. Enable Xray and select the filters you want.
Fabric Loader · Matching Fabric API download
The official Minecraft launcher supplies the required Java 25 game runtime. The mod is client-only. Updates are manual: replace the JAR while Minecraft is closed.
Validation and beta status
Seven unit tests passed. An isolated local game test exercised ore/chest scanning, removed markers, through-wall visibility, zoom and brightness restoration, menu/cursor handling, a mouse-operated slider, saved filters and world re-entry. Actual game screenshots were inspected. The initial standalone repository preserves those tested gameplay classes byte-for-byte.
This is a prerelease: acceptance in a normal installed Fabric profile remains pending. Shader packs, Sodium/Iris, Vulkan, other operating systems and multiplayer compatibility have not been tested. See TESTING.md.
The download includes the mod JAR, complete buildable source ZIP and SHA-256 checksums. Source and build scripts are licensed under GPL-3.0-only with dependency notices preserved. Only install the mod JAR and its Fabric API dependency, not the source archive.