LumaClear
LumaClear 是一款面向客户端的 Fabric 模组,提供全亮度光照、可自定义的迷雾清除功能,让《Minecraft》视野更加清晰。1.0.1 版本适用于 Minecraft 26.3 和 Java 25。 它兼容原版纹理与生物群系着色,保留环境光遮蔽(AO),且无需 Iris 或光影包。
安装
- 为 Minecraft 26.3 安装 Fabric Loader 0.19.3 或更高版本。
- 安装 Fabric API 0.166.0 或更高版本(适用于 Minecraft 26.3)。
- 将 LumaClear
.jar 文件复制到实例的 mods 文件夹中。
- Sodium 为可选但推荐安装。Mod Menu 为可选安装,用于通过模组列表打开设置界面。
仅在客户端安装 LumaClear。1.0.1 版本适用于 Minecraft 26.3;如需用于 Minecraft 26.2,请使用旧版发布内容。
设置
按 F7 或使用 Mod Menu 打开设置。更改会立即生效并保存至 config/lumaclear.json。预设支持鼠标和键盘操作:Enter 或 Space 键向前切换,Shift 键向后切换。
| 预设 |
行为 |
| Fullbright |
地形全亮光照,保留正常迷雾、环境光遮蔽及方向性阴影。 |
| Clarity (推荐) |
全亮光照并启用所有迷雾清除选项,保留环境光遮蔽及方向性阴影。 |
| Custom |
自行控制光照、方向性阴影及各类迷雾类型。 |
迷雾控制涵盖距离迷雾、黑暗迷雾、水下迷雾、熔岩迷雾、细雪迷雾、下界迷雾及天气迷雾。方向性阴影可单独禁用,同时保留环境光遮蔽——即帮助区分形状的边缘阴影效果。
1.0.1 新增内容
- 支持 Minecraft 26.3,更新 Fabric 兼容性。
- 跳过全亮光照未使用的地形方块/天空光采样,同时保留环境光遮蔽与几何体阴影。
- 避免因仅影响光照且无法改变全亮图像的地形重建。普通方块/几何体更新及全亮切换重建仍保持活跃,世界/服务器光照保持不变。
- 修复 Sodium 的全亮光影集成问题,并在设置更改时复用光影管线变体。
- 修正原版方块、流体、Fabric Indigo 及 Sodium 的方向性阴影集成。
- 保持迷雾开关独立,并避免仅因迷雾设置更改而触发的几何体重建。
- 修复键盘预设选择与焦点处理。
新的采样与仅光照重建快捷方式在检测到已安装 Iris 时会保守地使用默认行为,因为光影包可能会独立于亮度数据消耗光照数据。
性能
LumaClear 使用现有的渲染路径,不添加光影包或额外的全屏特效。光照优化旨在减少不必要的光照计算和地形重建;它不能保证在所有场景中获得大幅稳定的 FPS 提升或全面超越 Sodium。
更新的 1.0.1 构建在 Qualcomm Oryon / Adreno X1-85 笔记本上完成了六组配置的 MineBench Suite 1 标准测试:Minecraft 26.3、Sodium 0.9.2、Java 25 ARM64、实际帧缓冲分辨率 1840×1150、视距 12、模拟距离 8、开启 AO、关闭垂直同步及无限帧率。每种配置对五个场景各运行五次迭代。
| 配置 |
五个场景平均 FPS |
排除下界后的平均 FPS |
| 仅 Sodium |
410.8 |
359.6 |
| LumaClear Fullbright |
401.2 |
351.7 |
| LumaClear Clarity |
345.1 |
363.2 |
| Sodium + Gamma Utils 1500% |
398.1 |
350.7 |
| Sodium + Fullbright UB 7.0 |
426.1 |
378.2 |
| Iris + Clarity 光影包 |
216.6 |
226.2 |
数值为各场景中位 FPS 的算术平均值,而非通用 FPS 预期。全部 150 次迭代均无 MineBench 警告,所有 2,881,650 个原始帧间隔均已独立验证。Sodium 稳定性波动范围为 3.58%,因此小幅增益或倒退在此顺序测试中尚不足以确立结论。
清除下界与距离迷雾会暴露更多地形并改变可见工作量。LumaClear Clarity 在下界路线中测得 272.7 FPS,而 Sodium 为 615.7;“所有场景”与“排除下界”的结果均保留了这一权衡关系。较早的桌面端测量使用不同的硬件、设置及早期构建版本,并未衡量本构建的代码级改进。
兼容性与验证
Sodium 为可选安装。构建通过了 27 项单元测试、四种真实 mixin 冒烟测试配置(不含 Sodium、Sodium 0.9.2、0.9.3-beta.1 及 0.9.3-beta.4)以及八种离线光影组合验证。这些检查并不能证明其与所有模组、光影包或图形驱动程序的兼容性。
支持
请在 LumaClear 问题追踪器 报告漏洞和功能请求。源代码可在 GitHub 获取。
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
- Install Fabric Loader 0.19.3 or newer for Minecraft 26.3.
- Install Fabric API 0.166.0 or newer for Minecraft 26.3.
- Copy the LumaClear
.jar into your instance's mods folder.
- 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.
| Preset |
Behavior |
| Fullbright |
Fullbright terrain lighting with normal fog, ambient occlusion and directional shading retained. |
| Clarity (recommended) |
Fullbright with all fog-clearing options enabled, ambient occlusion and directional shading retained. |
| Custom |
Control lighting, directional shading and individual fog types yourself. |
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.
| Configuration |
Average FPS, all five scenes |
Average FPS, excluding Nether |
| Sodium only |
410.8 |
359.6 |
| LumaClear Fullbright |
401.2 |
351.7 |
| LumaClear Clarity |
345.1 |
363.2 |
| Sodium + Gamma Utils 1500% |
398.1 |
350.7 |
| Sodium + Fullbright UB 7.0 |
426.1 |
378.2 |
| Iris + Clarity shaderpack |
216.6 |
226.2 |
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧